pyquipu-test-utils 0.1.0__tar.gz

pyquipu_test_utils-0.1.0/.gitignore

@@ -0,0 +1,75 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+
+# tmpfiles
+o.md
+a.md
+a
+o
+t
+tmpfile
+
+# Scaffoldings
+context_builder.yml
+context_builder.py
+current_prompts
+
+# Distribution / Packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environments
+venv/
+env/
+.env
+.venv/
+
+# Testing
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Project Specific
+*.log
+axon.log
+# Ignore test vaults or scratchpads if created in root
+vault/
+temp/
+scratch/
+# --- Quipu Dev Infra ---
+.envs/
+.uv/
+sandbox/
+*.egg-info/
+__pycache__/
+.pytest_cache/
+.coverage
+htmlcov/

pyquipu_test_utils-0.1.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: pyquipu-test-utils
+Version: 0.1.0
+Summary: Common testing utilities for the Quipu ecosystem.
+Author-email: doucx <doucxldh@gmail.com>
+License-Expression: Apache-2.0
+Classifier: Framework :: Pytest
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: pyquipu-bus~=0.1.0
+Requires-Dist: pyquipu-engine~=0.1.0
+Requires-Dist: pyquipu-interfaces~=0.1.0
+Requires-Dist: typer

pyquipu_test_utils-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pyquipu-test-utils"
+version = "0.1.0"
+authors = [{ name="doucx", email="doucxldh@gmail.com" }]
+description = "Common testing utilities for the Quipu ecosystem."
+requires-python = ">=3.10"
+license = "Apache-2.0"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Framework :: Pytest",
+]
+dependencies = [
+    "pyquipu-interfaces ~= 0.1.0",
+    "pyquipu-engine ~= 0.1.0",
+    "pyquipu-bus ~= 0.1.0",
+    "typer"
+]
+
+[tool.uv.sources]
+pyquipu-interfaces = { workspace = true }
+pyquipu-engine = { workspace = true }
+pyquipu-bus = { workspace = true }
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/quipu"]

pyquipu_test_utils-0.1.0/src/quipu/__init__.py

@@ -0,0 +1,3 @@
+# This allows this package to coexist with other distribution packages
+# that contribute to the 'quipu' namespace.
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

pyquipu_test_utils-0.1.0/src/quipu/test_utils/fixtures.py

@@ -0,0 +1,143 @@
+import subprocess
+from pathlib import Path
+from unittest.mock import MagicMock
+
+import pytest
+from typer.testing import CliRunner
+
+from quipu.engine.git_db import GitDB
+from quipu.engine.git_object_storage import GitObjectHistoryReader, GitObjectHistoryWriter
+from quipu.engine.state_machine import Engine
+from quipu.test_utils.helpers import run_git_command
+
+# --- Global & Core Fixtures ---
+
+
+@pytest.fixture
+def runner() -> CliRunner:
+    return CliRunner()
+
+
+@pytest.fixture
+def git_workspace(tmp_path: Path) -> Path:
+    repo_path = tmp_path / "test_repo"
+    repo_path.mkdir()
+    subprocess.run(["git", "init"], cwd=repo_path, check=True, capture_output=True)
+    subprocess.run(["git", "config", "user.email", "test@quipu.dev"], cwd=repo_path, check=True)
+    subprocess.run(["git", "config", "user.name", "Quipu Test"], cwd=repo_path, check=True)
+    return repo_path
+
+
+@pytest.fixture
+def engine_instance(git_workspace: Path) -> Engine:
+    git_db = GitDB(git_workspace)
+    reader = GitObjectHistoryReader(git_db)
+    writer = GitObjectHistoryWriter(git_db)
+    engine = Engine(root_dir=git_workspace, db=git_db, reader=reader, writer=writer)
+    return engine
+
+
+# --- Application Layer Mocks ---
+
+
+@pytest.fixture
+def mock_engine():
+    engine = MagicMock(spec=Engine)
+    # 设置基础属性以防止简单的 AttributeError
+    engine.root_dir = Path("/mock/root")
+    # 显式初始化 git_db
+    engine.git_db = MagicMock()
+    # 初始化状态属性
+    engine.current_node = None
+    engine.history_graph = {}
+    return engine
+
+
+@pytest.fixture
+def mock_runtime():
+    # 延迟导入以避免循环依赖或在未安装 runtime 时报错
+    from quipu.runtime.executor import Executor
+
+    runtime = MagicMock(spec=Executor)
+    return runtime
+
+
+# --- CLI Layer Fixtures ---
+
+
+@pytest.fixture
+def quipu_workspace(engine_instance: Engine):
+    return engine_instance.root_dir, engine_instance.git_db, engine_instance
+
+
+# --- Integration Layer Fixtures ---
+
+
+@pytest.fixture(scope="module")
+def sync_test_environment(tmp_path_factory):
+    base_dir = tmp_path_factory.mktemp("sync_tests")
+    remote_path = base_dir / "remote.git"
+    user_a_path = base_dir / "user_a"
+    user_b_path = base_dir / "user_b"
+
+    # 1. Create bare remote
+    run_git_command(base_dir, ["init", "--bare", str(remote_path)])
+
+    # 2. Clone for User A
+    run_git_command(base_dir, ["clone", str(remote_path), str(user_a_path)])
+    run_git_command(user_a_path, ["config", "user.name", "User A"])
+    run_git_command(user_a_path, ["config", "user.email", "user.a@example.com"])
+
+    # 3. Clone for User B
+    run_git_command(base_dir, ["clone", str(remote_path), str(user_b_path)])
+    run_git_command(user_b_path, ["config", "user.name", "User B"])
+    run_git_command(user_b_path, ["config", "user.email", "user.b@example.com"])
+
+    # Add a dummy file to avoid issues with initial empty commits
+    (user_a_path / "README.md").write_text("Initial commit")
+    run_git_command(user_a_path, ["add", "README.md"])
+    run_git_command(user_a_path, ["commit", "-m", "Initial commit"])
+    run_git_command(user_a_path, ["push", "origin", "HEAD"])
+    run_git_command(user_b_path, ["pull"])
+
+    return remote_path, user_a_path, user_b_path
+
+
+# --- Runtime/Executor Layer Fixtures ---
+
+
+@pytest.fixture
+def mock_runtime_bus(monkeypatch):
+    m_bus = MagicMock()
+    # 让 bus.get 返回传入的 msg_id，方便测试断言语义
+    m_bus.get.side_effect = lambda msg_id, **kwargs: msg_id
+
+    patch_targets = [
+        "quipu.runtime.executor.bus",
+        "quipu.runtime.plugin_loader.bus",
+        "quipu.acts.basic.bus",
+        "quipu.acts.check.bus",
+        "quipu.acts.git.bus",
+        "quipu.acts.memory.bus",
+        "quipu.acts.read.bus",
+        "quipu.acts.refactor.bus",
+        "quipu.acts.shell.bus",
+    ]
+    for target in patch_targets:
+        monkeypatch.setattr(target, m_bus, raising=False)
+    return m_bus
+
+
+@pytest.fixture
+def executor(tmp_path: Path):
+    from quipu.acts.basic import register as register_basic_acts
+    from quipu.runtime.executor import Executor
+
+    instance = Executor(root_dir=tmp_path, yolo=True)
+    register_basic_acts(instance)
+    return instance
+
+
+@pytest.fixture
+def isolated_vault(executor) -> Path:
+    return executor.root_dir

pyquipu_test_utils-0.1.0/src/quipu/test_utils/fixtures.stitcher.yaml

