pyquipu-application 0.1.0__tar.gz

pyquipu_application-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_application-0.1.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: pyquipu-application
+Version: 0.1.0
+Summary: Core application logic for Quipu, orchestrating engine and runtime.
+Author-email: doucx <doucxldh@gmail.com>
+License-Expression: Apache-2.0
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: pyquipu-bus~=0.1.0
+Requires-Dist: pyquipu-common~=0.1.0
+Requires-Dist: pyquipu-engine~=0.1.0
+Requires-Dist: pyquipu-interfaces~=0.1.0
+Requires-Dist: pyquipu-runtime~=0.1.0

pyquipu_application-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pyquipu-application"
+version = "0.1.0"
+authors = [{ name="doucx", email="doucxldh@gmail.com" }]
+description = "Core application logic for Quipu, orchestrating engine and runtime."
+requires-python = ">=3.10"
+license = "Apache-2.0"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "pyquipu-interfaces ~= 0.1.0",
+    "pyquipu-engine ~= 0.1.0",
+    "pyquipu-runtime ~= 0.1.0",
+    "pyquipu-common ~= 0.1.0",
+    "pyquipu-bus ~= 0.1.0",
+]
+
+[tool.uv.sources]
+pyquipu-interfaces = { workspace = true }
+pyquipu-engine = { workspace = true }
+pyquipu-runtime = { workspace = true }
+pyquipu-common = { workspace = true }
+pyquipu-bus = { workspace = true }
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/quipu"]

pyquipu_application-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_application-0.1.0/src/quipu/application/controller.py

