git-trace 1.0.0__py3-none-any.whl

git_trace/output/assets/analysis_controls.html

@@ -0,0 +1,116 @@
+<style>
+  #gt-controls {
+    position: fixed;
+    top: 16px;
+    left: 50%;
+    transform: translateX(-50%);
+    z-index: 9999;
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    background: rgba(30,30,46,0.92);
+    border: 1px solid #555;
+    border-radius: 8px;
+    padding: 8px 14px;
+    box-shadow: 0 2px 12px rgba(0,0,0,0.5);
+    font-family: monospace;
+    font-size: 13px;
+    color: #eee;
+  }
+  #gt-search {
+    background: #2a2a3e;
+    border: 1px solid #666;
+    border-radius: 4px;
+    color: #eee;
+    padding: 4px 8px;
+    width: 220px;
+    font-size: 13px;
+    outline: none;
+  }
+  #gt-search:focus { border-color: #87ceeb; }
+  #gt-search::placeholder { color: #888; }
+  #gt-match-count { color: #aaa; min-width: 60px; }
+  #gt-hide-isolated {
+    cursor: pointer;
+    background: #2a2a3e;
+    border: 1px solid #666;
+    border-radius: 4px;
+    color: #eee;
+    padding: 4px 10px;
+    font-size: 12px;
+    white-space: nowrap;
+  }
+  #gt-hide-isolated:hover { border-color: #87ceeb; }
+  #gt-hide-isolated.active { background: #4682b4; border-color: #87ceeb; }
+</style>
+
+<div id="gt-controls">
+  <input id="gt-search" type="text" placeholder="Search commits…" autocomplete="off" />
+  <span id="gt-match-count"></span>
+  <button id="gt-hide-isolated">Hide isolated</button>
+</div>
+
+<script>
+(function () {
+  function waitForNetwork(cb) {
+    var t = setInterval(function () {
+      if (typeof network !== "undefined") { clearInterval(t); cb(); }
+    }, 100);
+  }
+
+  waitForNetwork(function () {
+    var allNodes    = network.body.data.nodes;
+    var allEdges    = network.body.data.edges;
+    var searchInput = document.getElementById("gt-search");
+    var matchCount  = document.getElementById("gt-match-count");
+    var hideBtn     = document.getElementById("gt-hide-isolated");
+    var hideIsolated = false;
+
+    function connectedIds() {
+      var ids = new Set();
+      allEdges.getIds().forEach(function (eid) {
+        var e = allEdges.get(eid);
+        ids.add(e.from); ids.add(e.to);
+      });
+      return ids;
+    }
+
+    function applyFilters() {
+      var query     = searchInput.value.trim().toLowerCase();
+      var connected = hideIsolated ? connectedIds() : null;
+      var updates   = [];
+      var matchTotal = 0;
+
+      allNodes.getIds().forEach(function (nid) {
+        var node   = allNodes.get(nid);
+        var label  = (node.label  || "").toLowerCase();
+        var title  = (typeof node.title === "string" ? node.title : "").toLowerCase();
+        var hidden = false;
+
+        if (hideIsolated && connected && !connected.has(nid)) { hidden = true; }
+
+        if (!hidden && query) {
+          var matches = label.includes(query) || title.includes(query);
+          if (!matches) { hidden = true; } else { matchTotal++; }
+        } else if (!hidden) {
+          matchTotal++;
+        }
+
+        updates.push({ id: nid, hidden: hidden });
+      });
+
+      allNodes.update(updates);
+      matchCount.textContent = query ? matchTotal + " found" : "";
+    }
+
+    searchInput.addEventListener("input", applyFilters);
+
+    hideBtn.addEventListener("click", function () {
+      hideIsolated = !hideIsolated;
+      hideBtn.classList.toggle("active", hideIsolated);
+      hideBtn.textContent = hideIsolated ? "Show isolated" : "Hide isolated";
+      applyFilters();
+    });
+  });
+})();
+</script>

git_trace/output/assets/analysis_legend.html

@@ -0,0 +1,27 @@
+<style>
+  #gt-legend {
+    position: fixed;
+    top: 16px;
+    right: 16px;
+    z-index: 9999;
+    background: rgba(30,30,46,0.92);
+    border: 1px solid #555;
+    border-radius: 8px;
+    padding: 10px 14px;
+    font-family: monospace;
+    font-size: 12px;
+    color: #eee;
+    line-height: 1.8;
+  }
+  .gt-swatch {
+    display: inline-block;
+    width: 12px; height: 12px;
+    border-radius: 2px;
+    margin-right: 6px;
+    vertical-align: middle;
+  }
+</style>
+<div id="gt-legend">
+  <div><span class="gt-swatch" style="background:#4caf50"></span>Independent (no dependencies)</div>
+  <div><span class="gt-swatch" style="background:#546e7a"></span>Has dependencies on earlier commits</div>
+</div>