@@ -0,0 +1,24 @@
+"engine_instance": |-
+  提供一个绑定到 git_workspace 的、功能完备的 Engine 实例。
+"executor": |-
+  为运行时测试提供一个隔离的 Executor 实例。
+"git_workspace": |-
+  提供一个已初始化 Git 的干净工作区路径。
+"isolated_vault": |-
+  提供 Executor 实例的根工作目录。
+"mock_engine": |-
+  提供一个模拟的 Engine 实例。
+  用于测试 Application 层在不触及真实 Git/文件系统的情况下的编排逻辑。
+"mock_runtime": |-
+  提供一个模拟的 Runtime (Executor) 实例。
+"mock_runtime_bus": |-
+  自动 patch 所有 runtime 模块中导入的 'bus' 实例。
+"quipu_workspace": |-
+  为 CLI 测试提供 Engine 实例及其工作目录。
+  返回: (work_dir_path, git_db, engine)
+"runner": |-
+  提供一个可复用的 CliRunner 实例。
+"sync_test_environment": |-
+  Sets up a full sync test environment:
+  1. A bare remote repository.
+  2. Two user workspaces cloned from the remote.

pyquipu_test_utils-0.1.0/src/quipu/test_utils/helpers.py

@@ -0,0 +1,418 @@
+import hashlib
+import re
+import subprocess
+import time
+from datetime import datetime
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Set, Tuple
+
+from typer.testing import CliRunner
+
+from quipu.cli.main import app
+from quipu.engine.state_machine import Engine
+from quipu.interfaces.models import QuipuNode
+from quipu.interfaces.storage import HistoryReader, HistoryWriter
+
+# --- Constants ---
+
+# The correct hash for an empty git tree.
+EMPTY_TREE_HASH = "4b825dc642cb6eb9a060e54bf8d69288fbee4904"
+
+
+# --- Git-based Test Helpers ---
+
+
+def create_plan_node_with_change(engine: Engine, parent_hash: str, file_name: str, content: str, message: str) -> str:
+    (engine.root_dir / file_name).write_text(content)
+    new_hash = engine.git_db.get_tree_hash()
+    engine.create_plan_node(input_tree=parent_hash, output_tree=new_hash, plan_content=message)
+    return new_hash
+
+
+def create_capture_node_with_change(engine: Engine, file_name: str, content: str, message: str) -> str:
+    (engine.root_dir / file_name).write_text(content)
+    new_hash = engine.git_db.get_tree_hash()
+    engine.capture_drift(new_hash, message=message)
+    return new_hash
+
+
+# --- In-Memory Backend Mocks for Engine Testing ---
+
+
+class VirtualFileSystem:
+    def __init__(self):
+        self._files: Dict[str, str] = {}
+
+    def write(self, path: str, content: str):
+        self._files[path] = content
+
+    def read(self, path: str) -> Optional[str]:
+        return self._files.get(path)
+
+    def copy(self) -> "VirtualFileSystem":
+        new_vfs = VirtualFileSystem()
+        new_vfs._files = self._files.copy()
+        return new_vfs
+
+    @property
+    def files(self) -> Dict[str, str]:
+        return self._files
+
+
+class InMemoryDB:
+    def __init__(self):
+        self.vfs = VirtualFileSystem()
+        self.snapshots: Dict[str, VirtualFileSystem] = {EMPTY_TREE_HASH: VirtualFileSystem()}
+        self.nodes: Dict[str, QuipuNode] = {}  # output_tree -> Node
+
+    def get_tree_hash(self) -> str:
+        if not self.vfs.files:
+            return EMPTY_TREE_HASH
+
+        sorted_files = sorted(self.vfs.files.items())
+        hasher = hashlib.sha1()
+        for path, content in sorted_files:
+            hasher.update(path.encode("utf-8"))
+            hasher.update(content.encode("utf-8"))
+
+        tree_hash = hasher.hexdigest()
+        if tree_hash not in self.snapshots:
+            self.snapshots[tree_hash] = self.vfs.copy()
+        return tree_hash
+
+    def checkout_tree(self, new_tree_hash: str, old_tree_hash: Optional[str] = None):
+        # InMemoryDB 总是执行“瞬间切换”，不需要模拟 diff 优化逻辑
+        tree_hash = new_tree_hash
+        if tree_hash not in self.snapshots:
+            raise FileNotFoundError(f"In-memory snapshot not found for hash: {tree_hash}")
+        self.vfs = self.snapshots[tree_hash].copy()
+
+    def get_diff_name_status(self, old_tree: str, new_tree: str) -> List[Tuple[str, str]]:
+        old_vfs = self.snapshots.get(old_tree, VirtualFileSystem()).files
+        new_vfs = self.snapshots.get(new_tree, VirtualFileSystem()).files
+
+        old_files = set(old_vfs.keys())
+        new_files = set(new_vfs.keys())
+
+        added = new_files - old_files
+        deleted = old_files - new_files
+        common = old_files & new_files
+
+        changes = []
+        for f in added:
+            changes.append(("A", f))
+        for f in deleted:
+            changes.append(("D", f))
+        for f in common:
+            if old_vfs[f] != new_vfs[f]:
+                changes.append(("M", f))
+        return sorted(changes)
+
+    def get_diff_stat(self, old_tree: str, new_tree: str) -> str:
+        changes = self.get_diff_name_status(old_tree, new_tree)
+        return "\n".join(f"{status}\t{path}" for status, path in changes)
+
+
+class InMemoryHistoryManager(HistoryReader, HistoryWriter):
+    def __init__(self, db: InMemoryDB):
+        self.db = db  # The db holds the single source of truth for nodes
+
+    def create_node(
+        self,
+        node_type: str,
+        input_tree: str,
+        output_tree: str,
+        content: str,
+        summary_override: Optional[str] = None,
+        **kwargs: Any,
+    ) -> QuipuNode:
+        fake_commit_hash = hashlib.sha1(f"{output_tree}{content}{time.time()}".encode()).hexdigest()
+
+        node = QuipuNode(
+            commit_hash=fake_commit_hash,
+            input_tree=input_tree,
+            output_tree=output_tree,
+            timestamp=datetime.now(),
+            filename=Path(f"memory://{fake_commit_hash}"),
+            node_type=node_type,
+            content=content,
+            summary=summary_override or (content.splitlines()[0] if content else f"Node {output_tree[:7]}"),
+        )
+
+        # Correctly link parent upon creation
+        if input_tree in self.db.nodes:
+            parent_node = self.db.nodes[input_tree]
+            node.parent = parent_node
+            parent_node.children.append(node)
+
+        self.db.nodes[output_tree] = node
+        return node
+
+    def load_all_nodes(self) -> List[QuipuNode]:
+        # The relationships are already built, just return the list
+        return sorted(list(self.db.nodes.values()), key=lambda n: n.timestamp)
+
+    def get_node_count(self) -> int:
+        return len(self.db.nodes)
+
+    def load_nodes_paginated(self, limit: int, offset: int) -> List[QuipuNode]:
+        all_nodes = sorted(self.db.nodes.values(), key=lambda n: n.timestamp, reverse=True)
+        return all_nodes[offset : offset + limit]
+
+    def find_nodes(
+        self,
+        summary_regex: Optional[str] = None,
+        node_type: Optional[str] = None,
+        limit: int = 10,
+    ) -> List[QuipuNode]:
+        candidates = list(self.db.nodes.values())
+
+        if summary_regex:
+            try:
+                pattern = re.compile(summary_regex, re.IGNORECASE)
+                candidates = [node for node in candidates if pattern.search(node.summary)]
+            except re.error:
+                return []
+
+        if node_type:
+            candidates = [node for node in candidates if node.node_type == node_type]
+
+        candidates.sort(key=lambda n: n.timestamp, reverse=True)
+        return candidates[:limit]
+
+    def get_node_content(self, node: QuipuNode) -> str:
+        return node.content
+
+    def get_ancestor_output_trees(self, start_output_tree_hash: str) -> Set[str]:
+        ancestors = set()
+        if start_output_tree_hash not in self.db.nodes:
+            return ancestors
+
+        curr = self.db.nodes[start_output_tree_hash]
+        while curr and curr.parent:
+            parent_node = curr.parent
+            ancestors.add(parent_node.output_tree)
+            curr = parent_node
+        return ancestors
+
+    def get_descendant_output_trees(self, start_output_tree_hash: str) -> Set[str]:
+        descendants = set()
+        if start_output_tree_hash not in self.db.nodes:
+            return descendants
+
+        queue = [self.db.nodes[start_output_tree_hash]]
+        visited = {start_output_tree_hash}
+
+        while queue:
+            current_node = queue.pop(0)
+            for child in current_node.children:
+                if child.output_tree not in visited:
+                    descendants.add(child.output_tree)
+                    visited.add(child.output_tree)
+                    queue.append(child)
+        return descendants
+
+    def get_node_position(self, output_tree_hash: str) -> int:
+        all_nodes = sorted(self.db.nodes.values(), key=lambda n: n.timestamp, reverse=True)
+        for i, node in enumerate(all_nodes):
+            if node.output_tree == output_tree_hash:
+                return i
+        return -1
+
+    def get_private_data(self, node_commit_hash: str) -> Optional[str]:
+        return None
+
+    def get_node_blobs(self, commit_hash: str) -> Dict[str, bytes]:
+        return {}
+
+
+# --- CLI/Integration Test Helpers ---
+
+
+def run_git_command(cwd: Path, args: list[str], check: bool = True) -> str:
+    result = subprocess.run(["git"] + args, cwd=cwd, capture_output=True, text=True, check=check)
+    return result.stdout.strip()
+
+
+def get_local_quipu_heads(work_dir: Path) -> set[str]:
+    refs_output = run_git_command(
+        work_dir, ["for-each-ref", "--format=%(objectname)", "refs/quipu/local/heads"], check=False
+    )
+    if not refs_output:
+        return set()
+    return set(refs_output.splitlines())
+
+
+def create_node_via_cli(runner: CliRunner, work_dir: Path, content: str) -> str:
+    heads_before = get_local_quipu_heads(work_dir)
+
+    # [FIX] Add an explicit title to the plan to ensure predictable node summary.
+    plan_title = f"Plan for {content}"
+    plan_file = work_dir / f"{content}.md"
+    plan_file.write_text(f"# {plan_title}\n\n~~~~~act\necho '{content}'\n~~~~~")
+
+    result = runner.invoke(app, ["run", str(plan_file), "--work-dir", str(work_dir), "-y"])
+    assert result.exit_code == 0
+
+    heads_after = get_local_quipu_heads(work_dir)
+    new_heads = heads_after - heads_before
+
+    if not new_heads:
+        raise AssertionError("No new Quipu nodes created.")
+
+    # If only 1 node created, return it.
+    if len(new_heads) == 1:
+        return new_heads.pop()
+
+    # If 2 nodes created (Capture + Plan), identify the Plan node by checking if
+    # the explicit title is present in the commit message.
+    for head in new_heads:
+        msg = run_git_command(work_dir, ["log", "-1", "--format=%B", head])
+        if plan_title in msg:
+            return head
+
+    raise AssertionError(f"Could not identify Plan node among {len(new_heads)} new heads: {new_heads}")
+
+
+# --- Engine/Component Test Helpers ---
+
+
+def create_branching_history(engine: Engine) -> Engine:
+    ws = engine.root_dir
+    (ws / "file.txt").write_text("v0")
+    h0 = engine.git_db.get_tree_hash()
+    engine.create_plan_node(EMPTY_TREE_HASH, h0, "plan 0", summary_override="Root Node")
+    (ws / "file.txt").write_text("v1")
+    h1 = engine.git_db.get_tree_hash()
+    engine.create_plan_node(h0, h1, "plan 1", summary_override="Linear Node 1")
+    (ws / "file.txt").write_text("v2")
+    h2 = engine.git_db.get_tree_hash()
+    engine.create_plan_node(h1, h2, "plan 2", summary_override="Branch Point")
+    engine.visit(h2)
+    (ws / "branch_a.txt").touch()
+    h3a = engine.git_db.get_tree_hash()
+    engine.create_plan_node(h2, h3a, "plan 3a", summary_override="Branch A change")
+    engine.visit(h3a)
+    engine.create_plan_node(h3a, h3a, "plan 4", summary_override="Summary Node")
+    engine.visit(h2)
+    (ws / "branch_b.txt").touch()
+    h3b = engine.git_db.get_tree_hash()
+    engine.create_plan_node(h2, h3b, "plan 3b", summary_override="Branch B change")
+    return engine
+
+
+def create_complex_link_history(engine: Engine) -> Engine:
+    ws = engine.root_dir
+    engine.create_plan_node(EMPTY_TREE_HASH, EMPTY_TREE_HASH, "plan sum", summary_override="Ancestor_Summary")
+    (ws / "f").write_text("v0")
+    h0 = engine.git_db.get_tree_hash()
+    engine.create_plan_node(EMPTY_TREE_HASH, h0, "plan 0", summary_override="Root")
+    (ws / "f").write_text("v1")
+    h1 = engine.git_db.get_tree_hash()
+    engine.create_plan_node(h0, h1, "plan 1", summary_override="Branch_Point")
+    engine.visit(h1)
+    (ws / "a").touch()
+    h2a = engine.git_db.get_tree_hash()
+    engine.create_plan_node(h1, h2a, "plan 2a", summary_override="Branch_A")
+    engine.visit(h1)
+    (ws / "b").touch()
+    h2b = engine.git_db.get_tree_hash()
+    engine.create_plan_node(h1, h2b, "plan 2b", summary_override="Parent_Node")
+    engine.visit(h2b)
+    (ws / "c").touch()
+    h3 = engine.git_db.get_tree_hash()
+    engine.create_plan_node(h2b, h3, "plan 3", summary_override="Test_Target_Node")
+    engine.visit(h3)
+    (ws / "d").touch()
+    h4 = engine.git_db.get_tree_hash()
+    engine.create_plan_node(h3, h4, "plan 4", summary_override="Child_Node")
+    return engine
+
+
+def create_linear_history(engine: Engine) -> Tuple[Engine, Dict[str, str]]:
+    ws = engine.root_dir
+
+    # State A
+    (ws / "a.txt").write_text("A")
+    hash_a = engine.git_db.get_tree_hash()
+    engine.create_plan_node(EMPTY_TREE_HASH, hash_a, "Plan A", summary_override="State A")
+
+    # State B
+    (ws / "b.txt").write_text("B")
+    (ws / "a.txt").unlink()
+    hash_b = engine.git_db.get_tree_hash()
+    engine.create_plan_node(hash_a, hash_b, "Plan B", summary_override="State B")
+
+    hashes = {"a": hash_a, "b": hash_b}
+    return engine, hashes
+
+
+def create_dirty_workspace_history(engine: Engine) -> Tuple[Engine, str]:
+    work_dir = engine.root_dir
+    file_path = work_dir / "file.txt"
+
+    # State A
+    file_path.write_text("v1")
+    hash_a = engine.git_db.get_tree_hash()
+    engine.capture_drift(hash_a, message="State A")
+
+    # State B (HEAD)
+    file_path.write_text("v2")
+    engine.capture_drift(engine.git_db.get_tree_hash(), message="State B")
+
+    # Dirty State
+    file_path.write_text("v3")
+
+    return engine, hash_a
+
+
+def create_linear_history_from_specs(engine: Engine, specs: List[Dict[str, Any]]):
+    parent_hash = EMPTY_TREE_HASH
+    if engine.history_graph:
+        # If history is not empty, start from the latest node
+        latest_node = sorted(engine.history_graph.values(), key=lambda n: n.timestamp)[-1]
+        parent_hash = latest_node.output_tree
+
+    for i, spec in enumerate(specs):
+        # Create a unique file change for each node to ensure a new tree hash
+        (engine.root_dir / f"file_{time.time()}_{i}.txt").touch()
+        new_hash = engine.git_db.get_tree_hash()
+
+        if spec["type"] == "plan":
+            engine.create_plan_node(
+                input_tree=parent_hash,
+                output_tree=new_hash,
+                plan_content=spec.get("content", ""),
+                summary_override=spec["summary"],
+            )
+        elif spec["type"] == "capture":
+            engine.capture_drift(new_hash, message=spec["summary"])
+
+        parent_hash = new_hash
+    # Re-align to ensure the engine's internal graph is fully updated
+    engine.align()
+
+
+def create_query_branching_history(engine: Engine) -> Tuple[Engine, str]:
+    ws = engine.root_dir
+    # root -> A
+    (ws / "f_a").touch()
+    h_a = engine.git_db.get_tree_hash()
+    node_a = engine.capture_drift(h_a, "Node A")
+
+    # A -> B (This will become the main branch)
+    (ws / "f_b").touch()
+    h_b = engine.git_db.get_tree_hash()
+    engine.capture_drift(h_b, "Node B")
+
+    # Go back to A to create the branch
+    engine.visit(node_a.output_tree)
+
+    # A -> C
+    (ws / "f_c").touch()
+    engine.capture_drift(engine.git_db.get_tree_hash(), "Node C")
+
+    # Checkout back to B to set it as the current HEAD for the test
+    engine.visit(h_b)
+    engine.align()
+    return engine, h_b