@@ -0,0 +1,214 @@
+import logging
+import re
+from pathlib import Path
+from typing import Callable, Dict, List
+
+from quipu.acts import register_core_acts
+from quipu.engine.state_machine import Engine
+from quipu.interfaces.exceptions import ExecutionError as CoreExecutionError
+from quipu.interfaces.exceptions import OperationCancelledError
+from quipu.interfaces.result import QuipuResult
+from quipu.runtime.executor import Executor
+from quipu.runtime.parser import detect_best_parser, get_parser
+
+from .factory import create_engine
+from .plugin_manager import PluginManager
+
+logger = logging.getLogger(__name__)
+
+
+def get_available_acts(work_dir: Path) -> Dict[str, str]:
+    # A dummy confirmation handler is used as it's not required for listing.
+    # Yolo=True ensures no interactive prompts can be triggered.
+    executor = Executor(
+        root_dir=work_dir,
+        yolo=True,
+        confirmation_handler=lambda diff, prompt: True,
+    )
+    register_core_acts(executor)
+    PluginManager().load_from_sources(executor, work_dir)
+    return executor.get_registered_acts()
+
+
+# 定义 ConfirmationHandler 类型别名: (diff_lines, prompt) -> bool
+# 注意: Executor 期望如果不确认则抛出异常，或者返回 False (取决于 Executor 实现)。
+# 为了保持与 CLI 行为一致，调用方传入的 handler 应该在用户拒绝时抛出 OperationCancelledError。
+ConfirmationHandler = Callable[[List[str], str], bool]
+
+
+class QuipuApplication:
+    def __init__(self, work_dir: Path, confirmation_handler: ConfirmationHandler, yolo: bool = False):
+        self.work_dir = work_dir
+        self.confirmation_handler = confirmation_handler
+        self.yolo = yolo
+        self.engine: Engine = create_engine(work_dir)
+        logger.info(f"Operation boundary set to: {self.work_dir}")
+
+    def _prepare_workspace(self) -> str:
+        current_hash = self.engine.git_db.get_tree_hash()
+
+        # 1. 正常 Clean: current_node 存在且与当前 hash 一致
+        is_node_clean = (self.engine.current_node is not None) and (
+            self.engine.current_node.output_tree == current_hash
+        )
+
+        # 2. 创世 Clean: 历史为空 且 当前是空树 (即没有任何文件被追踪)
+        EMPTY_TREE_HASH = "4b825dc642cb6eb9a060e54bf8d69288fbee4904"
+        is_genesis_clean = (not self.engine.history_graph) and (current_hash == EMPTY_TREE_HASH)
+
+        is_clean = is_node_clean or is_genesis_clean
+
+        if not is_clean:
+            self.engine.capture_drift(current_hash)
+
+        if self.engine.current_node:
+            return self.engine.current_node.output_tree
+        else:
+            return current_hash
+
+    def _setup_executor(self) -> Executor:
+        executor = Executor(
+            root_dir=self.work_dir,
+            yolo=self.yolo,
+            confirmation_handler=self.confirmation_handler,
+        )
+
+        # 加载核心 acts
+        register_core_acts(executor)
+
+        # 加载外部插件
+        plugin_manager = PluginManager()
+        plugin_manager.load_from_sources(executor, self.work_dir)
+
+        return executor
+
+    def run(self, content: str, parser_name: str) -> QuipuResult:
+        # --- Phase 1 & 2: Perception & Decision (Lazy Capture) ---
+        input_tree_hash = self._prepare_workspace()
+
+        # --- Phase 3: Action (Execution) ---
+        # 3.1 Parser
+        final_parser_name = parser_name
+        if parser_name == "auto":
+            final_parser_name = detect_best_parser(content)
+            if final_parser_name != "backtick":
+                logger.info(f"🔍 自动检测到解析器: {final_parser_name}")
+
+        parser = get_parser(final_parser_name)
+        statements = parser.parse(content)
+
+        if not statements:
+            return QuipuResult(
+                success=True,  # No failure, just nothing to do
+                exit_code=0,
+                message="axon.warning.noStatements",
+                msg_kwargs={"parser": final_parser_name},
+            )
+
+        # 3.2 Executor Setup
+        executor = self._setup_executor()
+
+        # 3.3 Execute
+        executor.execute(statements)
+
+        # --- Phase 4: Recording (Plan Crystallization) ---
+        final_summary = None
+        # 优先级 1: 从 Markdown 内容中提取 # 标题
+        title_match = re.search(r"^\s*#{1,6}\s+(.*)", content, re.MULTILINE)
+        if title_match:
+            final_summary = title_match.group(1).strip()
+        # 优先级 2: 从第一个 act 指令生成摘要
+        elif statements:
+            final_summary = executor.summarize_statement(statements[0])
+
+        output_tree_hash = self.engine.git_db.get_tree_hash()
+
+        self.engine.create_plan_node(
+            input_tree=input_tree_hash,
+            output_tree=output_tree_hash,
+            plan_content=content,
+            summary_override=final_summary,
+        )
+
+        return QuipuResult(success=True, exit_code=0, message="run.success")
+
+
+def run_quipu(
+    content: str,
+    work_dir: Path,
+    confirmation_handler: ConfirmationHandler,
+    parser_name: str = "auto",
+    yolo: bool = False,
+) -> QuipuResult:
+    app = None
+    try:
+        app = QuipuApplication(work_dir=work_dir, confirmation_handler=confirmation_handler, yolo=yolo)
+        return app.run(content=content, parser_name=parser_name)
+
+    except OperationCancelledError as e:
+        logger.info(f"🚫 操作已取消: {e}")
+        return QuipuResult(
+            success=False, exit_code=2, message="run.error.cancelled", msg_kwargs={"error": str(e)}, error=e
+        )
+
+    except CoreExecutionError as e:
+        logger.error(f"❌ 操作失败: {e}")
+        return QuipuResult(
+            success=False, exit_code=1, message="run.error.execution", msg_kwargs={"error": str(e)}, error=e
+        )
+
+    except Exception as e:
+        logger.error(f"运行时错误: {e}", exc_info=True)
+        return QuipuResult(
+            success=False, exit_code=1, message="run.error.system", msg_kwargs={"error": str(e)}, error=e
+        )
+    finally:
+        # 确保无论成功或失败，引擎资源都被关闭
+        if app and hasattr(app, "engine") and app.engine:
+            app.engine.close()
+
+
+def run_stateless_plan(
+    content: str,
+    work_dir: Path,
+    confirmation_handler: ConfirmationHandler,
+    parser_name: str = "auto",
+    yolo: bool = False,
+) -> QuipuResult:
+    try:
+        executor = Executor(
+            root_dir=work_dir,
+            yolo=yolo,
+            confirmation_handler=confirmation_handler,
+        )
+        register_core_acts(executor)
+        PluginManager().load_from_sources(executor, work_dir)
+
+        final_parser_name = parser_name
+        if parser_name == "auto":
+            final_parser_name = detect_best_parser(content)
+
+        parser = get_parser(final_parser_name)
+        statements = parser.parse(content)
+
+        if not statements:
+            return QuipuResult(
+                success=True,
+                exit_code=0,
+                message="axon.warning.noStatements",
+                msg_kwargs={"parser": final_parser_name},
+            )
+
+        executor.execute(statements)
+        return QuipuResult(success=True, exit_code=0, message="axon.success")
+
+    except CoreExecutionError as e:
+        logger.error(f"❌ 操作失败: {e}")
+        return QuipuResult(
+            success=False, exit_code=1, message="run.error.execution", msg_kwargs={"error": str(e)}, error=e
+        )
+    except Exception as e:
+        logger.error(f"运行时错误: {e}", exc_info=True)
+        return QuipuResult(
+            success=False, exit_code=1, message="run.error.system", msg_kwargs={"error": str(e)}, error=e
+        )

pyquipu_application-0.1.0/src/quipu/application/controller.stitcher.yaml