git_trace/output/assets/pick_controls.html

@@ -0,0 +1,137 @@
+<style>
+  #gt-controls {
+    position: fixed;
+    top: 12px;
+    left: 50%;
+    transform: translateX(-50%);
+    z-index: 9999;
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    background: rgba(30,30,46,0.92);
+    border: 1px solid #555;
+    border-radius: 8px;
+    padding: 8px 14px;
+    box-shadow: 0 2px 12px rgba(0,0,0,0.5);
+    font-family: monospace;
+    font-size: 13px;
+    color: #eee;
+  }
+  #gt-search {
+    background: #2a2a3e;
+    border: 1px solid #666;
+    border-radius: 4px;
+    color: #eee;
+    padding: 4px 8px;
+    width: 220px;
+    font-size: 13px;
+    outline: none;
+  }
+  #gt-search:focus { border-color: #87ceeb; }
+  #gt-search::placeholder { color: #888; }
+  #gt-match-count { color: #aaa; min-width: 60px; }
+  .gt-btn {
+    cursor: pointer;
+    background: #2a2a3e;
+    border: 1px solid #666;
+    border-radius: 4px;
+    color: #eee;
+    padding: 4px 10px;
+    font-size: 12px;
+    font-family: monospace;
+    white-space: nowrap;
+  }
+  .gt-btn:hover { border-color: #87ceeb; }
+  .gt-btn.active { background: #4682b4; border-color: #87ceeb; }
+</style>
+
+<div id="gt-controls">
+  <input id="gt-search" type="text" placeholder="Search commits…" autocomplete="off" />
+  <span id="gt-match-count"></span>
+  <button id="gt-hide-isolated" class="gt-btn">Hide isolated</button>
+  <button id="gt-hide-resolved" class="gt-btn">Hide safe &amp; context</button>
+</div>
+
+<script>
+(function () {
+  var CONTEXT_BG = "#546e7a";
+  var SAFE_BG    = "#4caf50";
+
+  function waitForNetwork(cb) {
+    var t = setInterval(function () {
+      if (typeof network !== "undefined") { clearInterval(t); cb(); }
+    }, 100);
+  }
+
+  waitForNetwork(function () {
+    var allNodes = network.body.data.nodes;
+    var allEdges = network.body.data.edges;
+
+    var searchInput = document.getElementById("gt-search");
+    var matchCount  = document.getElementById("gt-match-count");
+    var btnIsolated = document.getElementById("gt-hide-isolated");
+    var btnResolved = document.getElementById("gt-hide-resolved");
+
+    var hideIsolated = false;
+    var hideResolved = false;
+
+    function connectedIds() {
+      var ids = new Set();
+      allEdges.getIds().forEach(function (eid) {
+        var e = allEdges.get(eid);
+        ids.add(e.from); ids.add(e.to);
+      });
+      return ids;
+    }
+
+    function applyFilters() {
+      var query     = searchInput.value.trim().toLowerCase();
+      var connected = hideIsolated ? connectedIds() : null;
+      var updates   = [];
+      var matchTotal = 0;
+
+      allNodes.getIds().forEach(function (nid) {
+        var node   = allNodes.get(nid);
+        var bg     = node.color && node.color.background ? node.color.background : "";
+        var label  = (node.label  || "").toLowerCase();
+        var title  = (typeof node.title === "string" ? node.title : "").toLowerCase();
+        var hidden = false;
+
+        if (hideIsolated && connected && !connected.has(nid)) { hidden = true; }
+        if (!hidden && hideResolved && (bg === SAFE_BG || bg === CONTEXT_BG)) { hidden = true; }
+
+        if (!hidden && query) {
+          var matches = label.includes(query) || title.includes(query);
+          if (!matches) { hidden = true; } else { matchTotal++; }
+        } else if (!hidden) {
+          matchTotal++;
+        }
+
+        updates.push({ id: nid, hidden: hidden });
+      });
+
+      allNodes.update(updates);
+      matchCount.textContent = query ? matchTotal + " found" : "";
+    }
+
+    function toggleBtn(btn, active, onLabel, offLabel) {
+      btn.classList.toggle("active", active);
+      btn.textContent = active ? onLabel : offLabel;
+    }
+
+    searchInput.addEventListener("input", applyFilters);
+
+    btnIsolated.addEventListener("click", function () {
+      hideIsolated = !hideIsolated;
+      toggleBtn(btnIsolated, hideIsolated, "Show isolated", "Hide isolated");
+      applyFilters();
+    });
+
+    btnResolved.addEventListener("click", function () {
+      hideResolved = !hideResolved;
+      toggleBtn(btnResolved, hideResolved, "Show safe & context", "Hide safe & context");
+      applyFilters();
+    });
+  });
+})();
+</script>

git_trace/output/assets/pick_legend.html

@@ -0,0 +1,32 @@
+<style>
+  #gt-legend {
+    position: fixed;
+    top: 16px;
+    right: 16px;
+    z-index: 9999;
+    background: rgba(30,30,46,0.92);
+    border: 1px solid #555;
+    border-radius: 8px;
+    padding: 10px 14px;
+    font-family: monospace;
+    font-size: 12px;
+    color: #eee;
+    line-height: 1.8;
+  }
+  .gt-swatch {
+    display: inline-block;
+    width: 12px; height: 12px;
+    border-radius: 2px;
+    margin-right: 6px;
+    vertical-align: middle;
+  }
+</style>
+<div id="gt-legend">
+  <div><span class="gt-swatch" style="background:#4caf50"></span>Safe to pick</div>
+  <div><span class="gt-swatch" style="background:#1b7a4a"></span>Safe if parent deps fixed</div>
+  <div><span class="gt-swatch" style="background:#f44336"></span>Blocked (missing deps)</div>
+  <div><span class="gt-swatch" style="background:#ff9800"></span>Missing dependency</div>
+  <div><span class="gt-swatch" style="background:#546e7a"></span>Context (not picked)</div>
+  <div style="margin-top:6px; color:#ff4444">&#8212;&#8212; blocking edge</div>
+  <div style="color:#666">- - - regular dep edge</div>
+</div>

git_trace/output/assets/styling.html

@@ -0,0 +1,5 @@
+<style>
+    .vis-button {
+        filter: grayscale(100%) brightness(2.0);
+    }
+</style>

git_trace/output/graph.py

@@ -0,0 +1,198 @@
+from __future__ import annotations
+
+import os
+import webbrowser
+
+from pyvis.network import Network
+
+from git_trace.analysis import DependencyGraph, CherryPickAnalysis
+from git_trace.git import Commit
+from git_trace.output.html_injection import inject_analysis_controls, inject_analysis_legend, inject_pick_controls, inject_pick_legend, inject_styling
+from git_trace.utils import SHORT_HASH_LENGTH, MAX_COMMIT_MESSAGE_LENGTH, INFO_COLOR, cprint
+
+# TODO: make this configurable ?
+NODE_LABEL_MAX_LENGTH: int = 36
+NODE_HIGHLIGHT_STYLES: dict[str, str] = {"background": "#2a6496", "border": "#87ceeb"}
+ANALYSIS_NODE_COLORS: dict[str, dict[str, str]] = {
+    "independent": {"bg": "#4caf50", "border": "#2e7d32"},
+    "has_deps":    {"bg": "#546e7a", "border": "#37474f"},
+}
+PICK_NODE_COLORS: dict[str, dict[str, str]] = {
+    "safe":        {"bg": "#4caf50", "border": "#2e7d32"},
+    "conditional": {"bg": "#1b7a4a", "border": "#0d4a2d"},
+    "blocked":     {"bg": "#f44336", "border": "#b71c1c"},
+    "missing":     {"bg": "#ff9800", "border": "#e65100"},
+    "context":     {"bg": "#546e7a", "border": "#37474f"},
+}
+
+
+def build_node_color(palette_colors: dict[str, str]) -> dict:
+    return {
+        "background": palette_colors["bg"],
+        "border":     palette_colors["border"],
+        "highlight":  NODE_HIGHLIGHT_STYLES,
+        "hover":      NODE_HIGHLIGHT_STYLES,
+    }
+
+
+# TODO: make this configurable ?
+NETWORK_OPTIONS: str = """
+{
+  "physics": {
+    "enabled": true,
+    "solver": "repulsion",
+    "minVelocity": 0.4,
+    "repulsion": {
+      "nodeDistance": 180,
+      "springLength": 200,
+      "springConstant": 0.04,
+      "damping": 0.12
+    },
+    "stabilization": { "enabled": true, "iterations": 1000 }
+  },
+  "edges": {
+    "arrows": { "to": { "enabled": true, "scaleFactor": 1.0 } },
+    "color": { "color": "#aaaaaa", "highlight": "#ffffff" },
+    "smooth": { "type": "dynamic" }
+  },
+  "interaction": {
+    "hover": true,
+    "tooltipDelay": 100,
+    "navigationButtons": true,
+    "keyboard": true
+  }
+}
+"""
+
+
+def _make_network() -> Network:
+    network: Network = Network(
+        height="98vh",
+        width="100%",
+        bgcolor="#1e1e2e",
+        font_color="#eeeeee",
+        directed=True,
+        notebook=False,
+    )
+    network.set_options(NETWORK_OPTIONS)
+    return network
+
+
+def display_graph(commits: list[Commit], commits_hash_dict: dict[str, Commit], graph: DependencyGraph, output_path: str = "output.html"):
+    network: Network = _make_network()
+
+    for commit in commits:
+        commit_hash: str = commit.hash
+        has_deps: bool = bool(graph.relationships.get(commit_hash))
+        palette: dict[str, str] = ANALYSIS_NODE_COLORS["has_deps" if has_deps else "independent"]
+        dependency_lines: list[str] = [
+            f"  • [{dependency_hash[:SHORT_HASH_LENGTH]}] {commits_hash_dict[dependency_hash].message[:MAX_COMMIT_MESSAGE_LENGTH]}"
+            for dependency_hash in sorted(graph.get_dependencies_for(commit_hash))
+        ]
+        tooltip: str = "\n".join(
+            [f"[{commit_hash[:SHORT_HASH_LENGTH]}]  {commit.message}"]
+            + (["\nDepends on:"] + dependency_lines if dependency_lines else [])
+        )
+        network.add_node(
+            commit_hash,
+            label=f"{truncate_label(commit.message)}\n{commit_hash[:SHORT_HASH_LENGTH]}",
+            title=tooltip,
+            color=build_node_color(palette),
+            font={"size": 11, "color": "#ffffff"},
+            shape="box",
+            margin=10,
+        )
+
+    for hash_b, dependency_set in graph.relationships.items():
+        for hash_a in dependency_set:
+            network.add_edge(
+                hash_a, hash_b,
+                title=f"[{hash_b[:SHORT_HASH_LENGTH]}] depends on [{hash_a[:SHORT_HASH_LENGTH]}]",
+                color="#dddddd",
+                width=1.5,
+            )
+
+    out_path: str = os.path.abspath(output_path)
+    network.save_graph(out_path)
+    inject_analysis_controls(out_path)
+    inject_analysis_legend(out_path)
+    inject_styling(out_path)
+    cprint(f"[INFO] Interactive graph saved to:\n{' '*4}{out_path}\n", color=INFO_COLOR)
+    webbrowser.open(f"file:///{out_path}") # TODO: make this configurable
+    cprint("[INFO] Opened in your default browser. Drag nodes freely!\n", color=INFO_COLOR)
+
+
+def display_pick_graph(commits: list[Commit], commits_hash_dict: dict[str, Commit], graph: DependencyGraph, analysis: CherryPickAnalysis, output_path: str = "git_trace_pick_output.html"):
+    network: Network = _make_network()
+
+    safe_set: set[str] = set(analysis.safe)
+    blocked_set: set[str] = set(analysis.blocked.keys())
+    conditional_set: set[str] = set(analysis.conditional)
+    missing_set: set[str] = {dependency_hash for dependency_hashes in analysis.blocked.values() for dependency_hash in dependency_hashes}
+
+    for commit in commits:
+        commit_hash: str = commit.hash
+        role: str
+        status_line: str
+
+        if commit_hash in safe_set:
+            role = "safe"
+            status_line = "[✔] Safe to cherry-pick"
+        elif commit_hash in conditional_set:
+            role = "conditional"
+            status_line = "[◑] Safe to pick, but only after blocked parent dependencies are resolved"
+        elif commit_hash in blocked_set:
+            role = "blocked"
+            missing_msgs: list[str] = [
+                f"  • [{dependency_hash[:SHORT_HASH_LENGTH]}] {commits_hash_dict.get(dependency_hash, Commit('<unknown>', '<unknown>')).message[:MAX_COMMIT_MESSAGE_LENGTH]}"
+                for dependency_hash in sorted(analysis.blocked[commit_hash])
+            ]
+            status_line = "[✘] Blocked - missing dependencies:\n" + "\n".join(missing_msgs)
+        elif commit_hash in missing_set:
+            role = "missing"
+            status_line = "[⚠] Not picked - required by blocked commit(s)"
+        else:
+            role = "context"
+            status_line = "[-] Context commit (not in pick list)"
+
+        dependency_lines: list[str] = [
+            f"  • [{dependency_hash[:SHORT_HASH_LENGTH]}] {commits_hash_dict[dependency_hash].message[:MAX_COMMIT_MESSAGE_LENGTH] if dependency_hash in commits_hash_dict else ''}"
+            for dependency_hash in sorted(graph.get_dependencies_for(commit_hash))
+        ]
+        tooltip: str = "\n".join(
+            [f"[{commit_hash[:SHORT_HASH_LENGTH]}]  {commit.message}", "", status_line]
+            + (["", "Depends on:"] + dependency_lines if dependency_lines else [])
+        )
+        network.add_node(
+            commit_hash,
+            label=f"{truncate_label(commit.message)}\n{commit_hash[:SHORT_HASH_LENGTH]}",
+            title=tooltip,
+            color=build_node_color(PICK_NODE_COLORS[role]),
+            font={"size": 11, "color": "#ffffff"},
+            shape="box",
+            margin=10,
+        )
+
+    for hash_b, dependency_set in graph.relationships.items():
+        for hash_a in dependency_set:
+            is_blocking: bool = hash_b in blocked_set and hash_a in analysis.blocked.get(hash_b, set())
+            network.add_edge(
+                hash_a, hash_b,
+                title=f"[{hash_b[:SHORT_HASH_LENGTH]}] depends on [{hash_a[:SHORT_HASH_LENGTH]}]",
+                color="#ff4444" if is_blocking else "#666666",
+                width=2.5 if is_blocking else 1.0,
+                dashes=not is_blocking,
+            )
+
+    out_path: str = os.path.abspath(output_path)
+    network.save_graph(out_path)
+    inject_pick_controls(out_path)
+    inject_pick_legend(out_path)
+    inject_styling(out_path)
+    cprint(f"[INFO] Pick graph saved to:\n{' '*4}{out_path}\n", color=INFO_COLOR)
+    webbrowser.open(f"file:///{out_path}") # TODO: make this configurable
+    cprint("[INFO] Opened in your default browser. Drag nodes freely!\n", color=INFO_COLOR)
+
+
+def truncate_label(msg: str) -> str:
+    return (msg[:NODE_LABEL_MAX_LENGTH] + "…") if len(msg) > NODE_LABEL_MAX_LENGTH else msg

git_trace/output/html_injection.py

@@ -0,0 +1,34 @@
+from pathlib import Path
+
+_ASSETS: Path = Path(__file__).parent / "assets"
+
+
+def _load_asset(name: str) -> str:
+    return (_ASSETS / name).read_text(encoding="utf-8")
+
+
+def _inject(html_path: str, snippet: str):
+    text = Path(html_path).read_text(encoding="utf-8")
+    if "</body>" in text:
+        text = text.replace("</body>", snippet + "\n</body>", 1)
+        Path(html_path).write_text(text, encoding="utf-8")
+
+
+def inject_analysis_controls(html_path: str):
+    _inject(html_path, _load_asset("analysis_controls.html"))
+
+
+def inject_analysis_legend(html_path: str):
+    _inject(html_path, _load_asset("analysis_legend.html"))
+
+
+def inject_pick_controls(html_path: str):
+    _inject(html_path, _load_asset("pick_controls.html"))
+
+
+def inject_pick_legend(html_path: str):
+    _inject(html_path, _load_asset("pick_legend.html"))
+
+
+def inject_styling(html_path: str):
+    _inject(html_path, _load_asset("styling.html"))

git_trace/output/text.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+from git_trace.analysis import DependencyGraph, CherryPickAnalysis
+from git_trace.git import Commit
+from git_trace.utils import SHORT_HASH_LENGTH, cprint, INFO_COLOR, Color, MAX_COMMIT_MESSAGE_LENGTH
+
+
+def print_text_tree(commits: list[Commit], commits_hash_dict: dict[str, Commit], graph: DependencyGraph, txt_output_path: str | None = None):
+    title: str = "Commit dependency tree  (○ = independent  ● = has dependencies)"
+    lines: list[str] = [title]
+    cprint(title, color=Color.CYAN)
+    for commit in commits:
+        line: str = f"  [{'●' if graph.relationships.get(commit.hash) else '○'}] [{commit.hash[:SHORT_HASH_LENGTH]}]  {commits_hash_dict[commit.hash].message[:MAX_COMMIT_MESSAGE_LENGTH]}"
+        lines.append(line)
+        cprint(line)
+
+        for dependency_hash in sorted(graph.get_dependencies_for(commit.hash)):
+            line = f"{' '*8}└─ depends on  [{dependency_hash[:SHORT_HASH_LENGTH]}]  {commits_hash_dict[dependency_hash].message[:MAX_COMMIT_MESSAGE_LENGTH]}"
+            lines.append(line)
+            cprint(line)
+
+    if txt_output_path:
+        with open(txt_output_path, "w", encoding="utf-8") as file_handle:
+            file_handle.write("\n".join(lines) + "\n")
+        cprint(f"[INFO] Text tree saved to:\n{' '*4}{txt_output_path}\n", color=INFO_COLOR)
+
+
+def print_pick_result(analysis: CherryPickAnalysis, commits_hash_dict: dict[str, Commit], txt_output_path: str | None = None):
+    title: str = "Cherry-pick dependency results"
+    lines: list[str] = [title]
+    cprint(title, color=Color.CYAN)
+
+    subtitle: str = f"\n  [✔]  {len(analysis.safe)} commit(s) safe to pick:"
+    lines.append(subtitle)
+    cprint(subtitle)
+    for commit_hash in analysis.safe:
+        message: str = commits_hash_dict[commit_hash].message[:MAX_COMMIT_MESSAGE_LENGTH] if commit_hash in commits_hash_dict else "<unknown>"
+        line: str = f"{' '*4}[{commit_hash[:SHORT_HASH_LENGTH]}]  {message}"
+        lines.append(line)
+        cprint(line)
+
+    subtitle: str = f"\n  [◑]  {len(analysis.conditional)} commit(s) safe to pick - only after blocked parent deps are resolved:"
+    lines.append(subtitle)
+    cprint(subtitle)
+    for commit_hash in analysis.conditional:
+        message = commits_hash_dict[commit_hash].message[:MAX_COMMIT_MESSAGE_LENGTH] if commit_hash in commits_hash_dict else "<unknown>"
+        line = f"{' ' * 4}[{commit_hash[:SHORT_HASH_LENGTH]}]  {message}"
+        lines.append(line)
+        cprint(line)
+
+    subtitle: str = f"\n  [✘]  {len(analysis.blocked)} commit(s) blocked (depend on commits not in the pick list):"
+    lines.append(subtitle)
+    cprint(subtitle)
+    for commit_hash, missing in sorted(analysis.blocked.items()):
+        message = commits_hash_dict[commit_hash].message[:MAX_COMMIT_MESSAGE_LENGTH] if commit_hash in commits_hash_dict else "<unknown>"
+        line = f"{' ' * 4}[{commit_hash[:SHORT_HASH_LENGTH]}]  {message}"
+        lines.append(line)
+        cprint(line)
+
+        for dependency_hash in sorted(missing):
+            dependency_message: str = commits_hash_dict[dependency_hash].message[:MAX_COMMIT_MESSAGE_LENGTH] if dependency_hash in commits_hash_dict else "<not in range>"
+            line = f"{' '*8}└─ missing  [{dependency_hash[:SHORT_HASH_LENGTH]}]  {dependency_message}"
+            lines.append(line)
+            cprint(line)
+
+    if txt_output_path:
+        with open(txt_output_path, "w", encoding="utf-8") as file_handle:
+            file_handle.write("\n".join(lines) + "\n")
+        cprint(f"[INFO] Pick result saved to:\n{' '*4}{txt_output_path}\n", color=INFO_COLOR)
+
+
+# TODO: blocked or blocked + conditional ? & with or without messages ?
+def print_pick_list(blocked: dict[str, set[str]], commits_hash_dict: dict[str, Commit]):
+    missing_hashes: set[str] = {dependency_hash for dependency_hashes in blocked.values() for dependency_hash in dependency_hashes}
+    for dependency_hash in sorted(missing_hashes):
+        message: str = commits_hash_dict[dependency_hash].message if dependency_hash in commits_hash_dict else "<unknown>"
+        cprint(f"{dependency_hash[:SHORT_HASH_LENGTH]} {message}")