pyquipu_test_utils-0.1.0/src/quipu/test_utils/helpers.stitcher.yaml

@@ -0,0 +1,49 @@
+"InMemoryDB": |-
+  一个模拟 GitDB 接口的内存数据库，用于快速测试。
+"InMemoryDB.get_tree_hash": |-
+  对当前 VFS 内容进行确定性哈希。
+"InMemoryHistoryManager": |-
+  同时实现 Reader 和 Writer 接口的内存历史管理器。
+"VirtualFileSystem": |-
+  一个简单的内存虚拟文件系统。
+"create_branching_history": |-
+  Creates a common branching history for testing.
+  History:
+  - n0 (root) -> n1 -> n2 (branch point) -> n3a (branch A) -> n4 (summary)
+                                        \-> n3b (branch B)
+"create_capture_node_with_change": |-
+  Creates a file change in the workspace and generates a new Capture node.
+  The new node is parented to the current HEAD of the engine.
+  Returns the output_tree hash of the new node.
+"create_complex_link_history": |-
+  Creates a complex history to ensure a specific node has all navigation link types.
+  Node n3 will have: a parent (n2b), a child (n4), an ancestor branch point (n1),
+  and an ancestor summary node (n_summary).
+"create_dirty_workspace_history": |-
+  Creates a history A -> B, then makes the workspace dirty.
+  - State A: file.txt -> "v1"
+  - State B (HEAD): file.txt -> "v2"
+  - Dirty State: file.txt -> "v3"
+  Returns the engine and the hash of state A for checkout tests.
+"create_linear_history": |-
+  Creates a simple linear history A -> B.
+  - State A: a.txt
+  - State B: b.txt (a.txt is removed)
+  Returns the engine and a dictionary mapping state names ('a', 'b') to their output tree hashes.
+"create_linear_history_from_specs": |-
+  Creates a linear history based on a list of specifications.
+  Each spec is a dict: {'type': 'plan'|'capture', 'summary': str, 'content': Optional[str]}
+"create_node_via_cli": |-
+  Helper to create a node via the CLI runner and return its commit hash.
+"create_plan_node_with_change": |-
+  Creates a file change in the workspace and generates a new Plan node.
+  Returns the output_tree hash of the new node.
+"create_query_branching_history": |-
+  Creates a specific branching history for query reachability tests.
+  History: root -> A -> B (HEAD)
+                 \-> C (unreachable)
+  Returns the engine and the hash of state B (the HEAD).
+"get_local_quipu_heads": |-
+  Helper to get a set of all local quipu head commit hashes.
+"run_git_command": |-
+  Helper to run a git command and return stdout.