@@ -0,0 +1,41 @@
+"QuipuApplication": |-
+  封装了 Quipu 核心业务流程的高层应用对象。
+  负责协调 Engine, Parser, Executor。
+"QuipuApplication._prepare_workspace": |-
+  检查并准备工作区，处理状态漂移。
+  返回执行前的 input_tree_hash。
+"QuipuApplication._setup_executor": |-
+  创建、配置并返回一个 Executor 实例，并注入确认处理器。
+"QuipuApplication.run": |-
+  执行一个完整的 Plan。
+"run_quipu": |-
+  Quipu 核心业务逻辑的入口包装器。
+
+  实例化并运行 QuipuApplication，捕获所有异常并转化为 QuipuResult。
+  确保资源被安全释放。
+get_available_acts: |-
+  Statelessly discovers and returns all available acts.
+
+  This function initializes a temporary, stateless executor to discover
+  core acts and acts from plugins found relative to the working directory.
+
+  Args:
+      work_dir: The directory from which to discover project-level plugins.
+
+  Returns:
+      A dictionary mapping act names to their docstrings.
+run_stateless_plan: |-
+  Executes a plan in a stateless manner, bypassing the Quipu engine.
+
+  This function sets up a temporary executor, loads plugins, parses the content,
+  and executes the statements against the specified working directory.
+
+  Args:
+      content: The string content of the plan to execute.
+      work_dir: The root directory for the execution.
+      confirmation_handler: A callable to handle user confirmations.
+      parser_name: The name of the parser to use ('auto' by default).
+      yolo: If True, skips all confirmation prompts.
+
+  Returns:
+      A QuipuResult object indicating the outcome of the execution.

pyquipu_application-0.1.0/src/quipu/application/factory.py

@@ -0,0 +1,56 @@
+import logging
+from pathlib import Path
+
+from quipu.engine.config import ConfigManager
+from quipu.engine.git_db import GitDB
+from quipu.engine.git_object_storage import GitObjectHistoryReader, GitObjectHistoryWriter
+from quipu.engine.state_machine import Engine
+
+from .utils import find_git_repository_root
+
+# 迟延导入以避免循环依赖
+try:
+    from quipu.engine.sqlite_db import DatabaseManager
+    from quipu.engine.sqlite_storage import SQLiteHistoryReader, SQLiteHistoryWriter
+except ImportError:
+    DatabaseManager = None
+    SQLiteHistoryWriter = None
+    SQLiteHistoryReader = None
+
+
+logger = logging.getLogger(__name__)
+
+
+def create_engine(work_dir: Path, lazy: bool = False) -> Engine:
+    project_root = find_git_repository_root(work_dir) or work_dir
+    config = ConfigManager(project_root)
+    storage_type = config.get("storage.type", "git_object")
+    logger.debug(f"Engine factory configured with storage type: '{storage_type}'")
+    git_db = GitDB(project_root)
+    db_manager = None
+
+    # 默认和备用后端
+    reader = GitObjectHistoryReader(git_db)
+    writer = GitObjectHistoryWriter(git_db)
+
+    if storage_type == "sqlite":
+        if not DatabaseManager or not SQLiteHistoryWriter or not SQLiteHistoryReader:
+            raise ImportError("SQLite dependencies could not be loaded. Please check your installation.")
+
+        logger.debug("Using SQLite storage format for reads and writes.")
+        db_manager = DatabaseManager(project_root)
+        db_manager.init_schema()
+
+        # 切换到 SQLite 后端
+        reader = SQLiteHistoryReader(db_manager=db_manager, git_db=git_db)
+        writer = SQLiteHistoryWriter(git_writer=writer, db_manager=db_manager)
+
+    elif storage_type != "git_object":
+        raise NotImplementedError(f"Storage type '{storage_type}' is not supported.")
+
+    # 将所有资源注入 Engine
+    engine = Engine(project_root, db=git_db, reader=reader, writer=writer, db_manager=db_manager)
+    if not lazy:
+        engine.align()
+
+    return engine

pyquipu_application-0.1.0/src/quipu/application/factory.stitcher.yaml

@@ -0,0 +1,10 @@
+"create_engine": |-
+  实例化完整的 Engine 堆栈。
+
+  会自动向上查找项目根目录 (Git Root) 来初始化 Engine。
+  此工厂由配置驱动，以决定使用何种存储后端。
+
+  Args:
+      work_dir: 操作的工作区目录。
+      lazy: 如果为 True，则不立即加载完整的历史图谱 (不调用 align)。
+            这对于需要快速启动并按需加载数据的场景 (如 UI) 至关重要。

pyquipu_application-0.1.0/src/quipu/application/plugin_manager.py

