From fe5abd6eb5b29c470229c739475b8d99c8969175 Mon Sep 17 00:00:00 2001 From: ethanfel Date: Fri, 2 Jan 2026 13:13:11 +0100 Subject: [PATCH] Create history_tree.py --- history_tree.py | 96 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 96 insertions(+) create mode 100644 history_tree.py diff --git a/history_tree.py b/history_tree.py new file mode 100644 index 0000000..a514445 --- /dev/null +++ b/history_tree.py @@ -0,0 +1,96 @@ +import time +import uuid + +class HistoryTree: + def __init__(self, raw_data): + self.nodes = raw_data.get("nodes", {}) + self.branches = raw_data.get("branches", {"main": None}) + self.head_id = raw_data.get("head_id", None) + + # Migration for legacy list-based history + if "prompt_history" in raw_data and isinstance(raw_data["prompt_history"], list) and not self.nodes: + self._migrate_legacy(raw_data["prompt_history"]) + + def _migrate_legacy(self, old_list): + parent = None + for item in reversed(old_list): + node_id = str(uuid.uuid4())[:8] + self.nodes[node_id] = { + "id": node_id, "parent": parent, "timestamp": time.time(), + "data": item, "note": item.get("note", "Legacy Import") + } + parent = node_id + self.branches["main"] = parent + self.head_id = parent + + def commit(self, data, note="Snapshot"): + new_id = str(uuid.uuid4())[:8] + + # Logic: Are we at the tip of a branch? + active_branch = None + for b_name, tip_id in self.branches.items(): + if tip_id == self.head_id: + active_branch = b_name + break + + # If not at a tip, we must FORK a new branch + if not active_branch: + base_name = "branch" + count = 1 + while f"{base_name}_{count}" in self.branches: count += 1 + active_branch = f"{base_name}_{count}" + + self.nodes[new_id] = { + "id": new_id, "parent": self.head_id, "timestamp": time.time(), + "data": data, "note": note + } + self.branches[active_branch] = new_id + self.head_id = new_id + return new_id + + def checkout(self, node_id): + if node_id in self.nodes: + self.head_id = node_id + return self.nodes[node_id]["data"] + return None + + def to_dict(self): + return {"nodes": self.nodes, "branches": self.branches, "head_id": self.head_id} + + def generate_horizontal_graph(self): + """Generates a Fusion 360-style Horizontal Graph.""" + dot = [ + 'digraph History {', + ' rankdir=LR;', # Left-to-Right layout + ' node [shape=rect, style="filled,rounded", fontname="Arial", margin=0.2];', + ' edge [color="#888888", arrowsize=0.8];' + ] + + # Sort by time for linear flow + sorted_nodes = sorted(self.nodes.values(), key=lambda x: x["timestamp"]) + + for n in sorted_nodes: + nid = n["id"] + note = n.get('note', 'Step') + label = f"{note}\\nid: {nid}" + + # Styling + color = "#e0e0e0" # Default Grey + penwidth = "1" + + # Active Node (HEAD) - Yellow + if nid == self.head_id: + color = "#ffeba0" + penwidth = "3" + + # Branch Tips - Green + if nid in self.branches.values(): + color = "#d0f0c0" + + dot.append(f' "{nid}" [label="{label}", fillcolor="{color}", penwidth="{penwidth}"];') + + if n["parent"] and n["parent"] in self.nodes: + dot.append(f' "{n["parent"]}" -> "{nid}";') + + dot.append("}") + return "\n".join(dot)