pyquipu_test_utils-0.1.0/stitcher.lock

@@ -0,0 +1,422 @@
+{
+  "fingerprints": {
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/fixtures.py#engine_instance": {
+      "baseline_code_signature_text": "def engine_instance(git_workspace: Path) -> Engine:",
+      "baseline_code_structure_hash": "508b467f12049f2a128a83de3b3bf26762a4f37b630e28c4eab7f4c34630d020",
+      "baseline_yaml_content_hash": "db9af6f9ab08827b717045437dfcef2083d7963fc22ccec3ebddb6b7c287f86c"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/fixtures.py#executor": {
+      "baseline_code_signature_text": "def executor(tmp_path: Path):",
+      "baseline_code_structure_hash": "828bede5f3d6f8a39a42fb146f9ac9e2121d63b156b32cbb46241212812b1942",
+      "baseline_yaml_content_hash": "45e3c92865ee2aa7de7efbaa80250df0f55de2ef095240af011945389b506487"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/fixtures.py#git_workspace": {
+      "baseline_code_signature_text": "def git_workspace(tmp_path: Path) -> Path:",
+      "baseline_code_structure_hash": "212c48cd2bfdcb11d1b5cfa9bb9aacd9a8b97a695863b62ebbfabbfdcc3c4ebf",
+      "baseline_yaml_content_hash": "9acade793a04a427d40fea92e189056736a0176ca744f8a80c4b317de861e9c2"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/fixtures.py#isolated_vault": {
+      "baseline_code_signature_text": "def isolated_vault(executor) -> Path:",
+      "baseline_code_structure_hash": "4266808927f59d2f83309312cbfbe27adce4d15f5be9898b63a4246c41dcff7c",
+      "baseline_yaml_content_hash": "4564ac7af7fe857ce674e09d77054ec16cea7177a5510422e3527500986e3794"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/fixtures.py#mock_engine": {
+      "baseline_code_signature_text": "def mock_engine():",
+      "baseline_code_structure_hash": "356e9fb160aafb3b3dff193494c8ec9808994d6794585f82c0f088c667dae738",
+      "baseline_yaml_content_hash": "d452e33e4d45988715261d1ac74d72568a97a3b58678054e3f2755330f988cd7"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/fixtures.py#mock_runtime": {
+      "baseline_code_signature_text": "def mock_runtime():",
+      "baseline_code_structure_hash": "33afd9208fd13d1928de8848342ed791bf13f87918ea571de8ad156a621eca13",
+      "baseline_yaml_content_hash": "328e7d4a0cdf5e44f753ec79e30ed151db691dc806ac7aea9368fc57e17d1f03"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/fixtures.py#mock_runtime_bus": {
+      "baseline_code_signature_text": "def mock_runtime_bus(monkeypatch):",
+      "baseline_code_structure_hash": "7cf21c2a06934f4c8699dfc2ede7d34009da427cb32a86b3c32fb864ef905462",
+      "baseline_yaml_content_hash": "b5df45efe6096cbcb714abce7bbc1622d6c9e15567e715875e23b646fcff972a"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/fixtures.py#quipu_workspace": {
+      "baseline_code_signature_text": "def quipu_workspace(engine_instance: Engine):",
+      "baseline_code_structure_hash": "802bd8d11b57f1ad06b0e92bb5f75d8cc3f2dc544f299177179d13f01bcaa448",
+      "baseline_yaml_content_hash": "a2b612e297794a1d66d50d7b24b1cbfc6c181647ce34ebdf95599f7b44e07101"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/fixtures.py#runner": {
+      "baseline_code_signature_text": "def runner() -> CliRunner:",
+      "baseline_code_structure_hash": "261ea21cb8282c88236db52b977b2618b009387fcd2317c1fdba9666e1ac4587",
+      "baseline_yaml_content_hash": "c494b687eac604601096a641a5bf66943175ad538f97595ae6c8e07b07bea26d"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/fixtures.py#sync_test_environment": {
+      "baseline_code_signature_text": "def sync_test_environment(tmp_path_factory):",
+      "baseline_code_structure_hash": "24a3961ed104cd64fdc6f9bb10972cdb4da79c48651ffc5368c42b00134f6149",
+      "baseline_yaml_content_hash": "356e155289d0fda418d23a3f8fa386da6348b2f15a7e645b79c0c9c648634cc8"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryDB": {
+      "baseline_code_signature_text": "class InMemoryDB:",
+      "baseline_code_structure_hash": "9e05bbd44314ebe643651d8910de5c0e60ec7232d4b08be981721d658f7f789f",
+      "baseline_yaml_content_hash": "11b2d1a19410e45345c134bbfb75a1b9c458f3d600d96d1013a483ca24d113d5"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryDB.__init__": {
+      "baseline_code_signature_text": "def __init__(self):",
+      "baseline_code_structure_hash": "9bab2b1dd22fea04e58176b09f65ef4f673738c47abf25fca7e0c62af472206f"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryDB.checkout_tree": {
+      "baseline_code_signature_text": "def checkout_tree(self, new_tree_hash: str, old_tree_hash: Optional[str] = None):",
+      "baseline_code_structure_hash": "5665baaadaf6a2b3e5f09812ec429cd57f9cd0ee96ec6a6fd9b574de0638f5a5"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryDB.get_diff_name_status": {
+      "baseline_code_signature_text": "def get_diff_name_status(self, old_tree: str, new_tree: str) -> List[Tuple[str, str]]:",
+      "baseline_code_structure_hash": "807343877a65b864a254b3e3719d15a6cc0edb17c4e792ea1bba00c60f0be910"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryDB.get_diff_stat": {
+      "baseline_code_signature_text": "def get_diff_stat(self, old_tree: str, new_tree: str) -> str:",
+      "baseline_code_structure_hash": "ce6f966e1089f6eb26f95e61986f232700fdcaf765f9b31111d9d7ebb473ea47"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryDB.get_tree_hash": {
+      "baseline_code_signature_text": "def get_tree_hash(self) -> str:",
+      "baseline_code_structure_hash": "9fd88b05fd5c0e70ea2ea2a59b07ed091770257177751914385e56deeb306eff",
+      "baseline_yaml_content_hash": "59bf4c81e53df8a20316d26ec93e0d11c6a550264bf897046a8e3adfbbe2ab2b"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager": {
+      "baseline_code_signature_text": "class InMemoryHistoryManager(HistoryReader, HistoryWriter):",
+      "baseline_code_structure_hash": "962a4a8935d136f0b54dc8726d0cc5217fa021b39711045bc87661df1602286f",
+      "baseline_yaml_content_hash": "258740eea91ab75bf94fa5ab1aed5ec584df07b6f9be4c583ea06499727330a3"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.__init__": {
+      "baseline_code_signature_text": "def __init__(self, db: InMemoryDB):",
+      "baseline_code_structure_hash": "d83218c094372a8d28cf658577483ef46c9069b26b63410c35e75ace59ba0329"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.create_node": {
+      "baseline_code_signature_text": "def create_node(self, node_type: str, input_tree: str, output_tree: str, content: str, summary_override: Optional[str] = None, **kwargs: Any = {}) -> QuipuNode:",
+      "baseline_code_structure_hash": "0b3e983f67b1351f7a4361e31a7c9144d1988621951d626bf72c09424a75d639"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.find_nodes": {
+      "baseline_code_signature_text": "def find_nodes(self, summary_regex: Optional[str] = None, node_type: Optional[str] = None, limit: int = 10) -> List[QuipuNode]:",
+      "baseline_code_structure_hash": "3d04cb357877311ed8d37041f5ad5d0f322ed4105e52f5b88cfd40b6f110f6cc"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.get_ancestor_output_trees": {
+      "baseline_code_signature_text": "def get_ancestor_output_trees(self, start_output_tree_hash: str) -> Set[str]:",
+      "baseline_code_structure_hash": "5ae091ca177977fc323d5563cb7f0c6e7af44ac50237f951d24c9793c2336220"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.get_descendant_output_trees": {
+      "baseline_code_signature_text": "def get_descendant_output_trees(self, start_output_tree_hash: str) -> Set[str]:",
+      "baseline_code_structure_hash": "8eb09e56e11e9534720ef7286af9a75507b606322ada07811813f6b3278f5edd"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.get_node_blobs": {
+      "baseline_code_signature_text": "def get_node_blobs(self, commit_hash: str) -> Dict[str, bytes]:",
+      "baseline_code_structure_hash": "48acf7a37a5612c09d5062797e966133a5c15ba17d05e10407be3235bb076f3d"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.get_node_content": {
+      "baseline_code_signature_text": "def get_node_content(self, node: QuipuNode) -> str:",
+      "baseline_code_structure_hash": "72fb728d5fb5468b523a77045d87750229fb34202f36e0bfe8861de1ab999ed8"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.get_node_count": {
+      "baseline_code_signature_text": "def get_node_count(self) -> int:",
+      "baseline_code_structure_hash": "f248a486494c998cc0f98482e50a5e3292f3132d247377d5088251762489517e"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.get_node_position": {
+      "baseline_code_signature_text": "def get_node_position(self, output_tree_hash: str) -> int:",
+      "baseline_code_structure_hash": "eeb815e029cbffaf43c5365481a21a4251ca6fb30632886a63a5716104041b0e"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.get_private_data": {
+      "baseline_code_signature_text": "def get_private_data(self, node_commit_hash: str) -> Optional[str]:",
+      "baseline_code_structure_hash": "b03c5152ce31de33095b38682a69df3dcfcd6551fd2d0e5109137fb9a8e6a772"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.load_all_nodes": {
+      "baseline_code_signature_text": "def load_all_nodes(self) -> List[QuipuNode]:",
+      "baseline_code_structure_hash": "860f1b0ce953562bf9798d8e0e7a6d05c0aada817fc5e88689012cb45876f7be"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#InMemoryHistoryManager.load_nodes_paginated": {
+      "baseline_code_signature_text": "def load_nodes_paginated(self, limit: int, offset: int) -> List[QuipuNode]:",
+      "baseline_code_structure_hash": "cf4d892bf90a00fa3f083ef8e4bb292b58bf36a417cf53e04002657744c0022e"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#VirtualFileSystem": {
+      "baseline_code_signature_text": "class VirtualFileSystem:",
+      "baseline_code_structure_hash": "6bee4fef645ed9178324a9e0eb454ed5ebac015954e168eb51cba2553caaf325",
+      "baseline_yaml_content_hash": "c378a76357a9a1ccc65099769acf450a9accb6936ab4c5c3f6411092374d9609"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#VirtualFileSystem.__init__": {
+      "baseline_code_signature_text": "def __init__(self):",
+      "baseline_code_structure_hash": "9bab2b1dd22fea04e58176b09f65ef4f673738c47abf25fca7e0c62af472206f"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#VirtualFileSystem.copy": {
+      "baseline_code_signature_text": "def copy(self) -> VirtualFileSystem:",
+      "baseline_code_structure_hash": "568018bce5cb8d6b0a2a72c2f8d4dc40dfc67db2792096d93e525d1ff339d823"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#VirtualFileSystem.read": {
+      "baseline_code_signature_text": "def read(self, path: str) -> Optional[str]:",
+      "baseline_code_structure_hash": "610c3197a70c8c4e0dc5ddd1a636a625ed5cda307bdbca93d0fb017850a06d1c"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#VirtualFileSystem.write": {
+      "baseline_code_signature_text": "def write(self, path: str, content: str):",
+      "baseline_code_structure_hash": "50fd606d639eaaac881ea1fa5f2f2a97c4919d258818e279b911bc1f4d7031b3"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#create_branching_history": {
+      "baseline_code_signature_text": "def create_branching_history(engine: Engine) -> Engine:",
+      "baseline_code_structure_hash": "df7ba659995fe344b131ba341c3e5941b1f2b7fae977485e0dd0d5ff9b7fa337",
+      "baseline_yaml_content_hash": "cf0e780d4c2f506aa8493a79c7785859dbe57be0ff0d391ec4ae016583a0d7bf"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#create_capture_node_with_change": {
+      "baseline_code_signature_text": "def create_capture_node_with_change(engine: Engine, file_name: str, content: str, message: str) -> str:",
+      "baseline_code_structure_hash": "494564c8a001bce88c6cf3e5c16759210b0516459d7d4c23619b1130504d5401",
+      "baseline_yaml_content_hash": "352884bfbba30a002a2e79028f2abacfbd751ba35198cccde6104a75cb4e9350"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#create_complex_link_history": {
+      "baseline_code_signature_text": "def create_complex_link_history(engine: Engine) -> Engine:",
+      "baseline_code_structure_hash": "9b3bf012779979584d371aa9e851f4880c5e330650aae5e1981bf4ed570fbf0d",
+      "baseline_yaml_content_hash": "2b18d49fe70c484ef9eb7e30b82ef7947626997888fc200007e9bc82bbb52049"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#create_dirty_workspace_history": {
+      "baseline_code_signature_text": "def create_dirty_workspace_history(engine: Engine) -> Tuple[Engine, str]:",
+      "baseline_code_structure_hash": "9a1b473936bc06f3c7c301e66140295213df44abc420f8775246d5987b8c1cb0",
+      "baseline_yaml_content_hash": "788b7ec1efaaeb6e6b78fdfd2bdd37d2e351d623d9295291c369478832bb739d"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#create_linear_history": {
+      "baseline_code_signature_text": "def create_linear_history(engine: Engine) -> Tuple[Engine, Dict[str, str]]:",
+      "baseline_code_structure_hash": "3ada516acb039d0433939843fde70504f99dee0302a1342292fc8d6c9fabf883",
+      "baseline_yaml_content_hash": "2b2e026a825ce169baf9da35d706d1e55fa1ca76af4b7605e78bcbc2e6383599"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#create_linear_history_from_specs": {
+      "baseline_code_signature_text": "def create_linear_history_from_specs(engine: Engine, specs: List[Dict[str, Any]]):",
+      "baseline_code_structure_hash": "4e0464d5d219a29b0877daa0db5127754a0527bb0e2ce2b667521475b6913f19",
+      "baseline_yaml_content_hash": "c7ec7be674a17ad41caac42e79b2950813e70941b054b8b5f6b758a28b36722d"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#create_node_via_cli": {
+      "baseline_code_signature_text": "def create_node_via_cli(runner: CliRunner, work_dir: Path, content: str) -> str:",
+      "baseline_code_structure_hash": "5d80af898918da29c7bf47de2fc50c82d26e55da1ed94e52cf8706bd7b84c9d8",
+      "baseline_yaml_content_hash": "e4aa9c4168e56c0a2f57abc6a79b10ac7853ab019b0c30b5582b0cc12dcf5577"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#create_plan_node_with_change": {
+      "baseline_code_signature_text": "def create_plan_node_with_change(engine: Engine, parent_hash: str, file_name: str, content: str, message: str) -> str:",
+      "baseline_code_structure_hash": "cf61ae48f737c72cd80bbfb1fb68af0b154ff553270f31e181603b9445bc2022",
+      "baseline_yaml_content_hash": "8c2dc8174d13fa669d9125a57591161fa3153ad590205eeada686934077fbcb7"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#create_query_branching_history": {
+      "baseline_code_signature_text": "def create_query_branching_history(engine: Engine) -> Tuple[Engine, str]:",
+      "baseline_code_structure_hash": "b5df830ed85fcd3b85c442eadaf3dfbe4ccc48a4f81f70f89bc0d94d02ea232e",
+      "baseline_yaml_content_hash": "2b33e55e9b1b15627669e69594fbb8287dac86b82599fb48aa339605fc480ac8"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#get_local_quipu_heads": {
+      "baseline_code_signature_text": "def get_local_quipu_heads(work_dir: Path) -> set[str]:",
+      "baseline_code_structure_hash": "98f18e5a64b1643d42f06af5b609169f653f638e973dd802ce642250bd754793",
+      "baseline_yaml_content_hash": "568480bdd2b8aa9ef17a3754a68a6013415adf9bcf951544c00d593c28cfb1b6"
+    },
+    "py://packages/pyquipu-test-utils/src/quipu/test_utils/helpers.py#run_git_command": {
+      "baseline_code_signature_text": "def run_git_command(cwd: Path, args: list[str], check: bool = True) -> str:",
+      "baseline_code_structure_hash": "ab5208c68cb72aff451337e18f15003513c4e1c630a1f8604568417243f200d7",
+      "baseline_yaml_content_hash": "362d9c62b2f1936e5224993c2a2aad1fb3550f95a81f599d1f4d299e34b97b4c"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/fixtures.py#engine_instance": {
+      "baseline_code_signature_text": "def engine_instance(git_workspace: Path) -> Engine:",
+      "baseline_code_structure_hash": "508b467f12049f2a128a83de3b3bf26762a4f37b630e28c4eab7f4c34630d020",
+      "baseline_yaml_content_hash": "db9af6f9ab08827b717045437dfcef2083d7963fc22ccec3ebddb6b7c287f86c"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/fixtures.py#executor": {
+      "baseline_code_signature_text": "def executor(tmp_path: Path):",
+      "baseline_code_structure_hash": "828bede5f3d6f8a39a42fb146f9ac9e2121d63b156b32cbb46241212812b1942",
+      "baseline_yaml_content_hash": "45e3c92865ee2aa7de7efbaa80250df0f55de2ef095240af011945389b506487"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/fixtures.py#git_workspace": {
+      "baseline_code_signature_text": "def git_workspace(tmp_path: Path) -> Path:",
+      "baseline_code_structure_hash": "212c48cd2bfdcb11d1b5cfa9bb9aacd9a8b97a695863b62ebbfabbfdcc3c4ebf",
+      "baseline_yaml_content_hash": "9acade793a04a427d40fea92e189056736a0176ca744f8a80c4b317de861e9c2"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/fixtures.py#isolated_vault": {
+      "baseline_code_signature_text": "def isolated_vault(executor) -> Path:",
+      "baseline_code_structure_hash": "4266808927f59d2f83309312cbfbe27adce4d15f5be9898b63a4246c41dcff7c",
+      "baseline_yaml_content_hash": "4564ac7af7fe857ce674e09d77054ec16cea7177a5510422e3527500986e3794"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/fixtures.py#mock_engine": {
+      "baseline_code_signature_text": "def mock_engine():",
+      "baseline_code_structure_hash": "356e9fb160aafb3b3dff193494c8ec9808994d6794585f82c0f088c667dae738",
+      "baseline_yaml_content_hash": "d452e33e4d45988715261d1ac74d72568a97a3b58678054e3f2755330f988cd7"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/fixtures.py#mock_runtime": {
+      "baseline_code_signature_text": "def mock_runtime():",
+      "baseline_code_structure_hash": "33afd9208fd13d1928de8848342ed791bf13f87918ea571de8ad156a621eca13",
+      "baseline_yaml_content_hash": "328e7d4a0cdf5e44f753ec79e30ed151db691dc806ac7aea9368fc57e17d1f03"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/fixtures.py#mock_runtime_bus": {
+      "baseline_code_signature_text": "def mock_runtime_bus(monkeypatch):",
+      "baseline_code_structure_hash": "7cf21c2a06934f4c8699dfc2ede7d34009da427cb32a86b3c32fb864ef905462",
+      "baseline_yaml_content_hash": "b5df45efe6096cbcb714abce7bbc1622d6c9e15567e715875e23b646fcff972a"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/fixtures.py#quipu_workspace": {
+      "baseline_code_signature_text": "def quipu_workspace(engine_instance: Engine):",
+      "baseline_code_structure_hash": "802bd8d11b57f1ad06b0e92bb5f75d8cc3f2dc544f299177179d13f01bcaa448",
+      "baseline_yaml_content_hash": "a2b612e297794a1d66d50d7b24b1cbfc6c181647ce34ebdf95599f7b44e07101"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/fixtures.py#runner": {
+      "baseline_code_signature_text": "def runner() -> CliRunner:",
+      "baseline_code_structure_hash": "261ea21cb8282c88236db52b977b2618b009387fcd2317c1fdba9666e1ac4587",
+      "baseline_yaml_content_hash": "c494b687eac604601096a641a5bf66943175ad538f97595ae6c8e07b07bea26d"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/fixtures.py#sync_test_environment": {
+      "baseline_code_signature_text": "def sync_test_environment(tmp_path_factory):",
+      "baseline_code_structure_hash": "24a3961ed104cd64fdc6f9bb10972cdb4da79c48651ffc5368c42b00134f6149",
+      "baseline_yaml_content_hash": "356e155289d0fda418d23a3f8fa386da6348b2f15a7e645b79c0c9c648634cc8"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#EMPTY_TREE_HASH": {},
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryDB": {
+      "baseline_code_signature_text": "class InMemoryDB:",
+      "baseline_code_structure_hash": "9e05bbd44314ebe643651d8910de5c0e60ec7232d4b08be981721d658f7f789f",
+      "baseline_yaml_content_hash": "11b2d1a19410e45345c134bbfb75a1b9c458f3d600d96d1013a483ca24d113d5"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryDB.__init__": {
+      "baseline_code_signature_text": "def __init__(self):",
+      "baseline_code_structure_hash": "9bab2b1dd22fea04e58176b09f65ef4f673738c47abf25fca7e0c62af472206f"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryDB.checkout_tree": {
+      "baseline_code_signature_text": "def checkout_tree(self, new_tree_hash: str, old_tree_hash: Optional[str] = None):",
+      "baseline_code_structure_hash": "5665baaadaf6a2b3e5f09812ec429cd57f9cd0ee96ec6a6fd9b574de0638f5a5"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryDB.get_diff_name_status": {
+      "baseline_code_signature_text": "def get_diff_name_status(self, old_tree: str, new_tree: str) -> List[Tuple[str, str]]:",
+      "baseline_code_structure_hash": "807343877a65b864a254b3e3719d15a6cc0edb17c4e792ea1bba00c60f0be910"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryDB.get_diff_stat": {
+      "baseline_code_signature_text": "def get_diff_stat(self, old_tree: str, new_tree: str) -> str:",
+      "baseline_code_structure_hash": "ce6f966e1089f6eb26f95e61986f232700fdcaf765f9b31111d9d7ebb473ea47"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryDB.get_tree_hash": {
+      "baseline_code_signature_text": "def get_tree_hash(self) -> str:",
+      "baseline_code_structure_hash": "9fd88b05fd5c0e70ea2ea2a59b07ed091770257177751914385e56deeb306eff",
+      "baseline_yaml_content_hash": "59bf4c81e53df8a20316d26ec93e0d11c6a550264bf897046a8e3adfbbe2ab2b"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryDB.nodes": {},
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryDB.snapshots": {},
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryDB.vfs": {},
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager": {
+      "baseline_code_signature_text": "class InMemoryHistoryManager(HistoryReader, HistoryWriter):",
+      "baseline_code_structure_hash": "962a4a8935d136f0b54dc8726d0cc5217fa021b39711045bc87661df1602286f",
+      "baseline_yaml_content_hash": "258740eea91ab75bf94fa5ab1aed5ec584df07b6f9be4c583ea06499727330a3"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.__init__": {
+      "baseline_code_signature_text": "def __init__(self, db: InMemoryDB):",
+      "baseline_code_structure_hash": "d83218c094372a8d28cf658577483ef46c9069b26b63410c35e75ace59ba0329"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.create_node": {
+      "baseline_code_signature_text": "def create_node(self, node_type: str, input_tree: str, output_tree: str, content: str, summary_override: Optional[str] = None, **kwargs: Any = {}) -> QuipuNode:",
+      "baseline_code_structure_hash": "0b3e983f67b1351f7a4361e31a7c9144d1988621951d626bf72c09424a75d639"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.db": {},
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.find_nodes": {
+      "baseline_code_signature_text": "def find_nodes(self, summary_regex: Optional[str] = None, node_type: Optional[str] = None, limit: int = 10) -> List[QuipuNode]:",
+      "baseline_code_structure_hash": "3d04cb357877311ed8d37041f5ad5d0f322ed4105e52f5b88cfd40b6f110f6cc"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.get_ancestor_output_trees": {
+      "baseline_code_signature_text": "def get_ancestor_output_trees(self, start_output_tree_hash: str) -> Set[str]:",
+      "baseline_code_structure_hash": "5ae091ca177977fc323d5563cb7f0c6e7af44ac50237f951d24c9793c2336220"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.get_descendant_output_trees": {
+      "baseline_code_signature_text": "def get_descendant_output_trees(self, start_output_tree_hash: str) -> Set[str]:",
+      "baseline_code_structure_hash": "8eb09e56e11e9534720ef7286af9a75507b606322ada07811813f6b3278f5edd"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.get_node_blobs": {
+      "baseline_code_signature_text": "def get_node_blobs(self, commit_hash: str) -> Dict[str, bytes]:",
+      "baseline_code_structure_hash": "48acf7a37a5612c09d5062797e966133a5c15ba17d05e10407be3235bb076f3d"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.get_node_content": {
+      "baseline_code_signature_text": "def get_node_content(self, node: QuipuNode) -> str:",
+      "baseline_code_structure_hash": "72fb728d5fb5468b523a77045d87750229fb34202f36e0bfe8861de1ab999ed8"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.get_node_count": {
+      "baseline_code_signature_text": "def get_node_count(self) -> int:",
+      "baseline_code_structure_hash": "f248a486494c998cc0f98482e50a5e3292f3132d247377d5088251762489517e"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.get_node_position": {
+      "baseline_code_signature_text": "def get_node_position(self, output_tree_hash: str) -> int:",
+      "baseline_code_structure_hash": "eeb815e029cbffaf43c5365481a21a4251ca6fb30632886a63a5716104041b0e"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.get_private_data": {
+      "baseline_code_signature_text": "def get_private_data(self, node_commit_hash: str) -> Optional[str]:",
+      "baseline_code_structure_hash": "b03c5152ce31de33095b38682a69df3dcfcd6551fd2d0e5109137fb9a8e6a772"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.load_all_nodes": {
+      "baseline_code_signature_text": "def load_all_nodes(self) -> List[QuipuNode]:",
+      "baseline_code_structure_hash": "860f1b0ce953562bf9798d8e0e7a6d05c0aada817fc5e88689012cb45876f7be"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#InMemoryHistoryManager.load_nodes_paginated": {
+      "baseline_code_signature_text": "def load_nodes_paginated(self, limit: int, offset: int) -> List[QuipuNode]:",
+      "baseline_code_structure_hash": "cf4d892bf90a00fa3f083ef8e4bb292b58bf36a417cf53e04002657744c0022e"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#VirtualFileSystem": {
+      "baseline_code_signature_text": "class VirtualFileSystem:",
+      "baseline_code_structure_hash": "6bee4fef645ed9178324a9e0eb454ed5ebac015954e168eb51cba2553caaf325",
+      "baseline_yaml_content_hash": "c378a76357a9a1ccc65099769acf450a9accb6936ab4c5c3f6411092374d9609"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#VirtualFileSystem.__init__": {
+      "baseline_code_signature_text": "def __init__(self):",
+      "baseline_code_structure_hash": "9bab2b1dd22fea04e58176b09f65ef4f673738c47abf25fca7e0c62af472206f"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#VirtualFileSystem._files": {},
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#VirtualFileSystem.copy": {
+      "baseline_code_signature_text": "def copy(self) -> VirtualFileSystem:",
+      "baseline_code_structure_hash": "568018bce5cb8d6b0a2a72c2f8d4dc40dfc67db2792096d93e525d1ff339d823"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#VirtualFileSystem.files": {},
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#VirtualFileSystem.read": {
+      "baseline_code_signature_text": "def read(self, path: str) -> Optional[str]:",
+      "baseline_code_structure_hash": "610c3197a70c8c4e0dc5ddd1a636a625ed5cda307bdbca93d0fb017850a06d1c"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#VirtualFileSystem.write": {
+      "baseline_code_signature_text": "def write(self, path: str, content: str):",
+      "baseline_code_structure_hash": "50fd606d639eaaac881ea1fa5f2f2a97c4919d258818e279b911bc1f4d7031b3"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#create_branching_history": {
+      "baseline_code_signature_text": "def create_branching_history(engine: Engine) -> Engine:",
+      "baseline_code_structure_hash": "df7ba659995fe344b131ba341c3e5941b1f2b7fae977485e0dd0d5ff9b7fa337",
+      "baseline_yaml_content_hash": "cf0e780d4c2f506aa8493a79c7785859dbe57be0ff0d391ec4ae016583a0d7bf"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#create_capture_node_with_change": {
+      "baseline_code_signature_text": "def create_capture_node_with_change(engine: Engine, file_name: str, content: str, message: str) -> str:",
+      "baseline_code_structure_hash": "494564c8a001bce88c6cf3e5c16759210b0516459d7d4c23619b1130504d5401",
+      "baseline_yaml_content_hash": "352884bfbba30a002a2e79028f2abacfbd751ba35198cccde6104a75cb4e9350"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#create_complex_link_history": {
+      "baseline_code_signature_text": "def create_complex_link_history(engine: Engine) -> Engine:",
+      "baseline_code_structure_hash": "9b3bf012779979584d371aa9e851f4880c5e330650aae5e1981bf4ed570fbf0d",
+      "baseline_yaml_content_hash": "2b18d49fe70c484ef9eb7e30b82ef7947626997888fc200007e9bc82bbb52049"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#create_dirty_workspace_history": {
+      "baseline_code_signature_text": "def create_dirty_workspace_history(engine: Engine) -> Tuple[Engine, str]:",
+      "baseline_code_structure_hash": "9a1b473936bc06f3c7c301e66140295213df44abc420f8775246d5987b8c1cb0",
+      "baseline_yaml_content_hash": "788b7ec1efaaeb6e6b78fdfd2bdd37d2e351d623d9295291c369478832bb739d"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#create_linear_history": {
+      "baseline_code_signature_text": "def create_linear_history(engine: Engine) -> Tuple[Engine, Dict[str, str]]:",
+      "baseline_code_structure_hash": "3ada516acb039d0433939843fde70504f99dee0302a1342292fc8d6c9fabf883",
+      "baseline_yaml_content_hash": "2b2e026a825ce169baf9da35d706d1e55fa1ca76af4b7605e78bcbc2e6383599"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#create_linear_history_from_specs": {
+      "baseline_code_signature_text": "def create_linear_history_from_specs(engine: Engine, specs: List[Dict[str, Any]]):",
+      "baseline_code_structure_hash": "4e0464d5d219a29b0877daa0db5127754a0527bb0e2ce2b667521475b6913f19",
+      "baseline_yaml_content_hash": "c7ec7be674a17ad41caac42e79b2950813e70941b054b8b5f6b758a28b36722d"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#create_node_via_cli": {
+      "baseline_code_signature_text": "def create_node_via_cli(runner: CliRunner, work_dir: Path, content: str) -> str:",
+      "baseline_code_structure_hash": "5d80af898918da29c7bf47de2fc50c82d26e55da1ed94e52cf8706bd7b84c9d8",
+      "baseline_yaml_content_hash": "e4aa9c4168e56c0a2f57abc6a79b10ac7853ab019b0c30b5582b0cc12dcf5577"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#create_plan_node_with_change": {
+      "baseline_code_signature_text": "def create_plan_node_with_change(engine: Engine, parent_hash: str, file_name: str, content: str, message: str) -> str:",
+      "baseline_code_structure_hash": "cf61ae48f737c72cd80bbfb1fb68af0b154ff553270f31e181603b9445bc2022",
+      "baseline_yaml_content_hash": "8c2dc8174d13fa669d9125a57591161fa3153ad590205eeada686934077fbcb7"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#create_query_branching_history": {
+      "baseline_code_signature_text": "def create_query_branching_history(engine: Engine) -> Tuple[Engine, str]:",
+      "baseline_code_structure_hash": "b5df830ed85fcd3b85c442eadaf3dfbe4ccc48a4f81f70f89bc0d94d02ea232e",
+      "baseline_yaml_content_hash": "2b33e55e9b1b15627669e69594fbb8287dac86b82599fb48aa339605fc480ac8"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#get_local_quipu_heads": {
+      "baseline_code_signature_text": "def get_local_quipu_heads(work_dir: Path) -> set[str]:",
+      "baseline_code_structure_hash": "98f18e5a64b1643d42f06af5b609169f653f638e973dd802ce642250bd754793",
+      "baseline_yaml_content_hash": "568480bdd2b8aa9ef17a3754a68a6013415adf9bcf951544c00d593c28cfb1b6"
+    },
+    "py://packages/quipu-test-utils/src/pyquipu/test_utils/helpers.py#run_git_command": {
+      "baseline_code_signature_text": "def run_git_command(cwd: Path, args: list[str], check: bool = True) -> str:",
+      "baseline_code_structure_hash": "ab5208c68cb72aff451337e18f15003513c4e1c630a1f8604568417243f200d7",
+      "baseline_yaml_content_hash": "362d9c62b2f1936e5224993c2a2aad1fb3550f95a81f599d1f4d299e34b97b4c"
+    }
+  },
+  "version": "1.0"
+}