@@ -0,0 +1,40 @@
+import os
+from pathlib import Path
+
+from quipu.runtime.executor import Executor
+from quipu.runtime.plugin_loader import load_plugins
+
+from .utils import find_git_repository_root
+
+
+class PluginManager:
+    def load_from_sources(self, executor: Executor, work_dir: Path):
+        plugin_sources = []
+
+        # 优先级由低到高添加，后面的会覆盖前面的
+        # 1. User Home (Lowest priority)
+        home_acts = Path.home() / ".quipu" / "acts"
+        plugin_sources.append(("🏠 Global", home_acts))
+
+        # 2. Config / Env
+        env_path = os.getenv("AXON_EXTRA_ACTS_DIR")
+        if env_path:
+            plugin_sources.append(("🔧 Env", Path(env_path)))
+
+        # 3. Project Root (Highest priority)
+        project_root_for_plugins = find_git_repository_root(work_dir)
+        if project_root_for_plugins:
+            proj_acts = project_root_for_plugins / ".quipu" / "acts"
+            plugin_sources.append(("📦 Project", proj_acts))
+
+        seen_paths = set()
+        for label, path in plugin_sources:
+            if not path.exists() or not path.is_dir():
+                continue
+
+            resolved_path = path.resolve()
+            if resolved_path in seen_paths:
+                continue
+
+            load_plugins(executor, path)
+            seen_paths.add(resolved_path)

pyquipu_application-0.1.0/src/quipu/application/plugin_manager.stitcher.yaml

@@ -0,0 +1,5 @@
+"PluginManager": |-
+  负责发现、加载和注册外部插件。
+"PluginManager.load_from_sources": |-
+  按照层级顺序加载外部插件，高优先级会覆盖低优先级。
+  优先级顺序: Project > Env > Home

pyquipu_application-0.1.0/src/quipu/application/utils.py

@@ -0,0 +1,16 @@
+import logging
+from pathlib import Path
+from typing import Optional
+
+logger = logging.getLogger(__name__)
+
+
+def find_git_repository_root(start_path: Path) -> Optional[Path]:
+    try:
+        current = start_path.resolve()
+        for parent in [current] + list(current.parents):
+            if (parent / ".git").exists():
+                return parent
+    except Exception:
+        pass
+    return None

pyquipu_application-0.1.0/src/quipu/application/utils.stitcher.yaml

@@ -0,0 +1,2 @@
+"find_git_repository_root": |-
+  向上递归查找包含 .git 的目录作为项目根目录

pyquipu_application-0.1.0/stitcher.lock

@@ -0,0 +1,178 @@
+{
+  "fingerprints": {
+    "py://packages/pyquipu-application/src/quipu/application/controller.py#QuipuApplication": {
+      "baseline_code_signature_text": "class QuipuApplication:",
+      "baseline_code_structure_hash": "d2fb5198cd42afc8c323a52537de5b33164c9a4bb8afa8c3405447eddbafe483",
+      "baseline_yaml_content_hash": "2097b05b0863d0d255508bf524ec72afc5bb74f8a8472a9d5c42db1d78375647"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/controller.py#QuipuApplication.__init__": {
+      "baseline_code_signature_text": "def __init__(self, work_dir: Path, confirmation_handler: ConfirmationHandler, yolo: bool = False):",
+      "baseline_code_structure_hash": "b2ac0b22c850eed01f7838721b9a9040bba40f58237545f3f86d306fa4327f22"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/controller.py#QuipuApplication._prepare_workspace": {
+      "baseline_code_signature_text": "def _prepare_workspace(self) -> str:",
+      "baseline_code_structure_hash": "528a79ec9be83b31b3016bc3a8c5492b13b106464c5bcdca495b4fae187b574d",
+      "baseline_yaml_content_hash": "81dd6b666cf091c621c87fe727fe2f20be9183179073f9c25993d0781ac9ac58"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/controller.py#QuipuApplication._setup_executor": {
+      "baseline_code_signature_text": "def _setup_executor(self) -> Executor:",
+      "baseline_code_structure_hash": "2cccb8bc4e91794d693f8f3f1f9c53109587bcdd7f5b158ca72f92234e3d74cd",
+      "baseline_yaml_content_hash": "9881f5ff456f048f0f958362c910fedcfb0738b4f461dd8a0e04d6fbc30d0944"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/controller.py#QuipuApplication.run": {
+      "baseline_code_signature_text": "def run(self, content: str, parser_name: str) -> QuipuResult:",
+      "baseline_code_structure_hash": "458e8779b9f0df2331eada9d10d5fa4fe729a00ed7a5fde70b771d9beb5bfa8b",
+      "baseline_yaml_content_hash": "ba87b5c38065687528f0d842b3c042da0e4c164a6019a46707ead5b7f2488997"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/controller.py#get_available_acts": {
+      "baseline_code_signature_text": "def get_available_acts(work_dir: Path) -> Dict[str, str]:",
+      "baseline_code_structure_hash": "442aa8ba3388add2d240e0f9bc612bf35528e11d40c765c6ec3a44e4eb874f8b",
+      "baseline_yaml_content_hash": "bd97f637450a7cf01f330f5106a83d9e916dde59d64f2fe89ba667ea8e23e4ac"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/controller.py#run_quipu": {
+      "baseline_code_signature_text": "def run_quipu(content: str, work_dir: Path, confirmation_handler: ConfirmationHandler, parser_name: str = 'auto', yolo: bool = False) -> QuipuResult:",
+      "baseline_code_structure_hash": "d977d58a9db1f2c9d7fb2d5fabb9cccc5edcdb1aeff988f1fa78442b229c699c",
+      "baseline_yaml_content_hash": "316165fbe76e51b117eb3c9c983c8d479df4490b601609f2b0aa5176c9cbd96b"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/controller.py#run_stateless_plan": {
+      "baseline_code_signature_text": "def run_stateless_plan(content: str, work_dir: Path, confirmation_handler: ConfirmationHandler, parser_name: str = 'auto', yolo: bool = False) -> QuipuResult:",
+      "baseline_code_structure_hash": "58320dcc77cb54d7ab31bafcc383b0c8dd3953aaeaf9f8208dab0af5094ffd4e",
+      "baseline_yaml_content_hash": "aa58fd5cec8b7c127c3a729915c6d4f99c875e4405edba365a5f03f5dff992f7"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/factory.py#create_engine": {
+      "baseline_code_signature_text": "def create_engine(work_dir: Path, lazy: bool = False) -> Engine:",
+      "baseline_code_structure_hash": "4565a1494d7662227444205f34a6e4458c80db2856e465388e6d987a15c015c2",
+      "baseline_yaml_content_hash": "3dba786e050a1669e0b95d77fdb347afd214cb596dec260790fbfad6963db840"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/plugin_manager.py#PluginManager": {
+      "baseline_code_signature_text": "class PluginManager:",
+      "baseline_code_structure_hash": "8d211ba7f4db76c8fa4afc820902583d5f7df5c7e482f99b988dba61ece4a2f5",
+      "baseline_yaml_content_hash": "c22797fdf50ccd3ac64731ca93183e2f70839b0611a049639bdc77b4f8fe7f15"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/plugin_manager.py#PluginManager.load_from_sources": {
+      "baseline_code_signature_text": "def load_from_sources(self, executor: Executor, work_dir: Path):",
+      "baseline_code_structure_hash": "e1015eaa8d17516183baa58ec0239c567900a308ec70f60b9ce80fa9e1c72fd4",
+      "baseline_yaml_content_hash": "34b1c59e7fa9a03d089fccdafa494a216e5a7746e0aff3b5891a262b88986369"
+    },
+    "py://packages/pyquipu-application/src/quipu/application/utils.py#find_git_repository_root": {
+      "baseline_code_signature_text": "def find_git_repository_root(start_path: Path) -> Optional[Path]:",
+      "baseline_code_structure_hash": "9f19014baa92289d9b4f04d4ee8a92df475d31c38820edc4ffc20efc9ce218a8",
+      "baseline_yaml_content_hash": "8ab446ed5e94789aede646cc369436537ffdd64fc5da3229937ba99d5bc83bb7"
+    },
+    "py://packages/pyquipu-application/tests/unit/test_controller.py#TestControllerUnit": {
+      "baseline_code_signature_text": "class TestControllerUnit:",
+      "baseline_code_structure_hash": "b8668020e45ac212142e3e2194f2ce94369784ba3969a4757515a4059960e650",
+      "baseline_yaml_content_hash": "e2a45f750adc799b997d14d1c706d2542d3856ce9aba7773a49c5ba2ab15f1d3"
+    },
+    "py://packages/pyquipu-application/tests/unit/test_controller.py#TestControllerUnit.test_run_quipu_empty_plan": {
+      "baseline_code_signature_text": "def test_run_quipu_empty_plan(self, tmp_path, mock_engine, mock_runtime):",
+      "baseline_code_structure_hash": "d5d7459ace504109a1e35f058714a51eb8119c0ea9051168960d877179082f55",
+      "baseline_yaml_content_hash": "1071d0c4058fdf8a5b23344da1028be9c9f008be34eb421479e19174b14c4b6a"
+    },
+    "py://packages/pyquipu-application/tests/unit/test_controller.py#TestControllerUnit.test_run_quipu_execution_error": {
+      "baseline_code_signature_text": "def test_run_quipu_execution_error(self, tmp_path, mock_engine, mock_runtime):",
+      "baseline_code_structure_hash": "97f2e3585c826243e7b61c6b4e3ae485f9986b81c50ef6c72058494a5b12960b",
+      "baseline_yaml_content_hash": "b8ffd9eec97c064fabd6851169bed6211c276c164ec09f3747a2203127b28bf4"
+    },
+    "py://packages/pyquipu-application/tests/unit/test_controller.py#TestControllerUnit.test_run_quipu_success": {
+      "baseline_code_signature_text": "def test_run_quipu_success(self, tmp_path, mock_engine, mock_runtime):",
+      "baseline_code_structure_hash": "eed582f286876d423157f91ac81d1e7963b67cf3eaf66750e14526adf7832146",
+      "baseline_yaml_content_hash": "51d669c5b333dde1c9c4080b4e32e99ee7bfc81f069c896b5dc234b543787810"
+    },
+    "py://packages/pyquipu-application/tests/unit/test_utils.py#TestRootDiscovery": {
+      "baseline_code_signature_text": "class TestRootDiscovery:",
+      "baseline_code_structure_hash": "3b99ed1f64e93ef2a1c0050627ddd0d49734803e0b2e6f16697299dd446a4888"
+    },
+    "py://packages/pyquipu-application/tests/unit/test_utils.py#TestRootDiscovery.test_find_git_repository_root": {
+      "baseline_code_signature_text": "def test_find_git_repository_root(self, tmp_path: Path):",
+      "baseline_code_structure_hash": "512797d245dc49e41a5d3c7c638481b2b0bc3efa3c6be7b89b058842beea7641"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#ConfirmationHandler": {},
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#QuipuApplication": {
+      "baseline_code_signature_text": "class QuipuApplication:",
+      "baseline_code_structure_hash": "d2fb5198cd42afc8c323a52537de5b33164c9a4bb8afa8c3405447eddbafe483",
+      "baseline_yaml_content_hash": "2097b05b0863d0d255508bf524ec72afc5bb74f8a8472a9d5c42db1d78375647"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#QuipuApplication.__init__": {
+      "baseline_code_signature_text": "def __init__(self, work_dir: Path, confirmation_handler: ConfirmationHandler, yolo: bool = False):",
+      "baseline_code_structure_hash": "b2ac0b22c850eed01f7838721b9a9040bba40f58237545f3f86d306fa4327f22"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#QuipuApplication._prepare_workspace": {
+      "baseline_code_signature_text": "def _prepare_workspace(self) -> str:",
+      "baseline_code_structure_hash": "528a79ec9be83b31b3016bc3a8c5492b13b106464c5bcdca495b4fae187b574d",
+      "baseline_yaml_content_hash": "81dd6b666cf091c621c87fe727fe2f20be9183179073f9c25993d0781ac9ac58"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#QuipuApplication._setup_executor": {
+      "baseline_code_signature_text": "def _setup_executor(self) -> Executor:",
+      "baseline_code_structure_hash": "2cccb8bc4e91794d693f8f3f1f9c53109587bcdd7f5b158ca72f92234e3d74cd",
+      "baseline_yaml_content_hash": "9881f5ff456f048f0f958362c910fedcfb0738b4f461dd8a0e04d6fbc30d0944"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#QuipuApplication.confirmation_handler": {},
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#QuipuApplication.engine": {},
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#QuipuApplication.run": {
+      "baseline_code_signature_text": "def run(self, content: str, parser_name: str) -> QuipuResult:",
+      "baseline_code_structure_hash": "458e8779b9f0df2331eada9d10d5fa4fe729a00ed7a5fde70b771d9beb5bfa8b",
+      "baseline_yaml_content_hash": "ba87b5c38065687528f0d842b3c042da0e4c164a6019a46707ead5b7f2488997"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#QuipuApplication.work_dir": {},
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#QuipuApplication.yolo": {},
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#logger": {},
+    "py://packages/quipu-application/src/pyquipu/application/controller.py#run_quipu": {
+      "baseline_code_signature_text": "def run_quipu(content: str, work_dir: Path, confirmation_handler: ConfirmationHandler, parser_name: str = 'auto', yolo: bool = False) -> QuipuResult:",
+      "baseline_code_structure_hash": "d977d58a9db1f2c9d7fb2d5fabb9cccc5edcdb1aeff988f1fa78442b229c699c",
+      "baseline_yaml_content_hash": "316165fbe76e51b117eb3c9c983c8d479df4490b601609f2b0aa5176c9cbd96b"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/factory.py#create_engine": {
+      "baseline_code_signature_text": "def create_engine(work_dir: Path, lazy: bool = False) -> Engine:",
+      "baseline_code_structure_hash": "4565a1494d7662227444205f34a6e4458c80db2856e465388e6d987a15c015c2",
+      "baseline_yaml_content_hash": "3dba786e050a1669e0b95d77fdb347afd214cb596dec260790fbfad6963db840"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/factory.py#logger": {},
+    "py://packages/quipu-application/src/pyquipu/application/plugin_manager.py#PluginManager": {
+      "baseline_code_signature_text": "class PluginManager:",
+      "baseline_code_structure_hash": "8d211ba7f4db76c8fa4afc820902583d5f7df5c7e482f99b988dba61ece4a2f5",
+      "baseline_yaml_content_hash": "c22797fdf50ccd3ac64731ca93183e2f70839b0611a049639bdc77b4f8fe7f15"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/plugin_manager.py#PluginManager.load_from_sources": {
+      "baseline_code_signature_text": "def load_from_sources(self, executor: Executor, work_dir: Path):",
+      "baseline_code_structure_hash": "e1015eaa8d17516183baa58ec0239c567900a308ec70f60b9ce80fa9e1c72fd4",
+      "baseline_yaml_content_hash": "34b1c59e7fa9a03d089fccdafa494a216e5a7746e0aff3b5891a262b88986369"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/utils.py#find_git_repository_root": {
+      "baseline_code_signature_text": "def find_git_repository_root(start_path: Path) -> Optional[Path]:",
+      "baseline_code_structure_hash": "9f19014baa92289d9b4f04d4ee8a92df475d31c38820edc4ffc20efc9ce218a8",
+      "baseline_yaml_content_hash": "8ab446ed5e94789aede646cc369436537ffdd64fc5da3229937ba99d5bc83bb7"
+    },
+    "py://packages/quipu-application/src/pyquipu/application/utils.py#logger": {},
+    "py://packages/quipu-application/tests/unit/conftest.py#__all__": {},
+    "py://packages/quipu-application/tests/unit/test_controller.py#TestControllerUnit": {
+      "baseline_code_signature_text": "class TestControllerUnit:",
+      "baseline_code_structure_hash": "b8668020e45ac212142e3e2194f2ce94369784ba3969a4757515a4059960e650",
+      "baseline_yaml_content_hash": "e2a45f750adc799b997d14d1c706d2542d3856ce9aba7773a49c5ba2ab15f1d3"
+    },
+    "py://packages/quipu-application/tests/unit/test_controller.py#TestControllerUnit.test_run_quipu_empty_plan": {
+      "baseline_code_signature_text": "def test_run_quipu_empty_plan(self, tmp_path, mock_engine, mock_runtime):",
+      "baseline_code_structure_hash": "d5d7459ace504109a1e35f058714a51eb8119c0ea9051168960d877179082f55",
+      "baseline_yaml_content_hash": "1071d0c4058fdf8a5b23344da1028be9c9f008be34eb421479e19174b14c4b6a"
+    },
+    "py://packages/quipu-application/tests/unit/test_controller.py#TestControllerUnit.test_run_quipu_execution_error": {
+      "baseline_code_signature_text": "def test_run_quipu_execution_error(self, tmp_path, mock_engine, mock_runtime):",
+      "baseline_code_structure_hash": "97f2e3585c826243e7b61c6b4e3ae485f9986b81c50ef6c72058494a5b12960b",
+      "baseline_yaml_content_hash": "b8ffd9eec97c064fabd6851169bed6211c276c164ec09f3747a2203127b28bf4"
+    },
+    "py://packages/quipu-application/tests/unit/test_controller.py#TestControllerUnit.test_run_quipu_success": {
+      "baseline_code_signature_text": "def test_run_quipu_success(self, tmp_path, mock_engine, mock_runtime):",
+      "baseline_code_structure_hash": "eed582f286876d423157f91ac81d1e7963b67cf3eaf66750e14526adf7832146",
+      "baseline_yaml_content_hash": "51d669c5b333dde1c9c4080b4e32e99ee7bfc81f069c896b5dc234b543787810"
+    },
+    "py://packages/quipu-application/tests/unit/test_utils.py#TestRootDiscovery": {
+      "baseline_code_signature_text": "class TestRootDiscovery:",
+      "baseline_code_structure_hash": "3b99ed1f64e93ef2a1c0050627ddd0d49734803e0b2e6f16697299dd446a4888"
+    },
+    "py://packages/quipu-application/tests/unit/test_utils.py#TestRootDiscovery.test_find_git_repository_root": {
+      "baseline_code_signature_text": "def test_find_git_repository_root(self, tmp_path: Path):",
+      "baseline_code_structure_hash": "512797d245dc49e41a5d3c7c638481b2b0bc3efa3c6be7b89b058842beea7641"
+    }
+  },
+  "version": "1.0"
+}

pyquipu_application-0.1.0/tests/unit/conftest.py

@@ -0,0 +1,3 @@
+from quipu.test_utils.fixtures import mock_engine, mock_runtime
+
+__all__ = ["mock_engine", "mock_runtime"]

pyquipu_application-0.1.0/tests/unit/test_controller.py

@@ -0,0 +1,100 @@
+from unittest.mock import MagicMock, patch
+
+from quipu.application.controller import run_quipu
+from quipu.interfaces.exceptions import ExecutionError
+
+
+class TestControllerUnit:
+    def test_run_quipu_success(self, tmp_path, mock_engine, mock_runtime):
+        plan_content = """
+```act
+echo
+```
+```text
+hello
+```
+"""
+        # 配置 Mock Engine 的状态以通过 _prepare_workspace 检查
+        # 模拟当前是干净状态 (clean)
+        mock_engine.git_db.get_tree_hash.return_value = "hash_123"
+        mock_node = MagicMock()
+        mock_node.output_tree = "hash_123"
+        mock_engine.current_node = mock_node
+        mock_engine.history_graph = {"hash_123": mock_node}
+
+        # Patch 工厂函数和 Executor 类
+        # 注意：controller 直接导入了 Executor 类，所以我们要 patch 这个类
+        with (
+            patch("quipu.application.controller.create_engine", return_value=mock_engine) as mk_eng_fac,
+            patch("quipu.application.controller.Executor", return_value=mock_runtime) as mk_exec_cls,
+        ):
+            # 执行
+            result = run_quipu(content=plan_content, work_dir=tmp_path, yolo=True, confirmation_handler=lambda *a: True)
+
+            # 验证结果
+            assert result.success is True
+            assert result.exit_code == 0
+
+            # 验证交互
+            mk_eng_fac.assert_called_once_with(tmp_path)
+            # Executor 类被实例化
+            mk_exec_cls.assert_called_once()
+
+            # 验证编排顺序
+            # 1. _prepare_workspace 调用了 get_tree_hash
+            mock_engine.git_db.get_tree_hash.assert_called()
+
+            # 2. Executor 执行
+            mock_runtime.execute.assert_called_once()
+
+            # 3. 最后生成 Plan Node
+            mock_engine.create_plan_node.assert_called_once()
+
+    def test_run_quipu_execution_error(self, tmp_path, mock_engine, mock_runtime):
+        plan_content = """
+```act
+fail_act
+```
+"""
+        # 配置 Mock Engine
+        mock_engine.git_db.get_tree_hash.return_value = "hash_123"
+        mock_engine.current_node = MagicMock()
+        mock_engine.current_node.output_tree = "hash_123"
+
+        with (
+            patch("quipu.application.controller.create_engine", return_value=mock_engine),
+            patch("quipu.application.controller.Executor", return_value=mock_runtime),
+        ):
+            # 模拟 Runtime 抛出业务异常
+            mock_runtime.execute.side_effect = ExecutionError("Task failed successfully")
+
+            result = run_quipu(content=plan_content, work_dir=tmp_path, yolo=True, confirmation_handler=lambda *a: True)
+
+            # 验证错误被捕获并封装到 Result 中
+            assert result.success is False
+            assert result.exit_code == 1
+            assert result.message == "run.error.execution"
+            assert isinstance(result.error, ExecutionError)
+            assert "Task failed successfully" in str(result.error)
+
+    def test_run_quipu_empty_plan(self, tmp_path, mock_engine, mock_runtime):
+        plan_content = "Just some text, no acts."
+
+        # 配置 Mock Engine
+        mock_engine.git_db.get_tree_hash.return_value = "hash_123"
+        mock_engine.current_node = MagicMock()
+        mock_engine.current_node.output_tree = "hash_123"
+
+        with (
+            patch("quipu.application.controller.create_engine", return_value=mock_engine),
+            patch("quipu.application.controller.Executor", return_value=mock_runtime),
+        ):
+            result = run_quipu(content=plan_content, work_dir=tmp_path, yolo=True, confirmation_handler=lambda *a: True)
+
+            # 空计划通常不算失败，但也没有副作用
+            assert result.success is True
+            assert result.exit_code == 0
+            assert result.message == "axon.warning.noStatements"
+
+            # 验证没有调用 execute
+            mock_runtime.execute.assert_not_called()

pyquipu_application-0.1.0/tests/unit/test_controller.stitcher.yaml

@@ -0,0 +1,9 @@
+"TestControllerUnit": |-
+  对 Application 层 Controller 的纯单元测试。
+  使用 Mock 替代真实的 Engine 和 Runtime，仅验证编排逻辑。
+"TestControllerUnit.test_run_quipu_empty_plan": |-
+  测试空计划的处理。
+"TestControllerUnit.test_run_quipu_execution_error": |-
+  测试执行器抛出异常时的错误处理流程。
+"TestControllerUnit.test_run_quipu_success": |-
+  测试正常执行流程：应正确初始化组件并按顺序调用。

pyquipu_application-0.1.0/tests/unit/test_utils.py

@@ -0,0 +1,26 @@
+from pathlib import Path
+
+from quipu.application.utils import find_git_repository_root
+
+
+class TestRootDiscovery:
+    def test_find_git_repository_root(self, tmp_path: Path):
+        # /project/.git
+        # /project/src/subdir
+        project = tmp_path / "project"
+        project.mkdir()
+        (project / ".git").mkdir()
+
+        subdir = project / "src" / "subdir"
+        subdir.mkdir(parents=True)
+
+        # Case 1: From subdir
+        assert find_git_repository_root(subdir) == project.resolve()
+
+        # Case 2: From root
+        assert find_git_repository_root(project) == project.resolve()
+
+        # Case 3: Outside
+        outside = tmp_path / "outside"
+        outside.mkdir()
+        assert find_git_repository_root(outside) is None