From 0631abf85f923e52cd3edf9dc0fa408964c8ed80 Mon Sep 17 00:00:00 2001 From: Lam Hoang Van Date: Tue, 25 Aug 2026 18:43:42 +0900 Subject: [PATCH] =?UTF-8?q?feat(co4e):=20t=C3=A1ch=206=20widget=20UI=20kh?= =?UTF-8?q?=E1=BB=8Fi=20ui/co4e=5Ftab.py=20sang=20presentation/co4e/*?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Lane N3 (Co4E Studio) — dùng bộ workflow refactor-god-file, mỗi bước có characterization test trước khi tách, hậu kiểm ranh giới tầng sau mỗi bước: - skills_list_panel.py / agent_list_panel.py — 2 khu vực sidebar - co4e_canvas_widget.py + canvas_items.py + canvas_interaction_mixin.py — Co4ECanvas tách 3 file (vượt 400 dòng nếu đứng một mình) - node_property_panel.py + node_property_actions_mixin.py + step_config_section.py — StepConfigPanel, cùng lý do - co4e_run_control_widget.py — RunsPagePanel (trang Flow Status) - co4e_chat_view.py — ChatPanel + _ChatInput + helper autocomplete - palette_list.py — _PaletteList dời khỏi ui/co4e_tab.py, hết import ngược presentation -> ui (agent/skills panel giờ import top-level) ui/co4e_tab.py giảm 2089 -> 1878 dòng, chỉ còn phần wiring + business logic (Co4ERunManager/AgentWorker chưa đổi — nằm ngoài phạm vi này, xem docstring presentation/co4e/co4e_tab.py). ui/co4e_canvas.py và ui/co4e_config_panel.py còn lại là compat shim re-export, không đổi API cho bên gọi. Thêm tests/test_co4e_integration.py — dựng thật Co4ETab qua build_co4e_tab(), lái luồng qua nhiều panel trong cùng instance (thêm node, mở/gập chat, chuyển trang Flow Status rồi quay lại không mất state canvas) — bắt lỗi wiring xuyên-panel mà characterization test từng panel riêng không thấy được. Đã xác minh: pytest 348 passed/1 skipped, tools/check_co4e.py sạch, không file nào >400 dòng, domain/application không import PySide6, và so pixel before/after (git worktree tại HEAD cũ) ra 0/1.125.000 pixel khác biệt. Co-Authored-By: Claude Sonnet 5 --- .../workflows/co4e_workflow_service.py | 377 ++ .../co4e-refactor-run-report-canvas-widget.md | 101 + .../co4e-refactor-run-report-chat-view.md | 156 + .../co4e-refactor-run-report-node-property.md | 226 + .../co4e-refactor-run-report-run-control.md | 149 + docs/architecture/co4e-refactor-run-report.md | 297 + .../co4e-split-map-canvas-widget.json | 1275 ++++ .../co4e-split-map-canvas-widget.md | 127 + .../co4e-split-map-chat-view.json | 3079 +++++++++ docs/architecture/co4e-split-map-chat-view.md | 253 + .../co4e-split-map-node-property.json | 123 + .../co4e-split-map-node-property.md | 102 + .../co4e-split-map-run-control.json | 2807 ++++++++ .../co4e-split-map-run-control.md | 238 + docs/architecture/co4e-split-map.json | 5858 +++++++++++++++++ docs/architecture/co4e-split-map.md | 407 ++ domain/workflows/run_record.py | 114 + presentation/co4e/agent_list_panel.py | 87 + presentation/co4e/canvas_geometry.py | 126 + presentation/co4e/canvas_interaction_mixin.py | 262 + presentation/co4e/canvas_items.py | 284 + presentation/co4e/co4e_canvas_widget.py | 247 + presentation/co4e/co4e_chat_view.py | 258 + presentation/co4e/co4e_run_control_widget.py | 116 + presentation/co4e/co4e_tab.py | 69 + .../co4e/node_property_actions_mixin.py | 202 + presentation/co4e/node_property_panel.py | 293 + presentation/co4e/palette_list.py | 55 + presentation/co4e/skills_list_panel.py | 59 + presentation/co4e/step_config_section.py | 134 + .../characterization/test_co4e_agent_panel.py | 317 + .../test_co4e_canvas_geometry.py | 374 ++ .../test_co4e_canvas_widget.py | 842 +++ tests/characterization/test_co4e_chat_view.py | 474 ++ .../test_co4e_run_manager_behavior.py | 464 ++ tests/characterization/test_co4e_runs_page.py | 524 ++ .../test_co4e_skills_panel.py | 309 + .../test_node_property_panel.py | 463 ++ tests/fakes/fake_co4e_workflow_service.py | 174 + tests/test_build_co4e_tab.py | 102 + tests/test_co4e_integration.py | 138 + tests/test_co4e_workflow_service.py | 577 ++ ui/co4e_canvas.py | 797 +-- ui/co4e_config_panel.py | 530 +- ui/co4e_tab.py | 351 +- 45 files changed, 22739 insertions(+), 1578 deletions(-) create mode 100644 application/workflows/co4e_workflow_service.py create mode 100644 docs/architecture/co4e-refactor-run-report-canvas-widget.md create mode 100644 docs/architecture/co4e-refactor-run-report-chat-view.md create mode 100644 docs/architecture/co4e-refactor-run-report-node-property.md create mode 100644 docs/architecture/co4e-refactor-run-report-run-control.md create mode 100644 docs/architecture/co4e-refactor-run-report.md create mode 100644 docs/architecture/co4e-split-map-canvas-widget.json create mode 100644 docs/architecture/co4e-split-map-canvas-widget.md create mode 100644 docs/architecture/co4e-split-map-chat-view.json create mode 100644 docs/architecture/co4e-split-map-chat-view.md create mode 100644 docs/architecture/co4e-split-map-node-property.json create mode 100644 docs/architecture/co4e-split-map-node-property.md create mode 100644 docs/architecture/co4e-split-map-run-control.json create mode 100644 docs/architecture/co4e-split-map-run-control.md create mode 100644 docs/architecture/co4e-split-map.json create mode 100644 docs/architecture/co4e-split-map.md create mode 100644 domain/workflows/run_record.py create mode 100644 presentation/co4e/agent_list_panel.py create mode 100644 presentation/co4e/canvas_geometry.py create mode 100644 presentation/co4e/canvas_interaction_mixin.py create mode 100644 presentation/co4e/canvas_items.py create mode 100644 presentation/co4e/co4e_canvas_widget.py create mode 100644 presentation/co4e/co4e_chat_view.py create mode 100644 presentation/co4e/co4e_run_control_widget.py create mode 100644 presentation/co4e/co4e_tab.py create mode 100644 presentation/co4e/node_property_actions_mixin.py create mode 100644 presentation/co4e/node_property_panel.py create mode 100644 presentation/co4e/palette_list.py create mode 100644 presentation/co4e/skills_list_panel.py create mode 100644 presentation/co4e/step_config_section.py create mode 100644 tests/characterization/test_co4e_agent_panel.py create mode 100644 tests/characterization/test_co4e_canvas_geometry.py create mode 100644 tests/characterization/test_co4e_canvas_widget.py create mode 100644 tests/characterization/test_co4e_chat_view.py create mode 100644 tests/characterization/test_co4e_run_manager_behavior.py create mode 100644 tests/characterization/test_co4e_runs_page.py create mode 100644 tests/characterization/test_co4e_skills_panel.py create mode 100644 tests/characterization/test_node_property_panel.py create mode 100644 tests/fakes/fake_co4e_workflow_service.py create mode 100644 tests/test_build_co4e_tab.py create mode 100644 tests/test_co4e_integration.py create mode 100644 tests/test_co4e_workflow_service.py diff --git a/application/workflows/co4e_workflow_service.py b/application/workflows/co4e_workflow_service.py new file mode 100644 index 0000000..549c18e --- /dev/null +++ b/application/workflows/co4e_workflow_service.py @@ -0,0 +1,377 @@ +"""``Co4EWorkflowService`` — nửa "hành vi" tách ra từ ``Co4ERunManager`` cũ. + +Bối cảnh: ``core/co4e_run_manager.py::Co4ERunManager`` là một ``QObject`` gộp +chung dữ liệu run (nay là ``domain/workflows/run_record.py::RunRecord``), logic +chạy job trên ``AgentWorker``/``QThread``, và logic đọc/ghi lịch sử ra đĩa. File +này là phần còn lại sau khi tách DTO: quản lý vòng đời nhiều run cùng lúc, các +hook nhận sự kiện từ worker, và lưu/nạp lịch sử — nhưng THUẦN PYTHON, không kế +thừa ``QObject`` và không tự dựng ``QThread`` (``application/`` cấm PySide6). + +Hai điều thay ``Signal`` cũ: + * ``changed = Signal()`` -> danh sách callback ``self._changed_callbacks`` + + ``on_changed(cb)`` để đăng ký; mọi chỗ code cũ gọi ``self.changed.emit()`` + nay gọi ``self._emit_changed()``, gọi callback theo ĐÚNG thứ tự đã đăng ký. + * ``event = Signal(str, dict)`` -> ``self._event_callbacks`` + ``on_event(cb)``, + tương tự, thay ``self.event.emit(rid, ev)`` bằng ``self._emit_event(rid, ev)``. + * ``self.changed.connect(self._save_history)`` (lớp cũ tự nối signal của + chính nó vào slot riêng, trong ``__init__``) -> ở đây gọi thẳng + ``self._save_history()`` làm bước ĐẦU TIÊN bên trong ``_emit_changed()``, + trước khi chạy các callback đã đăng ký từ bên ngoài. Chọn cách "gọi thẳng" + (thay vì "đăng ký như callback đầu tiên") vì nó khớp với thứ tự nối cũ + (``_save_history`` luôn được nối sớm nhất trong ``__init__`` nên luôn chạy + trước mọi slot ngoài nối sau) mà không cần một danh sách callback nội bộ + riêng chỉ để chứa đúng một phần tử cố định. + +``start()`` KHÔNG tự tạo ``AgentWorker``/``QThread`` — nó nhận một ``runner`` +(``WorkflowRunner`` Protocol, mặc định ``None``) tiêm qua constructor. Adapter +Qt thật (bọc ``AgentWorker`` — xem ``core/worker.py``) là việc của widget ở +``presentation/``, không viết ở đây; test dùng fake chạy đồng bộ +(``tests/fakes/fake_co4e_workflow_service.py`` hoặc fake cục bộ trong +``tests/test_co4e_workflow_service.py``). + +KHÔNG xoá/sửa ``core/co4e_run_manager.py`` — lớp cũ tiếp tục chạy song song +cho tới khi widget Co4E Studio thật (``ui/co4e_tab.py``) chuyển hẳn sang dùng +service này. +""" +from __future__ import annotations + +import json +import os +from datetime import datetime +from pathlib import Path +from typing import Callable, Dict, List, Optional, Protocol, Set + +from ...core.co4e import CO4E_DIR, STEP_DONE, STEP_ERROR, STEP_PLANNED, Workflow, slugify, workflow_to_dict +from ...domain.workflows.run_record import RunRecord + +_TERMINAL_NODE = {STEP_DONE, STEP_ERROR, STEP_PLANNED} +_HISTORY_CAP = 500 # giữ N run gần nhất trên đĩa + + +def _now_str() -> str: + return datetime.now().strftime("%Y-%m-%d %H:%M") + + +def _current_user() -> str: + """Best-effort creator name for a run (signed-in MS365 identity -> OS user).""" + return os.environ.get("USERNAME") or os.environ.get("USER") or "you" + + +# ---- ports (Protocol) — thay QThread thật bằng thứ tiêm được --------------- +class RunnerJob(Protocol): + """Bề mặt tối thiểu mà job workflow cần từ 'worker' của nó. + + Tương ứng ``AgentWorker.emit_event``/``AgentWorker.is_cancelled`` cũ + (``core/worker.py``) — giữ nguyên chữ ký đó để hàm job bên trong + ``co4e_runner.run_workflow`` không phải đổi khi runner đứng sau là + ``AgentWorker``/``QThread`` thật (adapter ở presentation/) hay là fake + đồng bộ trong test. + """ + + def emit_event(self, ev: dict) -> None: ... + def is_cancelled(self) -> bool: ... + + +class RunWorkerHandle(Protocol): + """Điều khiển một job đang chạy nền — tương ứng phần + ``AgentWorker.request_stop()`` cũ mà ``Co4ERunManager.stop()`` gọi.""" + + def request_stop(self) -> None: ... + + +class WorkflowRunner(Protocol): + """Cổng chạy một job nền, tiêm qua constructor ``Co4EWorkflowService``. + + Thay cho việc service tự ``AgentWorker(job); worker.start()`` (cần + ``QThread`` -> cấm ở ``application/``). Bên gọi ``start()`` truyền vào + ``job`` với đúng chữ ký cũ (``job(worker) -> Optional[dict]``); runner chịu + trách nhiệm chạy nó (nền thật hay đồng bộ) và gọi lại ba callback tương ứng + ba signal cũ của ``AgentWorker`` (``event``/``finished_ok``/``failed``). + """ + + def start(self, run_id: str, job: Callable[[RunnerJob], Optional[dict]], + on_event: Callable[[dict], None], + on_finished: Callable[[Optional[dict]], None], + on_failed: Callable[[str], None]) -> RunWorkerHandle: ... + + +class Co4EWorkflowService: + """Tầng application: vòng đời nhiều run Co4E cùng lúc, thuần Python. + + Vai trò: đây là nơi ``build_co4e_tab(ctx, workflow_service)`` + (``presentation/co4e/co4e_tab.py``) sẽ lấy ``workflow_service`` thật một + khi widget Co4E Studio được lắp lại để dùng nó — hiện widget thật + (``ui/co4e_tab.py``) vẫn dùng ``Co4ERunManager`` cũ song song. + """ + + def __init__(self, ctx, *, history_path: Optional[Path] = None, + runner: Optional[WorkflowRunner] = None): + self.ctx = ctx + self._runs: Dict[str, RunRecord] = {} + self._worker_handles: Dict[str, RunWorkerHandle] = {} + self._seq = 0 + self._output_root: Optional[Path] = None # thư mục output co4e của workspace đang chọn + self._project_id: str = "" # workspace đang chọn — Flow Status lọc theo no + self._runner = runner + # DTO domain khong duoc cham dia (xem domain/workflows/run_record.py), + # nen viec doc/ghi file lich su nam o day, tang application. + self._history_path_value = ( + Path(history_path) if history_path is not None else (CO4E_DIR / "run_history.json") + ) + self._changed_callbacks: List[Callable[[], None]] = [] + self._event_callbacks: List[Callable[[str, dict], None]] = [] + self._load_history() # khoi phuc lich su cu de Flow Status + # giu du lich su qua cac lan restart + + # ---- callback thay Signal --------------------------------------------- + def on_changed(self, cb: Callable[[], None]) -> None: + self._changed_callbacks.append(cb) + + def on_event(self, cb: Callable[[str, dict], None]) -> None: + self._event_callbacks.append(cb) + + def _emit_changed(self) -> None: + self._save_history() # xem docstring dau file: giu dung thu tu ban Qt cu + for cb in self._changed_callbacks: + cb() + + def _emit_event(self, run_id: str, ev) -> None: + for cb in self._event_callbacks: + cb(run_id, ev) + + # ---- persistence -------------------------------------------------- + # Doc/ghi thu cong (json.loads/write_text + tmp.replace), KHONG dung + # AtomicJsonFile — ban dau file nay dung AtomicJsonFile.read(), nhung + # review phat hien no doi hanh vi that so voi Co4ERunManager cu: gap + # JSON hong, AtomicJsonFile.read() ĐOI TEN file hong thanh + # ".bad-" (quarantine) roi moi tra ve mac dinh, trong + # khi ban cu chi bat loi va ĐE NGUYEN file hong tai cho, khong dong gi + # vao no. Day la mot thay doi quan sat duoc tren dia ma khong test nao + # khoa lai va khong co comment bao truoc — Lam (N3) da quyet 24/08: + # GIU HANH VI CU nguyen van (khong quarantine), vi day la buoc tach + # chi duoc phep doi hanh vi khi da noi ra ro rang va co lưới an toan, + # khong phai luc nay. + def _load_history(self) -> None: + try: + data = json.loads(self._history_path_value.read_text(encoding="utf-8")) + except (OSError, ValueError): + return + max_seq = 0 + for rec in data.get("runs", []): + try: + record = RunRecord.from_dict(rec) + except Exception: + continue + if not record.id: + continue + self._runs[record.id] = record + if record.id.startswith("run") and record.id[3:].isdigit(): + max_seq = max(max_seq, int(record.id[3:])) + self._seq = max_seq # tranh sinh id trung voi lich su + + def _save_history(self) -> None: + runs = list(self._runs.values())[-_HISTORY_CAP:] + payload = {"runs": [r.to_dict() for r in runs]} + try: + self._history_path_value.parent.mkdir(parents=True, exist_ok=True) + tmp = self._history_path_value.with_suffix(".json.tmp") + tmp.write_text(json.dumps(payload, ensure_ascii=False, indent=2), + encoding="utf-8") + tmp.replace(self._history_path_value) # atomic — khong bao gio de lai file ghi do dang + except OSError: + # Giu dung hanh vi cu (core/co4e_run_manager.py::_save_history): + # mot lan luu that bai (day dia, mat quyen...) KHONG duoc phep + # chan luong goi cua moi hook (_on_event/_on_finished/_on_failed) + # dang di qua _emit_changed(). Bo try/except nay se lam mot loi + # ghi dia lam vo ca luot xu ly su kien dang chay, chi vi lich su + # khong luu duoc lan nay -- nguoi dung van thay Flow Status dung + # trong phien hien tai, chi la ban ghi tren dia lui lai mot buoc. + pass + + # ---- lifecycle ---------------------------------------------------- + def _next_id(self) -> str: + self._seq += 1 + return f"run{self._seq}" + + def start(self, wf: Workflow, *, skill_map: Optional[Dict[str, str]] = None, + plan_mode: bool = False, only_nodes: Optional[set] = None, + seed_outputs: Optional[Dict[str, str]] = None, + manual: bool = False, label: Optional[str] = None) -> str: + """Đăng ký một run mới và giao job cho ``self._runner`` (nếu có). + + Không tự thực thi AI thật ở đây: khi ``self._runner`` là ``None`` + (mặc định), run được ghi nhận nhưng không job nào được giao đi — dùng + cho test/khi chưa lắp adapter Qt thật. + """ + run_id = self._next_id() + total = len(only_nodes) if only_nodes else len(wf.nodes) + record = RunRecord(run_id, wf.id, label or wf.name, total, plan_mode, manual, + created_by=_current_user(), created_at=_now_str(), + project_id=self._project_id) + # workflow_to_dict() tu dung dataclasses.asdict() de dung ca cay (node, + # step, sub-agent) -> ban than no da la mot "deep copy" sang dict moi, + # khong con giu tham chieu toi wf.nodes/wf.edges song. Vi vay KHONG can + # deepcopy(wf) truoc nhu ban Qt cu (RunHandle.wf giu nguyen doi tuong + # Workflow) -- xem doc string dau file domain/workflows/run_record.py + # ve ly do snapshot o day la dict tho chu khong phai doi tuong. + record.wf = workflow_to_dict(wf) + nodes = list(wf.nodes) + edges = list(wf.edges) + out_dir = self._out_dir(wf) + record.out_dir = str(out_dir) + ctx = self.ctx + sk = dict(skill_map or {}) + only: Optional[Set[str]] = set(only_nodes) if only_nodes else None + seed = dict(seed_outputs or {}) + run_label = record.name + self._runs[run_id] = record + + if self._runner is not None: + def job(worker: RunnerJob): + from ...core import co4e_runner + return co4e_runner.run_workflow( + ctx, nodes, edges, out_dir, worker.emit_event, worker.is_cancelled, + plan_mode=plan_mode, skill_map=sk, only_nodes=only, seed_outputs=seed, + usage_label=run_label) + + self._worker_handles[run_id] = self._runner.start( + run_id, job, + on_event=lambda ev, rid=run_id: self._on_event(rid, ev), + on_finished=lambda _r=None, rid=run_id: self._on_finished(rid), + on_failed=lambda e, rid=run_id: self._on_failed(rid, e), + ) + self._emit_changed() + return run_id + + # ---- worker callbacks (goi tu runner, thay slot Qt cu) ----------------- + def _on_event(self, run_id: str, ev) -> None: + record = self._runs.get(run_id) + if record is not None and isinstance(ev, dict): + t = ev.get("type") + if t == "node_status": + record.node_status[ev.get("node_id")] = ev.get("status") + record.done = sum(1 for s in record.node_status.values() if s in _TERMINAL_NODE) + self._emit_changed() + elif t == "run_done": + if record.status == "running": + record.status = "done" if ev.get("ok", True) else "error" + self._emit_changed() + # quirk co y giu nguyen (xem test_on_event_unknown_run_id... trong ca + # test cu lan test moi): re-emit VO DIEU KIEN, ke ca run_id la hoac ev + # khong phai dict/None -- khac _on_finished/_on_failed la no-op hoan + # toan khi run_id la. + # + # Khac biet CO CHU Y so voi ban Qt cu: Signal(str, dict) cua PySide6 ep + # ev=None thanh {} khi giao cho slot (tac dung phu cua kieu Signal khai + # bao cung). O day khong con Signal nen callback nhan DUNG gia tri ev + # goc (None neu goi voi None) -- khong gia lap lai viec ep kieu do vi + # no la tac dung phu cua Qt, khong phai quy tac nghiep vu can giu. + self._emit_event(run_id, ev) + + def _on_finished(self, run_id: str) -> None: + record = self._runs.get(run_id) + if record is not None and record.status == "running": + # job returned without a run_done event (shouldn't happen) — settle it + record.status = "done" + self._emit_changed() + + def _on_failed(self, run_id: str, err: str) -> None: + record = self._runs.get(run_id) + if record is not None: + record.status = "error" + record.error = str(err) + self._emit_event(run_id, {"type": "run_error", "error": str(err)}) + self._emit_changed() + + # ---- control -------------------------------------------------------- + def stop(self, run_id: str) -> None: + record = self._runs.get(run_id) + worker = self._worker_handles.get(run_id) + if record is not None and worker is not None and record.running: + worker.request_stop() + record.status = "stopped" + self._emit_changed() + + def stop_all(self) -> None: + # Only the CURRENT workspace's runs (Flow Status is per-project). + for run_id in [r for r, rec in self._runs.items() if self._belongs(rec)]: + self.stop(run_id) + + def rename(self, run_id: str, new_name: str) -> None: + """Rename a run in the Flow Status history (and its kept workflow snapshot), + then persist + refresh views. No-op on a blank name / unknown run.""" + record = self._runs.get(run_id) + new_name = (new_name or "").strip() + if record is None or not new_name or new_name == record.name: + return + record.name = new_name + # DTO doi: RunHandle.wf cu la doi tuong Workflow (gan record.wf.name), + # RunRecord.wf o day la dict tho (xem domain/workflows/run_record.py) + # nen doi truc tiep khoa "name" cua dict thay vi thuoc tinh doi tuong. + if record.wf is not None: + record.wf["name"] = new_name + self._emit_changed() + + def remove(self, run_id: str) -> None: + record = self._runs.get(run_id) + if record is not None and record.running: + self.stop(run_id) + self._runs.pop(run_id, None) + self._worker_handles.pop(run_id, None) + self._emit_changed() + + def clear_finished(self) -> None: + # Only clear finished runs of the CURRENT workspace. + for run_id in [r for r, rec in self._runs.items() if not rec.running and self._belongs(rec)]: + self._runs.pop(run_id, None) + self._worker_handles.pop(run_id, None) + self._emit_changed() + + # ---- queries ---------------------------------------------------------- + def _belongs(self, r: RunRecord) -> bool: + """Whether a run belongs to the currently-selected workspace.""" + return getattr(r, "project_id", "") == self._project_id + + def runs(self) -> List[RunRecord]: + """Runs of the CURRENT workspace only — Flow Status is per-project.""" + return [r for r in self._runs.values() if self._belongs(r)] + + def all_runs(self) -> List[RunRecord]: + """Every tracked run across all workspaces (background tracking).""" + return list(self._runs.values()) + + def get(self, run_id: str) -> Optional[RunRecord]: + return self._runs.get(run_id) + + def active_count(self) -> int: + return sum(1 for r in self._runs.values() if r.running and self._belongs(r)) + + def set_current_project(self, project_id: str) -> None: + """Filter Flow Status (and new runs) to this workspace. Runs started while + this is set are tagged with it; the Runs view shows only matching runs.""" + pid = project_id or "" + if pid != self._project_id: + self._project_id = pid + self._emit_changed() # re-render Flow Status for the new workspace + + def set_output_root(self, root: Optional[Path]) -> None: + """Point flow outputs at the SELECTED workspace's co4e folder (set by the + Co4E tab when a project is chosen). ``None`` → fall back to the global + Cowork output dir.""" + self._output_root = Path(root) if root else None + + def _out_dir(self, wf: Workflow) -> Path: + # Flow deliverables are written into the SELECTED workspace (the active + # project's folder) so they land where the user works with files (Folder + # tab), not in the config/install folder. One subfolder per flow keeps + # runs tidy. Falls back to the global Cowork output dir when no workspace + # is selected. + base = self._output_root + if base is None: + try: + base = self.ctx.config.cowork_output_dir() / "co4e" + except Exception: # noqa: BLE001 - fall back to the config dir if unavailable + base = CO4E_DIR / "runs" / "co4e" + d = Path(base) / slugify(wf.name or "flow") + d.mkdir(parents=True, exist_ok=True) + return d diff --git a/docs/architecture/co4e-refactor-run-report-canvas-widget.md b/docs/architecture/co4e-refactor-run-report-canvas-widget.md new file mode 100644 index 0000000..fe1127e --- /dev/null +++ b/docs/architecture/co4e-refactor-run-report-canvas-widget.md @@ -0,0 +1,101 @@ +# Báo cáo hoàn tất — extract:co4e_canvas_widget (lane N3 — Co4E Studio) + +- **Ngày:** 2026-08-25 +- **Người:** hiephv3@fpt.com (N3) +- **Nhánh:** `gamma/refactor` +- **Lệnh đo dùng xuyên suốt:** `.venv/Scripts/python.exe -m pytest tests -q --tb=no -rA --continue-on-collection-errors` + +--- + +## 1. Số test thay đổi so với baseline + +Baseline (Phase 0, trước khi tách): + +``` +323 passed, 1 skipped in 9.34s +``` + +Đo lại sau khi tách — chạy 3 lần liên tiếp trong lượt này: + +| Lần | Kết quả | +|---|---| +| 1 | `1 failed, 345 passed, 1 skipped in 12.25s` — `FAILED tests/test_no_ignored_source.py::test_khong_file_py_nao_bi_bo_quen_chua_theo_doi` | +| 2 | `346 passed, 1 skipped in 13.31s` | +| 3 | `346 passed, 1 skipped in 12.48s` | + +| | passed | failed | collection_errors | skipped | +|---|---|---|---|---| +| Trước (baseline) | 323 | 0 | 0 | 1 | +| Sau (lần 2, 3 — ổn định) | 346 | 0 | 0 | 1 | + +**Về cái fail ở lần 1 — KHÔNG phải hồi quy của lane canvas-widget.** Tại đúng thời điểm chạy lần 1, `git status --porcelain` cho thấy `tests/characterization/test_co4e_runs_page.py` và `presentation/co4e/co4e_run_control_widget.py` đang ở trạng thái untracked (`??`) — đây là sản phẩm của một phiên Claude khác (lane run-control) đang làm việc song song trên cùng thư mục và chưa kịp `git add`. `test_no_ignored_source` kiểm tra "mọi file `.py` phải đã được git add trong clone sạch", nên nó bắt trúng khoảnh khắc file kia chưa staged — đây chính là kiểu hiện tượng "nhiều phiên Claude song song" mà tài liệu hướng dẫn có cảnh báo. Kiểm tra lại `git status` ngay sau đó xác nhận hai file này đã chuyển sang trạng thái `A` (đã add), và lần đo 2, 3 chạy lại đều xanh ổn định (346 passed, 0 failed cả hai lần) — không phải flaky do code của lane này, không phải do `test_atomic_json` (test flaky đã biết) xuất hiện lần nào trong 3 lần chạy. + +Kết luận: `passed` tăng 323 → 346 (+23, đến từ bộ test đặc tả mới `test_co4e_canvas_widget.py` của lane này cộng với các lane khác đang chạy song song trên cùng nhánh). Không có test fail mới thuộc phạm vi lane canvas-widget. `collection_errors` = 0 ở cả hai mốc. `skipped` giữ nguyên 1 (mốc cũ có giải thích trong docstring, không phải nợ phát sinh từ lane này). + +--- + +## 2. File tạo mới / đã sửa + +**Tạo mới (thuộc phạm vi lane canvas-widget):** +- `presentation/co4e/co4e_canvas_widget.py` +- `presentation/co4e/canvas_items.py` +- `presentation/co4e/canvas_interaction_mixin.py` +- `tests/characterization/test_co4e_canvas_widget.py` +- `docs/architecture/co4e-split-map-canvas-widget.md` +- `docs/architecture/co4e-split-map-canvas-widget.json` +- `docs/architecture/co4e-refactor-run-report-canvas-widget.md` (chính file này) + +**Đã sửa:** +- `ui/co4e_canvas.py` — giữ lại làm shim tương thích ngược, xem mục 5. + +**Không thuộc lane này** (xuất hiện trong `git status --porcelain` chung của repo, do các lane khác — node-property, run-control, v.v. — đang chạy song song, liệt kê để tránh nhận vơ): `application/workflows/co4e_workflow_service.py`, `domain/workflows/run_record.py`, `presentation/co4e/agent_list_panel.py`, `presentation/co4e/canvas_geometry.py`, `presentation/co4e/co4e_tab.py`, `presentation/co4e/node_property_panel.py`, `presentation/co4e/node_property_actions_mixin.py`, `presentation/co4e/skills_list_panel.py`, `presentation/co4e/step_config_section.py`, `presentation/co4e/co4e_run_control_widget.py`, `ui/co4e_tab.py`, `ui/co4e_config_panel.py`, `tests/characterization/test_co4e_agent_panel.py`, `tests/characterization/test_co4e_run_manager_behavior.py`, `tests/characterization/test_co4e_skills_panel.py`, `tests/characterization/test_node_property_panel.py`, `tests/characterization/test_co4e_runs_page.py`, `tests/fakes/fake_co4e_workflow_service.py`, `tests/test_build_co4e_tab.py`, `tests/test_co4e_workflow_service.py`, `docs/architecture/co4e-split-map.md`, `docs/architecture/co4e-split-map.json`, `docs/architecture/co4e-split-map-node-property.md`, `docs/architecture/co4e-split-map-node-property.json`, `docs/architecture/co4e-split-map-run-control.md`, `docs/architecture/co4e-split-map-run-control.json`, `docs/architecture/co4e-refactor-run-report.md`, `docs/architecture/co4e-refactor-run-report-node-property.md`. + +--- + +## 3. Kết quả cổng ranh giới + +**ĐỎ (FAIL)** — theo kết quả Phase 5 đã chạy (`clean: false`). Chi tiết: + +- **13 vi phạm FORBIDDEN**: đều là các đường dẫn thuộc quyền sở hữu N1 (node-property, run-control) hoặc file dùng chung cấm sửa cho mọi lane — ví dụ `ui/co4e_tab.py`, `ui/co4e_config_panel.py`, `presentation/co4e/node_property_panel.py`, `node_property_actions_mixin.py`, `step_config_section.py`, `docs/architecture/co4e-split-map-node-property.*`, `co4e-refactor-run-report-node-property.md`, `co4e-split-map.md/json`, `co4e-refactor-run-report.md`, `co4e-split-map-run-control.*`. **Không cái nào trong số này do lane canvas-widget đụng tới trong lượt làm việc này.** +- **14 vi phạm OUT-OF-WHITELIST**: `application/workflows/co4e_workflow_service.py`, `domain/workflows/run_record.py`, `presentation/co4e/agent_list_panel.py`, `presentation/co4e/canvas_geometry.py`, `presentation/co4e/co4e_tab.py`, `presentation/co4e/skills_list_panel.py`, `tests/characterization/test_co4e_agent_panel.py`, `tests/characterization/test_co4e_canvas_geometry.py`, `tests/characterization/test_co4e_run_manager_behavior.py`, `tests/characterization/test_co4e_skills_panel.py`, `tests/characterization/test_node_property_panel.py`, `tests/fakes/fake_co4e_workflow_service.py`, `tests/test_build_co4e_tab.py`, `tests/test_co4e_workflow_service.py`, và mới phát sinh `tests/characterization/test_co4e_runs_page.py`. **Cũng không phải sản phẩm của lane canvas-widget** — đây là artefact của các lane khác đang chạy song song, cùng nằm trong `git status` chung của repo vì cổng chặn quét trạng thái toàn repo chứ không tách theo phiên. + +Đối chiếu với whitelist được cấp cho chính lane này (`tests/characterization/test_co4e_canvas_widget.py`, `presentation/co4e/co4e_canvas_widget.py`, `presentation/co4e/canvas_items.py`, `presentation/co4e/canvas_interaction_mixin.py`, `ui/co4e_canvas.py`, `docs/architecture/co4e-split-map-canvas-widget.md/json`): **không có mục nào trong 7 file này xuất hiện trong danh sách vi phạm** — cổng đỏ hoàn toàn do trạng thái git dùng chung của các lane khác chưa dọn/commit, không phải do vi phạm ranh giới của lane canvas-widget. + +--- + +## 4. Kết quả bước soát output (Phase Review) — 2 lượt + +**Không có phát hiện nào ở mức CHAN trong cả 2 lượt soát.** Cả hai đều verdict `DAT` (đạt), `repaired: false` (không cần sửa lại trong lúc soát). + +### Lượt 1 — subject: `tests/characterization/test_co4e_canvas_widget.py` (verdict: DAT) +- Mức CHAN: không có. +- Mức SUA: không có. +- Mức GHI_NHAN (4): + 1. `test_relayout_on_empty_canvas_is_a_safe_noop` (dòng 723-724): assert dựa trên giá trị hardcode `True` ngay sau khi gọi `relayout()` — chỉ là phép thử "không ném exception", không khoá được giá trị/hành vi cụ thể nào của `relayout()` trên canvas rỗng. Không phải lỗi, nhưng không phải lưới an toàn thật cho trường hợp này. + 2. Comment tại `test_zoom_in_clamps_at_max_after_7_steps_from_1_0` (dòng 686-696) lệch một đơn vị so với tính toán độc lập (chạm 3.0 ở lần áp dụng thứ 8, không phải thứ 7 như comment nói) — nhưng giá trị assert (mảng 20 phần tử) vẫn đúng 100% với hành vi thật, chỉ comment giải thích bị lệch. + 3. `ui/co4e_canvas.py` có 2 "equivalent mutant" phát hiện qua mutation-test: xoá điều kiện `src != target_id` trong `_finish_connect` và xoá guard `if source == target: return` trong `_make_edge` đều không làm test đỏ, vì các điểm gọi `_make_edge` đã tự lọc `source != target` từ trước — hai lớp bảo vệ trùng nhau. Không phải lỗi hành vi hiện tại, nhưng là điểm cần lưu ý cho người tách sau: nếu một lớp bảo vệ mất đi trong tương lai mà không có lớp kia, quirk "tự nối vào mình" sẽ mất hiệu lực mà test này không bắt được tại đúng điểm đó. + 4. Ghi nhận về git status: 2 file `docs/architecture/co4e-split-map-run-control.md/json` xuất hiện thêm giữa lúc soát — xác nhận là sản phẩm của một agent khác chạy song song (cùng mtime), không phải do lượt soát này gây ra; `ui/co4e_canvas.py` không đổi trạng thái và pytest 43/43 vẫn xanh sau khi khôi phục mutation. + +### Lượt 2 — subject: `presentation/co4e/co4e_canvas_widget.py` (verdict: DAT) +- Mức CHAN: không có. +- Mức SUA (1): `co4e_canvas_widget.py` dòng 75-89 (`Co4ECanvas.load`) — điểm chuyển từ domain (list Node/Edge) sang item hiển thị thiếu comment giải thích quirk "edge có source/target không nằm trong `self._nodes` bị âm thầm bỏ qua". Quirk có thật, kế thừa nguyên văn từ `ui/co4e_canvas.py` gốc (không phải lỗi mới do lần tách này gây ra — đã đối chứng bằng `git show HEAD`), nhưng theo yêu cầu B4 (bắt buộc có comment tại các điểm chuyển tầng DTO), cần bổ sung comment trong lượt sửa tiếp theo. +- Mức GHI_NHAN (4): + 1. Hai khối comment mâu thuẫn nhau trong `canvas_items.py` dòng 128-133 (`_NodeItem.paint`) về vị trí cổng (một khối nói "top-center/bottom-center", khối liền sau nói "left-center/right-center" — code thực tế vẽ left-center/right-center). Lỗi tồn tại sẵn trong bản gốc, được dời nguyên văn đúng kỷ luật B1 "không đổi", không phải lỗi mới. Cần dọn ở lượt sau. + 2. Docstring của 3 file (`co4e_canvas_widget.py`, `canvas_items.py`, `canvas_interaction_mixin.py`) dẫn số dòng cụ thể của `ui/co4e_canvas.py` (ví dụ "289-317", "701 dòng tổng") không khớp với `ui/co4e_canvas.py` tại git HEAD hiện tại (791 dòng, class `Co4ECanvas` bắt đầu ở dòng 379, không phải 289). Nội dung code đã được xác minh khớp 100% bằng AST diff độc lập — đây là vấn đề chất lượng tài liệu (số dòng tham chiếu một trạng thái trung gian chưa commit), không phải lỗi hành vi. + 3. Suite tổng đỏ 1 test (`test_no_ignored_source`) tại thời điểm soát, do file `tests/characterization/test_co4e_runs_page.py` (thuộc nhánh tách khác) chưa được `git add` — không liên quan 3 file thuộc phạm vi soát này, đã tự hết khi lane kia add file (khớp với mục 1 của báo cáo này). + 4. `docs/architecture/co4e-refactor-run-report-canvas-widget.md` chưa được tạo tại thời điểm soát — ghi nhận thiếu deliverable, không chặn. (Báo cáo này chính là file được yêu cầu tạo, viết trong lượt hiện tại.) + +--- + +## 5. Việc để lại cho lần sau + +- **`ui/co4e_canvas.py` vẫn còn chạy song song** với `presentation/co4e/co4e_canvas_widget.py` — hiện đóng vai trò shim/re-export để các chỗ import cũ (`from .co4e_canvas import Co4ECanvas, CO4E_MIME`) không vỡ. Cần dọn các nơi còn import theo đường cũ, chuyển sang import trực tiếp từ `presentation/co4e/co4e_canvas_widget.py`, rồi mới an toàn để rút gọn/xoá shim. +- **1 điểm SUA từ lượt soát 2 chưa được sửa**: bổ sung comment giải thích quirk bỏ-qua-edge-mồ-côi tại `presentation/co4e/co4e_canvas_widget.py` (hàm `load`, dòng 75-89) theo đúng yêu cầu B4. +- **2 GHI_NHAN không chặn nhưng nên dọn cùng đợt sau**: (a) comment mâu thuẫn vị trí cổng trong `canvas_items.py` dòng 128-133 (kế thừa từ bản gốc); (b) số dòng tham chiếu trong docstring của 3 file mới không khớp trạng thái HEAD hiện tại — cần cập nhật lại số dòng khi file được commit để người đọc sau đối chiếu lại được. +- `docs/architecture/co4e-split-map-canvas-widget.md/json` là input cho bước dọn shim `ui/co4e_canvas.py` ở lượt tiếp theo. +- Cổng ranh giới hiện đang đỏ do trạng thái git dùng chung của nhiều lane chưa commit/dọn — cần các lane liên quan (node-property, run-control, v.v.) tự commit hoặc dọn phần của mình để cổng có thể xanh trở lại cho toàn repo; lane canvas-widget không có vi phạm nào trong whitelist của chính nó (xem mục 3). + +## 6. Cần báo người khác trong team + +- Không có phát hiện mới nằm ngoài phạm vi lane này cần báo riêng (không có kiểu phát hiện như vụ `.gitignore` nuốt `infrastructure/secrets/` trước đây). +- Đáng lưu ý (không cần hành động thêm, chỉ để các lane khác biết): trong lúc đo baseline lần 1 của lượt này, `test_no_ignored_source` đỏ thoáng qua vì lane run-control (`tests/characterization/test_co4e_runs_page.py`, `presentation/co4e/co4e_run_control_widget.py`) chưa kịp `git add` hai file mới của họ. Tự hết ở lần đo thứ 2 sau khi họ add xong. Gợi ý: các lane nên `git add` sớm sau khi tạo file mới để tránh gate/test đỏ giả khi nhiều phiên Claude chạy song song trên cùng thư mục. diff --git a/docs/architecture/co4e-refactor-run-report-chat-view.md b/docs/architecture/co4e-refactor-run-report-chat-view.md new file mode 100644 index 0000000..4cff397 --- /dev/null +++ b/docs/architecture/co4e-refactor-run-report-chat-view.md @@ -0,0 +1,156 @@ +# Báo cáo refactor — Chat view / Composer (widget cuối) — làn N3 Co4E Studio + +- **Ngày:** 2026-08-25 +- **Người:** Lâm (hiephv3@fpt.com) +- **Nhánh:** `gamma/refactor` +- **Phạm vi:** trích xuất `_ChatInput`, `_skill_names`, `_agent_names`, `_directive_token` + và phần dựng UI của `ChatPanel` (từ `_build_chat` cũ) trong `ui/co4e_tab.py` sang + `presentation/co4e/co4e_chat_view.py`. + +--- + +## 1. Số test thay đổi thế nào so với baseline + +Lệnh đo (chạy lại đúng lệnh baseline ngay trước khi viết báo cáo này): + +``` +.venv/Scripts/python.exe -m pytest tests -q --tb=no -rA --continue-on-collection-errors +``` + +Kết quả vừa đo: + +``` +347 passed, 1 skipped in 8.10s +``` + +So với baseline được giao (Phase 0): `346 passed, 0 failed, 0 collection_errors, 1 skipped`. + +| | Trước (Phase 0) | Sau (vừa đo lại) | +|---|---|---| +| passed | 346 | 347 | +| failed | 0 | 0 | +| collection_errors | 0 | 0 | +| skipped | 1 (giữ nguyên, lý do đã biết — thứ tự import `CONFIG_DIR` giữa các file test, không liên quan chat view) | 1 (cùng lý do) | + +**+1 passed** đúng bằng đúng 1 test mới `tests/characterization/test_co4e_chat_view.py` +được thêm trong đợt này. Không có test fail mới, không có collection error mới → +**không hồi quy**. + +- Lỗi MỐC CŨ có từ trước (nợ của làn khác): **không có** — 0 collection error, 0 failed + ở cả trước và sau. +- Flaky đã biết (`tests/test_atomic_json.py::test_ghi_de_nhieu_lan_van_dung`, + `PermissionError [WinError 5]` khi Windows giữ khoá file tạm): **không xuất hiện** + trong lần đo cuối cùng này (347 passed, 0 failed). Trong lượt soát trước đó nó có + xuất hiện đúng 1 lần trên 2 lần chạy (`1 failed, 346 passed, 1 skipped`), rồi lần + chạy kế tiếp lại xanh (`347 passed, 1 skipped`) — đúng đặc điểm flaky đã biết, không + quy cho đợt trích xuất này. + +## 2. File đã tạo, file đã sửa + +Theo `git status --porcelain` (đối chiếu với whitelist được cấp cho lượt chat-view): + +**Tạo mới (thuộc lượt này):** +- `presentation/co4e/co4e_chat_view.py` — file production mới (258 dòng, ≤ 400 dòng, + chỉ import PySide6.QtCore/QtWidgets, không đụng domain/application). +- `tests/characterization/test_co4e_chat_view.py` — test đặc trưng hoá hành vi cũ. +- `docs/architecture/co4e-split-map-chat-view.md` +- `docs/architecture/co4e-split-map-chat-view.json` +- `docs/architecture/co4e-refactor-run-report-chat-view.md` — chính file báo cáo này + (trước lượt này file chưa tồn tại — đây là khoảng thiếu mà bước soát đã ghi nhận, + nay bù lại). + +**Sửa (thuộc lượt này):** +- `ui/co4e_tab.py` — dây lại để dùng `ChatPanel`/`_ChatInput` từ module mới thay vì + định nghĩa tại chỗ. + +**Các mục khác trong `git status` (canvas widget, node property, run control, agent +panel, run manager, v.v.) không thuộc lượt chat-view** — đó là dấu vết của các làn/ +phiên khác đang chạy song song trên cùng thư mục làm việc (repo này có nhiều phiên +Claude chạy đồng thời). Không đụng, không sửa trong lượt này. + +## 3. Cổng chặn (Phase 5) + +**Kết quả: ĐỎ** (`"clean": false`). + +Tuy nhiên toàn bộ vi phạm liệt kê **không thuộc phần lượt chat-view đã viết ra** — kiểm +tra riêng 5 đường dẫn thuộc whitelist của lượt này +(`presentation/co4e/co4e_chat_view.py`, `tests/characterization/test_co4e_chat_view.py`, +`docs/architecture/co4e-split-map-chat-view.md`, `.json`, `ui/co4e_tab.py`): **không có +đường dẫn nào trong 5 file này xuất hiện trong danh sách `violations`.** + +Danh sách vi phạm thật (đỏ) đến từ file của các làn khác đang tồn tại chung trong working +tree (không do lượt chat-view tạo ra): + +- `FORBIDDEN` (khớp `forbidden_paths` của N1): `presentation/co4e/canvas_interaction_mixin.py`, + `canvas_items.py`, `co4e_canvas_widget.py`, `co4e_run_control_widget.py`, + `node_property_actions_mixin.py`, `node_property_panel.py`, `step_config_section.py`, + `ui/co4e_canvas.py`, `ui/co4e_config_panel.py`, cùng các `docs/architecture/co4e-split-map*.md/json` + và `co4e-refactor-run-report*.md` khác của N1. +- `OUTSIDE_WHITELIST` (file mới không khớp `allowed_write_globs` của *lượt này*): + `application/workflows/co4e_workflow_service.py`, `domain/workflows/run_record.py`, + `presentation/co4e/agent_list_panel.py`, `canvas_geometry.py`, + `presentation/co4e/co4e_tab.py` (khác `ui/co4e_tab.py` được phép), `skills_list_panel.py`, + và các test/fakes tương ứng (`test_co4e_agent_panel.py`, `test_co4e_canvas_geometry.py`, + `test_co4e_canvas_widget.py`, `test_co4e_run_manager_behavior.py`, `test_co4e_runs_page.py`, + `test_co4e_skills_panel.py`, `test_node_property_panel.py`, `fake_co4e_workflow_service.py`, + `test_build_co4e_tab.py`, `test_co4e_workflow_service.py`). + +Kết luận: cổng chặn báo đỏ ở mức **toàn working tree**, không phải đỏ do lượt +chat-view — vì cổng chặn quét nguyên `git status` chung, còn nhiều làn/phiên khác đang +ghi đè cùng thư mục. Phần việc riêng của lượt chat-view (5 đường dẫn whitelist) **sạch**. + +## 4. Bước soát output — 2 lượt + +Không có phát hiện ở mức **CHAN** (chặn) trong bất kỳ lượt soát nào — cả hai lượt đều +có `verdict: "DAT"` (đạt). + +**Lượt 1 — soát `tests/characterization/test_co4e_chat_view.py`:** verdict **DAT**. +Một phát hiện mức `SUA`: +- Dòng 193: `assert ci._popup.width() == max(280, ci.width())` — assertion rỗng nghĩa + cho riêng claim "280" vì `ci.width()` mặc định (chưa show/setFixedWidth) là 640 trong + môi trường test, luôn thắng trong `max()` bất kể 280 đổi thành gì < 640. Xác nhận bằng + mutation thật (280→300 trong `ui/co4e_tab.py`): test vẫn xanh (`1 passed in 2.01s`). + 23 case còn lại trong file đều bắt được mutation tương ứng (11/12 hành vi bị làm hỏng + → test đỏ đúng như kỳ vọng). + +**Lượt 2 — soát `presentation/co4e/co4e_chat_view.py`:** verdict **DAT**. Hai phát hiện +mức `SUA`, một mức `GHI_NHAN`: +- `SUA`: `docs/architecture/co4e-refactor-run-report-chat-view.md` (đúng file này) chưa + tồn tại tại thời điểm soát — thiếu deliverable bắt buộc của quy trình. **Đã bù lại + bằng chính báo cáo này.** +- `SUA`: docstring module (dòng 6-7, 15-18) trích sai số dòng gốc trong `ui/co4e_tab.py` + (lệch 3-35 dòng, ví dụ `_build_chat` ghi "1030-1093" nhưng thật là "1065-1128" theo + `git show HEAD`). Không ảnh hưởng hành vi — thân hàm đã được đối chiếu bằng + `ast.get_source_segment` + `difflib` và **IDENTICAL** 100% với bản gốc. Đây là lỗi + trích dẫn tài liệu, chưa sửa trong lượt viết báo cáo này (ngoài phạm vi được giao cho + lượt này — chỉ viết báo cáo, không sửa code sản xuất). +- `GHI_NHAN`: hai file `docs/architecture/co4e-refactor-run-report-node-property.md` và + `co4e-refactor-run-report-run-control.md` (thuộc `forbidden_paths` của lượt chat-view) + có thay đổi/tồn tại — nhưng nội dung xác nhận thuộc lane khác (node-property, run-control), + không phải do lượt chat-view đụng vào. Không quy lỗi cho lượt này. + +Ngoài ra, bước soát đã tự chạy lại bộ test 2 lần độc lập để loại trừ flaky trước khi kết +luận: lần 1 gặp `1 failed` (đúng flaky `test_atomic_json` đã biết), lần 2 `347 passed, +1 skipped, 0 failed` — nhất quán với con số ở mục 1. + +## 5. Việc để lại cho lần chạy sau / cần báo người khác + +**Để lại cho lần sau (trong phạm vi lượt chat-view, chưa làm ở lượt viết báo cáo này):** +- Sửa docstring module trong `presentation/co4e/co4e_chat_view.py` (dòng 6-7, 15-18) để + khớp đúng số dòng thật trong `ui/co4e_tab.py` (HEAD): `_skill_names` 60-64, + `_agent_names` 67-70, `_directive_token` 121-133, `_ChatInput` 136-225, `_build_chat` + 1065-1128 — hiện ghi sai (63-73, 124-228, 1030-1093). +- Làm chặt lại assertion popup-width-floor tại `tests/characterization/test_co4e_chat_view.py:193` + (claim "280" hiện không được khoá thật vì `ci.width()` mặc định 640 luôn thắng trong + `max()`) — cần set `ci` về chiều rộng nhỏ hơn 280 trước khi assert, hoặc mock riêng, để + test thực sự khoá hằng số 280. +- `ui/co4e_tab.py` vẫn còn nhiều phần khác chưa tách (không thuộc phạm vi widget + chat/composer) — các widget khác đã có báo cáo riêng của N1 + (`canvas-widget`, `node-property`, `run-control`). + +**Cần báo người khác trong team:** không có phát hiện mới nào ngoài phạm vi làn này cần +escalate ở lượt này. Ghi nhận (không phải lỗi mới, chỉ là quan sát): repo đang có nhiều +phiên Claude/nhiều làn chạy song song trên cùng một working tree, khiến cổng chặn của +lượt chat-view báo đỏ ở mức toàn cục do file của các làn khác — điều này không phải do +lượt chat-view gây ra và không cần hành động thêm từ N3, nhưng đội điều phối nên biết để +không hiểu nhầm là lượt này làm vỡ ranh giới của N1. diff --git a/docs/architecture/co4e-refactor-run-report-node-property.md b/docs/architecture/co4e-refactor-run-report-node-property.md new file mode 100644 index 0000000..1adbcd8 --- /dev/null +++ b/docs/architecture/co4e-refactor-run-report-node-property.md @@ -0,0 +1,226 @@ +# Báo cáo chạy — tách `StepConfigPanel` khỏi `ui/co4e_config_panel.py` + +- **Ngày:** 2026-08-24 +- **Người:** hiephv3@fpt.com +- **Nhánh:** gamma/refactor +- **Làn:** N3 — Co4E Studio, phạm vi `node_property_panel` + +Ghi chú: repo này có nhiều phiên Claude chạy song song trên cùng một thư mục +làm việc. Báo cáo dưới đây chỉ trả lời 5 câu bắt buộc, không lan sang phần đã +viết ở các lượt trước (chi tiết cắt-dán từng dòng xem +`docs/architecture/co4e-split-map-node-property.md`/`.json`). + +## 1. Số test thay đổi thế nào so với baseline + +Lệnh đo (baseline Phase 0, chạy trước khi làn này bắt đầu): + +``` +.venv/Scripts/python.exe -m pytest tests -q --tb=no -rA --continue-on-collection-errors +279 passed, 1 skipped +``` + +Lệnh đo lại (chạy ngay bây giờ, sau khi làn này đã xong): + +``` +$ .venv/Scripts/python.exe -m pytest tests -q --tb=no -rA --continue-on-collection-errors +330 passed, 1 skipped in 10.15s +``` + +| | passed | failed | collection_errors | skipped | +|---|---|---|---|---| +| Trước (Phase 0) | 279 | 0 | 0 | 1 | +| Sau (bây giờ) | 330 | 0 | 0 | 1 | + +- **Không có test fail nào**, mới hay cũ. `passed` sau ≥ passed trước + (330 ≥ 279) → không hồi quy theo tiêu chí so lệch. +- Chênh lệch +51 **không** đến từ riêng làn này. Làn này chỉ thêm đúng 1 test + mới (`tests/characterization/test_node_property_panel.py`). +50 còn lại đến + từ các làn song song khác đã nhập vào cùng thư mục làm việc trong lúc làn + này chạy (`test_co4e_agent_panel.py`, `test_co4e_canvas_geometry.py`, + `test_co4e_canvas_widget.py`, `test_co4e_skills_panel.py`, + `test_build_co4e_tab.py`, `test_co4e_workflow_service.py`, ...) — thấy rõ + trong `git status --porcelain` ở câu 2, không phải việc của làn N3. +- **1 skip** là mốc cũ có từ trước, không phải do lượt này gây ra: + `tests/characterization/test_co4e_run_manager_behavior.py:140` — tự skip + vì `cowork_local.config` bị file test khác import với `HOME` thật trước nó + trong cùng phiên pytest (giới hạn đã biết, ghi rõ trong docstring đầu file + đó, không liên quan `StepConfigPanel`). +- Test flaky đã biết của repo + (`tests/test_atomic_json.py::test_ghi_de_nhieu_lan_van_dung`, do + `os.replace()` gặp khoá file tạm trên Windows) **không xuất hiện** trong + lần chạy này — không có gì để báo thêm về nó. +- Chưa cần chạy lại lần hai để xác nhận vì không có test nào đỏ ở cả hai lần + đo (Phase 0 và bây giờ) — không có ca nghi flaky cần phân xử. + +## 2. File đã tạo, file đã sửa + +`git status --porcelain` (nguyên văn, chạy ngay lúc viết báo cáo): + +``` +AM application/workflows/co4e_workflow_service.py +A docs/architecture/co4e-refactor-run-report-node-property.md +A docs/architecture/co4e-split-map-node-property.json +A docs/architecture/co4e-split-map-node-property.md +A domain/workflows/run_record.py +A presentation/co4e/agent_list_panel.py +A presentation/co4e/canvas_geometry.py +A presentation/co4e/co4e_tab.py +A presentation/co4e/node_property_actions_mixin.py +A presentation/co4e/node_property_panel.py +A presentation/co4e/skills_list_panel.py +A presentation/co4e/step_config_section.py +A tests/characterization/test_co4e_agent_panel.py +AM tests/characterization/test_co4e_canvas_geometry.py +A tests/characterization/test_co4e_canvas_widget.py +AM tests/characterization/test_co4e_run_manager_behavior.py +AM tests/characterization/test_co4e_skills_panel.py +A tests/characterization/test_node_property_panel.py +A tests/fakes/fake_co4e_workflow_service.py +A tests/test_build_co4e_tab.py +AM tests/test_co4e_workflow_service.py + M ui/co4e_canvas.py +M ui/co4e_config_panel.py + M ui/co4e_tab.py +?? .codegraph/ +?? cowork_local +?? docs/architecture/co4e-refactor-run-report.md +?? docs/architecture/co4e-split-map.json +?? docs/architecture/co4e-split-map.md +?? run_app.bat +?? stop_running.ps1 +``` + +**Của đúng làn N3 (`node_property_panel`) — khớp danh sách đường dẫn được +cấp quyền:** + +- Mới: `presentation/co4e/node_property_panel.py` (293 dòng), + `presentation/co4e/node_property_actions_mixin.py` (202 dòng), + `presentation/co4e/step_config_section.py` (134 dòng), + `tests/characterization/test_node_property_panel.py`, + `docs/architecture/co4e-split-map-node-property.md`, + `docs/architecture/co4e-split-map-node-property.json`, + `docs/architecture/co4e-refactor-run-report-node-property.md` (chính file + này). +- Sửa: `ui/co4e_config_panel.py` (528 dòng → 14 dòng, chỉ còn re-export + `StepConfigPanel`). +- Cả 3 file production mới đều ≤ 400 dòng (293/202/134). + +**Không thuộc làn N3 — xuất hiện trong `git status` vì có phiên khác đang +chạy song song trên cùng thư mục, làn này không đụng tới:** +`application/workflows/co4e_workflow_service.py`, +`domain/workflows/run_record.py`, `presentation/co4e/agent_list_panel.py`, +`presentation/co4e/canvas_geometry.py`, `presentation/co4e/co4e_tab.py`, +`presentation/co4e/skills_list_panel.py`, +`tests/characterization/test_co4e_agent_panel.py`, +`tests/characterization/test_co4e_canvas_geometry.py`, +`tests/characterization/test_co4e_canvas_widget.py`, +`tests/characterization/test_co4e_run_manager_behavior.py`, +`tests/characterization/test_co4e_skills_panel.py`, +`tests/fakes/fake_co4e_workflow_service.py`, `tests/test_build_co4e_tab.py`, +`tests/test_co4e_workflow_service.py`, `ui/co4e_canvas.py`, +`ui/co4e_tab.py`, cùng các file untracked +`docs/architecture/co4e-split-map.md`/`.json`, +`docs/architecture/co4e-refactor-run-report.md`, `.codegraph/`, +`cowork_local`, `run_app.bat`, `stop_running.ps1`. + +## 3. Cổng ranh giới: xanh hay đỏ + +**Đỏ** (`clean: false`), nhưng **không phải vì làn N3 tự ý sửa các file cấm** +— tất cả vi phạm đều là file thuộc phạm vi làn khác (N1) hoặc làn song song +khác đang có mặt trong cùng thư mục làm việc tại thời điểm chạy cổng chặn: + +- **FORBIDDEN** (đúng danh sách cấm tuyệt đối của N3, thuộc làn N1): + `ui/co4e_tab.py` (M), `ui/co4e_canvas.py` (M), + `docs/architecture/co4e-split-map.md` (mới), `docs/architecture/co4e-split-map.json` (mới), + `docs/architecture/co4e-refactor-run-report.md` (mới). +- **OUTSIDE-WHITELIST** (không khớp `allowed_write_globs` của N3): + `application/workflows/co4e_workflow_service.py`, + `domain/workflows/run_record.py`, + `presentation/co4e/agent_list_panel.py`, + `presentation/co4e/canvas_geometry.py`, `presentation/co4e/co4e_tab.py`, + `presentation/co4e/skills_list_panel.py`, + `tests/characterization/test_co4e_agent_panel.py`, + `tests/characterization/test_co4e_canvas_geometry.py`, + `tests/characterization/test_co4e_canvas_widget.py`, + `tests/characterization/test_co4e_run_manager_behavior.py`, + `tests/characterization/test_co4e_skills_panel.py`, + `tests/fakes/fake_co4e_workflow_service.py`, `tests/test_build_co4e_tab.py`, + `tests/test_co4e_workflow_service.py`. +- `loc_over_cap`: rỗng — không file nào của làn N3 vượt 400 dòng. +- `pyside_leaks`: rỗng — không có import PySide6/PyQt trong + `domain/`/`application/` (kiểm bằng AST parse, không phải grep). + +Kết luận: 8 file đúng phạm vi được cấp cho làn N3 (danh sách 400-file ở đầu +prompt) đều nằm gọn trong whitelist, không file nào của làn N3 chạm vào danh +sách cấm. Cổng đỏ là do **trạng thái chung của working tree** (nhiều làn ghi +song song), không phải hồi quy do thay đổi của làn này gây ra. Người quyết +định commit cần biết: nếu commit y nguyên `git status` hiện tại, sẽ commit +luôn cả các thay đổi của những làn khác (N1 và các làn Co4E khác) — cần +tách bằng `git add` đúng danh sách 8 file của N3 trước khi commit, không +`git add -A`. + +## 4. Bước soát output — 2 lượt, tách riêng theo mức `CHAN` + +**Không lượt soát nào phát hiện mức `CHAN`.** (Mức `CHAN` = test không bắt +được lỗi, hoặc code bị viết lại thay vì dời — không có trường hợp nào như +vậy trong cả 2 lượt.) + +- **Lượt 1 — chủ thể `tests/characterization/test_node_property_panel.py`, + verdict: ĐẠT.** + 1 phát hiện mức **SUA** (không phải `CHAN`): file test mới chưa + `git add`, nên khi chạy full suite làm đỏ + `tests/test_no_ignored_source.py::test_khong_file_py_nao_bi_bo_quen_chua_theo_doi`. + Không phải lỗi logic của test — chỉ là bước staging còn thiếu, đã tự sửa + bằng cách stage file (đã staged, xem `git status` ở câu 2: `A + tests/characterization/test_node_property_panel.py`). + Xác nhận qua bite-test: phá 14/14 hành vi riêng của + `ui/co4e_config_panel.py` (bản gốc, trước khi tách) đều bị test bắt được, + đã khôi phục lại nguyên trạng sau khi thử. + +- **Lượt 2 — chủ thể `presentation/co4e/node_property_panel.py`, verdict: + ĐẠT.** + 1 phát hiện mức **GHI_NHẬN** (không phải `CHAN`, không phải `SUA`): số + test trong báo cáo cũ (`287 passed, 1 skipped`) lệch với hiện trạng lúc + soát (`330 passed, 1 skipped`) — do các làn song song khác nhập test mới + vào giữa lúc viết báo cáo và lúc soát, không phải lỗi của việc tách + `StepConfigPanel`. Báo cáo này (bản viết lại) đã cập nhật đúng số thật + 330/1 ở mục 1. + Xác nhận thân hàm `__init__`/`load_step`/`clear_step`/`_on_edit` trong + `node_property_panel.py` **giống byte-for-byte** (240/240 dòng) với bản + gốc `ui/co4e_config_panel.py` tại HEAD; 8 method trong + `node_property_actions_mixin.py` chỉ khác đúng độ sâu import + (`..core` → `...core`, đúng do file dời sâu thêm 1 cấp thư mục); bite-test + phá 5 hành vi riêng trong 2 file production mới đều bị test bắt được, đã + khôi phục nguyên trạng. `tools/check_co4e.py` (cổng kiểm soát riêng): giữ + nguyên `27/27` control cũ. + +## 5. Việc để lại cho lần sau / cần báo người khác + +**Để lại cho lần sau (thuộc phạm vi làn N3 hoặc làn kế tiếp có liên quan):** + +1. `docs/architecture/co4e-split-map.md` (làn N1, không được sửa ở đây) vẫn + liệt kê `node_property_panel.py` như một đích còn dở của việc tách + `ui/co4e_tab.py`/`ui/co4e_canvas.py` qua Signal + `node_selected`/`node_activated`. Sau lượt này `StepConfigPanel` đã có nơi + ở thật (`presentation/co4e/node_property_panel.py`); làn phụ trách tách + `ui/co4e_tab.py` có thể import thẳng từ đó thay vì qua + `ui/co4e_config_panel.py`, nhưng đó là quyết định của làn N1, không tự + đổi ở đây. +2. `_ai_draft`/`_load_models` trong `node_property_actions_mixin.py` vẫn + dùng `AgentWorker`/`QThread` thật (chưa tách phần logic thuần khỏi UI). + Nếu có lượt sau muốn đẩy xuống `application/`, cần định nghĩa `Protocol` + cho runner tiêm qua constructor — ngoài phạm vi cắt-dán của lượt này. +3. `ui/co4e_config_panel.py` (14 dòng) vẫn còn sống song song làm lớp + re-export — chưa xoá, vì `ui/co4e_tab.py` (thuộc N1) còn import từ đó. + Xoá file này là quyết định của người sở hữu `ui/co4e_tab.py`. + +**Cần báo người khác trong team:** + +Không có phát hiện mới ngoài phạm vi làn này (không có kiểu phát hiện như +tiền lệ `.gitignore`/`secrets/` nêu trong hướng dẫn). Điểm duy nhất đáng nhắc +lại — không phải phát hiện mới mà là nhắc để tránh hiểu nhầm khi đọc mục 3: +cổng ranh giới của làn N3 báo đỏ hoàn toàn do có nhiều phiên làm việc song +song ghi vào cùng thư mục (`ui/co4e_tab.py`, `ui/co4e_canvas.py`, +`presentation/co4e/agent_list_panel.py`, v.v. — thuộc N1 và các làn Co4E +khác), không phải do thay đổi của làn N3. Ai gộp nhánh cần tách commit theo +đúng danh sách 8 file ở mục 2/3, không gộp `git add -A`. diff --git a/docs/architecture/co4e-refactor-run-report-run-control.md b/docs/architecture/co4e-refactor-run-report-run-control.md new file mode 100644 index 0000000..1d36602 --- /dev/null +++ b/docs/architecture/co4e-refactor-run-report-run-control.md @@ -0,0 +1,149 @@ +# Báo cáo refactor — Flow Status (Runs page) — làn N3 Co4E Studio + +- **Ngày:** 2026-08-25 +- **Người:** Lâm (N3 — Co4E Studio), hiephv3@fpt.com +- **Nhánh:** `gamma/refactor` +- **Phạm vi cho phép ghi (whitelist của làn này):** + `tests/characterization/test_co4e_runs_page.py`, + `presentation/co4e/co4e_run_control_widget.py`, + `docs/architecture/co4e-split-map-run-control.md`, + `docs/architecture/co4e-split-map-run-control.json`, + `ui/co4e_tab.py`, + `docs/architecture/co4e-refactor-run-report-run-control.md` + +--- + +## 1. Số test thay đổi thế nào so với baseline + +Lệnh đo (chạy lại đúng nguyên văn): + +``` +.venv/Scripts/python.exe -m pytest tests -q --tb=no -rA --continue-on-collection-errors +``` + +| Mốc | passed | failed | collection_errors | skipped | +|---|---|---|---|---| +| Baseline (Phase 0) | 323 | 0 | 0 | 1 | +| Sau lượt này (đo lại vừa xong) | 346 | 0 | 0 | 1 | + +Kết quả đo lại, 15 dòng cuối nguyên văn: + +``` +PASSED tests/test_settings_facade.py::test_provider_doc_duoc_ba_truong +PASSED tests/test_settings_facade.py::test_ollama_khong_can_khoa_van_tinh_la_da_cau_hinh +PASSED tests/test_settings_facade.py::test_thieu_model_thi_chua_cau_hinh +PASSED tests/test_settings_facade.py::test_gia_tri_None_tra_ve_mac_dinh_chu_khong_None +PASSED tests/test_settings_facade.py::test_routing_kieu_du_lieu_dung +PASSED tests/test_settings_facade.py::test_tat_dinh_tuyen +PASSED tests/test_settings_facade.py::test_sua_qua_khung_nhin_la_sua_vao_dict_that +PASSED tests/test_settings_facade.py::test_raw_de_khong_ai_bi_ket +PASSED tests/test_settings_facade.py::test_security_mac_dinh_la_bat +PASSED tests/test_settings_facade.py::test_settings_noi_vao_repo +PASSED tests/test_settings_facade.py::test_doi_provider_thi_khung_nhin_theo_ngay +SKIPPED [1] tests\characterization\test_co4e_run_manager_behavior.py:140: cowork_local.config da bi mot file test khac import voi HOME that TRUOC file nay trong cung phien pytest (thu tu collect) -- CONFIG_DIR=WindowsPath('C:/Users/LamHV7/.cowork_local') khong con nam trong sandbox cua file nay. Day la gioi han da biet (xem docstring dau file), KHONG phai mat an toan du lieu: moi test hook trong file nay tu va thang Co4ERunManager._history_path (doc lap voi CONFIG_DIR) nen khong test nao trong file thuc su cham vao lich su run that. +346 passed, 1 skipped in 25.78s +``` + +Nhận định: + +- `passed` tăng 323 → 346 (+23), đúng bằng 23 test mới trong `tests/characterization/test_co4e_runs_page.py` (đã được xác nhận `23 passed` khi chạy riêng file này ở bước Phase Review). Không có test cũ nào bị mất. +- `failed`: 0 ở cả hai mốc — **không có test fail mới**. Không có hồi quy theo tiêu chí "không fail mới ngoài danh sách baseline". +- `collection_errors`: 0 ở cả hai mốc — không tăng. +- 1 skip — **giữ nguyên từ baseline**, là giới hạn đã biết từ trước (thứ tự collect ảnh hưởng `CONFIG_DIR` trong `test_co4e_run_manager_behavior.py`), không phải do lượt này gây ra. +- Test flaky đã biết (`tests/test_atomic_json.py::test_ghi_de_nhieu_lan_van_dung`) — không xuất hiện trong danh sách fail ở cả hai lần chạy toàn bộ suite được ghi trong Phase Review (346 passed, 1 skipped cả hai lần) và không xuất hiện ở lần đo lại vừa rồi. Không có gì để báo về test này trong lượt này. + +**Kết luận:** không có hồi quy. + +--- + +## 2. File đã tạo, file đã sửa + +Theo `git status --porcelain` (đo lại tại thời điểm viết báo cáo này) và đối chiếu whitelist của làn: + +**Trong whitelist của làn này (run-control) — đã có mặt đầy đủ, cả 5 mục:** +- Tạo mới, đã `git add` (trạng thái `A`): `presentation/co4e/co4e_run_control_widget.py`, `tests/characterization/test_co4e_runs_page.py` +- Tạo mới, chưa `git add` (trạng thái `??`): `docs/architecture/co4e-split-map-run-control.md`, `docs/architecture/co4e-split-map-run-control.json` +- Sửa, chưa stage (trạng thái ` M`): `ui/co4e_tab.py` +- (file báo cáo này, `docs/architecture/co4e-refactor-run-report-run-control.md`, do lượt này vừa ghi — chưa `git add` tại thời điểm viết) + +**Ngoài whitelist của làn này (thuộc làn khác/song song, KHÔNG do lượt này tạo ra — liệt kê để minh bạch trạng thái thư mục làm việc, không phải việc của làn này):** +`application/workflows/co4e_workflow_service.py`, `domain/workflows/run_record.py`, +`presentation/co4e/agent_list_panel.py`, `presentation/co4e/canvas_geometry.py`, +`presentation/co4e/canvas_interaction_mixin.py`, `presentation/co4e/canvas_items.py`, +`presentation/co4e/co4e_canvas_widget.py`, `presentation/co4e/co4e_tab.py`, +`presentation/co4e/node_property_actions_mixin.py`, `presentation/co4e/node_property_panel.py`, +`presentation/co4e/skills_list_panel.py`, `presentation/co4e/step_config_section.py`, +`tests/characterization/test_co4e_agent_panel.py`, `tests/characterization/test_co4e_canvas_geometry.py`, +`tests/characterization/test_co4e_canvas_widget.py`, `tests/characterization/test_co4e_run_manager_behavior.py`, +`tests/characterization/test_co4e_skills_panel.py`, `tests/characterization/test_node_property_panel.py`, +`tests/fakes/fake_co4e_workflow_service.py`, `tests/test_build_co4e_tab.py`, `tests/test_co4e_workflow_service.py`, +`ui/co4e_canvas.py`, `ui/co4e_config_panel.py`, +`docs/architecture/co4e-refactor-run-report-node-property.md`, `docs/architecture/co4e-split-map-node-property.json`, +`docs/architecture/co4e-split-map-node-property.md`, `docs/architecture/co4e-refactor-run-report-canvas-widget.md`, +`docs/architecture/co4e-refactor-run-report.md`, `docs/architecture/co4e-split-map-canvas-widget.json`, +`docs/architecture/co4e-split-map-canvas-widget.md`, `docs/architecture/co4e-split-map.json`, +`docs/architecture/co4e-split-map.md`, +và các mục không do agent tạo: `.codegraph/`, `cowork_local` (file rỗng có sẵn), `run_app.bat`, `stop_running.ps1`. + +Lượt này **không đụng** đến bất kỳ file nào trong danh sách "TUYỆT ĐỐI KHÔNG Edit/Write". + +--- + +## 3. Cổng chặn (boundary gate) — xanh hay đỏ + +**ĐỎ** — kết quả Phase 5 do hệ thống chấm gửi kèm ghi `"clean": false`, với các vi phạm sau: + +- **Vi phạm nặng (forbidden_paths của N1 bị đụng):** `ui/co4e_canvas.py`, `ui/co4e_config_panel.py`, + `presentation/co4e/co4e_canvas_widget.py`, `presentation/co4e/canvas_items.py`, + `presentation/co4e/canvas_interaction_mixin.py`, `presentation/co4e/node_property_panel.py`, + `presentation/co4e/node_property_actions_mixin.py`, `presentation/co4e/step_config_section.py`, + `docs/architecture/co4e-split-map.md`, `docs/architecture/co4e-split-map.json`, + `docs/architecture/co4e-refactor-run-report.md`, `docs/architecture/co4e-refactor-run-report-node-property.md`, + `docs/architecture/co4e-split-map-node-property.md`, `docs/architecture/co4e-split-map-node-property.json`. +- **Ngoài whitelist (allowed_write_globs) của làn run-control:** `application/workflows/co4e_workflow_service.py`, + `domain/workflows/run_record.py`, `presentation/co4e/agent_list_panel.py`, `presentation/co4e/canvas_geometry.py`, + `presentation/co4e/co4e_tab.py` (lưu ý: khác `ui/co4e_tab.py` đang được whitelist), + `presentation/co4e/skills_list_panel.py`, và các file test/tài liệu liên quan (danh sách đầy đủ ở mục 2). + +**Quan trọng:** Đối chiếu với timestamp (`co4e-refactor-run-report-node-property.md` sửa lần cuối 24/08 21:33, còn `presentation/co4e/co4e_run_control_widget.py` — sản phẩm của lượt này — có mtime 25/08 10:00, cách nhau ~13 tiếng) và nội dung diff của các file vi phạm nói về canvas/node-property (không liên quan runs page), kết luận: **các vi phạm trên là dirty state sót lại từ các làn khác (N1 — canvas widget, node-property) chạy song song trên cùng thư mục làm việc, không phải do lượt run-control này tạo ra hay sửa.** Lượt này chỉ tạo/sửa đúng các file trong whitelist của mình (mục 2). + +Cổng chặn không phân biệt được "ai gây ra" — nó chỉ nhìn `git status` tại thời điểm chấm, nên bị đỏ do cộng dồn trạng thái của nhiều làn cùng lúc. Đây là hạn chế đã biết của việc nhiều phiên Claude làm việc song song trên cùng repo (xem mục 5). + +--- + +## 4. Bước soát output (Phase Review) — 2 lượt, mỗi mức CHAN nêu riêng + +Có 2 lượt soát, không có mức `CHAN` nào ở cả hai lượt (cả hai đều **ĐẠT**). + +**Lượt 1 — `tests/characterization/test_co4e_runs_page.py`:** verdict **DAT**, `repaired: true`. +Không có mức CHAN. Có 1 ghi nhận mức `GHI_NHAN` (không chặn): khi chạy full-suite, file này còn ở trạng thái untracked (`??`) nên `tests/test_no_ignored_source.py::test_khong_file_py_nao_bi_bo_quen_chua_theo_doi` báo 1 failed — đây là lỗi hygiene do file chưa `git add`, không phải lỗi hành vi của bản thân test. (Ghi chú: theo `git status --porcelain` đo lại tại thời điểm viết báo cáo này, file đã chuyển sang trạng thái `A` — đã được `git add` — nên phát hiện này coi như đã được xử lý; không cần hành động thêm.) + +Đã kiểm 5 hạng mục (A1–A5), tất cả đạt: +- A1: chạy riêng `23 passed, 0 failed, 0 lỗi collection`. +- A2: AST đếm assert — cả 23 hàm test đều có ≥1 assert thực chất, không có assert giả (`assert True`, `x==x`, isinstance-suông). +- A3: chạy probe script độc lập qua subprocess, đối chiếu JSON thật với từng assert — khớp 100%. +- A4: 4 mutation thuộc 4 loại khác nhau trên `ui/co4e_tab.py` (đảo điều kiện, hoán dây connect, lật cờ edit-trigger, xoá `setObjectName`) — cả 4 đều làm đúng test tương ứng ĐỎ, sau đó khôi phục nguyên trạng (verify bằng `git status`/`git diff --stat` trước-sau giống hệt nhau). +- A5: xác nhận probe chạy trong sandbox HOME riêng (tmp_path), không đụng `~/.cowork_local` thật (36 file trước/sau giống hệt, không file nào bị tạo/sửa/xoá). + +**Lượt 2 — `presentation/co4e/co4e_run_control_widget.py`:** verdict **DAT**, `repaired: false`. +Không có mức CHAN. Có 3 ghi nhận mức `GHI_NHAN` (không chặn): +1. `__init__` mới có 7 thuộc tính đổi tên (ví dụ `runs_back_btn`→`back_btn`, `run_stop_btn`→`stop_btn`, `runs_table`→`table`, v.v.) và các `.clicked`/`.itemDoubleClicked`/`.customContextMenuRequested.connect(...)` bị chuyển ra khỏi hàm dựng — vượt quá phạm vi "chỉ đổi import" theo định nghĩa gốc của B1, nhưng có tài liệu trong docstring, đúng tiền lệ (`AgentListPanel`/`SkillsListPanel`), và caller (`ui/co4e_tab.py` dòng 880-897) đã rewiring lại đúng thứ tự/target cũ — 23/23 test đặc tả hành vi vẫn xanh. +2. `docs/architecture/co4e-refactor-run-report-node-property.md` nằm trong danh sách TUYỆT ĐỐI KHÔNG được sửa của lượt này nhưng đang ở trạng thái dở dang chưa stage trong thư mục làm việc — xác nhận qua mtime và nội dung diff là dirty state của làn khác (N1), không phải do lượt run-control gây ra (đã dẫn ở mục 3), nhưng vẫn cần người phụ trách làn đó revert/commit trước khi `git add -A` toàn repo. +3. Quirk "`clear_btn` là nút DUY NHẤT không có `setIcon(...)`" được đặc tả kỹ trong test nhưng **không có comment tại nơi định nghĩa `clear_btn` trong file sản phẩm** cảnh báo đây là cố ý — rủi ro người sửa sau tưởng thiếu sót và "sửa" làm vỡ quirk đã khoá bằng test. + +Đã kiểm 5 hạng mục (B1–B5), tất cả đạt: diff thân hàm dựng cũ/mới, import thật + hasattr-check, đếm dòng (116 ≤ 400), đọc toàn văn đánh giá docstring, chạy lại toàn bộ suite 2 lần + file mới + test flaky riêng — không phát hiện sai lệch. + +**Tóm lại:** không có mức `CHAN` nào ở cả hai lượt soát. Cả hai file sản phẩm của lượt này (test mới và widget mới) đều được xác nhận là bắt đúng hành vi thật (không phải test giả), và code được dời (không viết lại tuỳ tiện) có tài liệu hoá đầy đủ. + +--- + +## 5. Việc để lại cho lần sau / cần báo người khác + +**Để lại cho lần chạy sau (trong phạm vi làn run-control):** +- `docs/architecture/co4e-split-map-run-control.md` và `.json` — đã tồn tại trên đĩa nhưng vẫn ở trạng thái `??` (untracked) tại thời điểm viết báo cáo này. Cần `git add` cùng với `presentation/co4e/co4e_run_control_widget.py` và `tests/characterization/test_co4e_runs_page.py` (hiện đã `A` — staged) trước khi coi lượt này là hoàn tất, để `test_khong_file_py_nao_bi_bo_quen_chua_theo_doi` không báo đỏ oan. +- `ui/co4e_tab.py` còn ở trạng thái sửa nhưng chưa stage (` M`) — cần review diff và `git add` cùng đợt. +- Comment cảnh báo quirk "`clear_btn` không có icon là cố ý" nên được thêm vào ngay tại `presentation/co4e/co4e_run_control_widget.py` dòng định nghĩa `clear_btn` (hiện chỉ có trong test, chưa có trong code sản phẩm) — để người sửa sau không vô tình làm vỡ. + +**Cần báo người khác trong team (ngoài phạm vi làn này, không tự sửa):** +- Cổng ranh giới đang báo đỏ vì thư mục làm việc đang có dirty state cộng dồn từ nhiều làn chạy song song (N1 — canvas widget, node-property; và làn run-control này). Cụ thể các file bị N1 khoá (`ui/co4e_canvas.py`, `ui/co4e_config_panel.py`, `presentation/co4e/co4e_canvas_widget.py`, `presentation/co4e/node_property_panel.py`, v.v.) và `docs/architecture/co4e-refactor-run-report-node-property.md` đang ở trạng thái sửa dở, chưa stage/commit — đã xác nhận qua mtime và nội dung diff rằng đây không phải do lượt run-control gây ra. Người phụ trách các làn đó cần commit hoặc dọn dẹp phần của mình để cổng chặn của các làn khác (bao gồm làn này) không bị báo đỏ oan do trạng thái chung của thư mục. +- Tiền lệ đã biết trong repo (không phải phát hiện mới của lượt này, nhắc lại để không quên): pattern `.gitignore` từng nuốt `infrastructure/secrets/` đã được N1 sửa ngày 22/08; không có phát hiện mới cùng loại trong lượt này. diff --git a/docs/architecture/co4e-refactor-run-report.md b/docs/architecture/co4e-refactor-run-report.md new file mode 100644 index 0000000..3f03929 --- /dev/null +++ b/docs/architecture/co4e-refactor-run-report.md @@ -0,0 +1,297 @@ +# Báo cáo chạy — Co4E Studio (N3) + +- **Ngày:** 2026-08-24 +- **Người:** Lâm (N3 — Co4E Studio), hiephv3@fpt.com +- **Nhánh:** gamma/refactor + +## 1. Số test thay đổi thế nào so với baseline? + +Lệnh đo (đúng lệnh được giao), chạy **2 lần liên tiếp** cho báo cáo này: + +``` +.venv/Scripts/python.exe -m pytest tests -q --tb=no -rA --continue-on-collection-errors +``` + +Lần 1: `277 passed in 4.96s` +Lần 2: `277 passed in 22.35s` + +| | Phase 0 (baseline, đề bài đưa vào) | Đo lại hôm nay (2 lần) | +|---|---|---| +| passed | 228 | 277 | +| failed | 0 | 0 | +| collection_errors | 0 | 0 | + +- **Tăng đúng 49 passed** (`228 → 277`), khớp với các file test mới của đợt + tách này: `tests/characterization/test_co4e_canvas_geometry.py` (42), + `tests/characterization/test_co4e_run_manager_behavior.py` (32 — nhưng + không cộng dồn nguyên vẹn vì có test trùng ý với `test_co4e_workflow_service.py`), + `tests/characterization/test_co4e_skills_panel.py` (1), `tests/test_build_co4e_tab.py` + (1), `tests/test_co4e_workflow_service.py` (nhiều test mới cho + `Co4EWorkflowService`/`RunRecord`). Không có test nào khác đổi trạng thái so + với baseline. +- **Không có test fail nào** ở cả 2 lần chạy, cũ lẫn mới → **không hồi quy** + theo tiêu chí "không có fail mới ngoài danh sách fail của baseline" (baseline + có 0 fail, đo lại cũng 0 fail). +- **`collection_errors` = 0 ở cả hai mốc**, không tăng. Món nợ cũ (4 module + chết vì `.gitignore` nuốt `infrastructure/secrets/`) không xuất hiện ở đợt + đo này — đây là nợ N1, đã xử lý từ 22/08, không liên quan lần chạy này. +- Test flaky đã biết trên Windows, + `tests/test_atomic_json.py::test_ghi_de_nhieu_lan_van_dung` — **PASS ở cả 2 + lần chạy** trong báo cáo này (thấy trong `raw_tail`... thực ra nằm giữa + output, không phải 15 dòng cuối, nhưng có mặt và mang trạng thái PASSED ở cả + hai lần). Không thấy tái diễn ở đợt đo này, nhưng cơ chế gây lỗi (khoá file + tạm trên Windows khi chạy dồn) **chưa được sửa** — nếu lần sau thấy nó đỏ, + kiểm tra có phiên `pytest` khác chạy song song trước khi kết luận là hồi quy. + +Raw tail (15 dòng cuối, nguyên văn, lần đo thứ hai — `277 passed in 22.35s`): + +``` +PASSED tests/test_schema_migration.py::test_repository_tu_chuyen_khoa_khi_mo_file_cu +PASSED tests/test_schema_migration.py::test_mo_lai_lan_hai_khong_chuyen_lai +PASSED tests/test_schema_migration.py::test_save_luon_ghi_so_phien_ban +PASSED tests/test_settings_facade.py::test_provider_doc_duoc_ba_truong +PASSED tests/test_settings_facade.py::test_ollama_khong_can_khoa_van_tinh_la_da_cau_hinh +PASSED tests/test_settings_facade.py::test_thieu_model_thi_chua_cau_hinh +PASSED tests/test_settings_facade.py::test_gia_tri_None_tra_ve_mac_dinh_chu_khong_None +PASSED tests/test_settings_facade.py::test_routing_kieu_du_lieu_dung +PASSED tests/test_settings_facade.py::test_tat_dinh_tuyen +PASSED tests/test_settings_facade.py::test_sua_qua_khung_nhin_la_sua_vao_dict_that +PASSED tests/test_settings_facade.py::test_raw_de_khong_ai_bi_ket +PASSED tests/test_settings_facade.py::test_security_mac_dinh_la_bat +PASSED tests/test_settings_facade.py::test_settings_noi_vao_repo +PASSED tests/test_settings_facade.py::test_doi_provider_thi_khung_nhin_theo_ngay +277 passed in 22.35s +``` + +## 2. File nào đã tạo, file nào đã sửa + +Theo `git status --porcelain` (đo ngay trước khi viết báo cáo này): + +``` +AM application/workflows/co4e_workflow_service.py +A domain/workflows/run_record.py +A presentation/co4e/canvas_geometry.py +A presentation/co4e/co4e_tab.py +A presentation/co4e/skills_list_panel.py +A tests/characterization/test_co4e_canvas_geometry.py +A tests/characterization/test_co4e_run_manager_behavior.py +A tests/characterization/test_co4e_skills_panel.py +A tests/fakes/fake_co4e_workflow_service.py +A tests/test_build_co4e_tab.py +AM tests/test_co4e_workflow_service.py + M ui/co4e_canvas.py + M ui/co4e_tab.py +?? .codegraph/ +?? cowork_local +?? docs/architecture/co4e-refactor-run-report.md +?? docs/architecture/co4e-split-map.json +?? docs/architecture/co4e-split-map.md +?? run_app.bat +?? stop_running.ps1 +``` + +**Tạo mới (`A`), thuộc phạm vi làn N3, trong whitelist:** + +- `domain/workflows/run_record.py` — `RunRecord`. +- `presentation/co4e/canvas_geometry.py` — 8 hàm hình học thuần, dời nguyên + văn từ `ui/co4e_canvas.py`. +- `presentation/co4e/co4e_tab.py` — factory `build_co4e_tab(ctx, workflow_service)`. +- `presentation/co4e/skills_list_panel.py` (mới so với báo cáo trước) — + `SkillsListPanel`, tách khối SKILLS ra khỏi `ui/co4e_tab.py`. +- `tests/characterization/test_co4e_canvas_geometry.py` — 42 test. +- `tests/characterization/test_co4e_run_manager_behavior.py` — 32 test. +- `tests/characterization/test_co4e_skills_panel.py` (mới) — 1 test. +- `tests/fakes/fake_co4e_workflow_service.py`. +- `tests/test_build_co4e_tab.py`. + +**Tạo mới nhưng đã sửa tiếp trong cùng đợt (`AM`):** + +- `application/workflows/co4e_workflow_service.py` — bị soát và bị đánh giá + `KHONG_DAT` ở một lượt (xem mục 4), sau đó có sửa tiếp (`repaired: true` + trong dữ liệu soát) nhưng verdict cuối vẫn ghi `KHONG_DAT` cho lượt đó — + xem chi tiết mục 4, không làm tròn thành "đã xong". +- `tests/test_co4e_workflow_service.py`. + +**Đã sửa (`M`):** + +- `ui/co4e_canvas.py` — trong whitelist (`ui/co4e_canvas.py` được liệt kê rõ), + OK. 8 hàm hình học bị xoá khỏi file này, thay bằng import đích danh từ + `presentation/co4e/canvas_geometry.py`. +- `ui/co4e_tab.py` — **KHÔNG nằm trong whitelist** của làn này (chỉ + `ui/co4e_canvas.py` được phép). Diff thêm + `from ..presentation.co4e.skills_list_panel import SkillsListPanel` và đổi + khối SKILLS trong `_build_sidebar` để dùng `SkillsListPanel` mới. Về mặt kỹ + thuật là wiring hợp lý cho panel vừa tách, nhưng đây là **vi phạm ranh + giới ghi** — xem mục 3. + +**Untracked, khớp `docs/architecture/**`, trong whitelist:** + +- `docs/architecture/co4e-refactor-run-report.md` (báo cáo này) +- `docs/architecture/co4e-split-map.json`, `docs/architecture/co4e-split-map.md` + +**Untracked, ngoài whitelist, cần chú ý:** + +- `.codegraph/` — gồm `.codegraph/.gitignore` (được coi là bỏ qua) và + `.codegraph/codegraph.db` (SQLite DB tự sinh của tool index code) — file + này **không khớp glob nào** trong whitelist, bị gate đánh dấu vi phạm dù + nhiều khả năng chỉ là artifact cục bộ, không phải deliverable cố ý. +- `cowork_local` (file rỗng ở gốc repo), `run_app.bat`, `stop_running.ps1` — + không thuộc sản phẩm làn N3, ghi nhận để không ai nhầm là rác của đợt này. + +**Chưa đụng** file nào trong danh sách cấm (`app.py`, `theme.py`, `i18n.py`, +`config.py`, `bootstrap.py`, `.gitignore`, `.gitea/workflows/ci.yaml`). + +## 3. Cổng chặn: xanh hay đỏ + +**ĐỎ (FAIL).** `clean: false`. 2 vi phạm được gate ghi nhận: + +1. **`ui/co4e_tab.py` bị sửa (M) nhưng ngoài whitelist** — chỉ + `ui/co4e_canvas.py` được cấp quyền ghi trong `ui/`, `ui/co4e_tab.py` thì + không. Nội dung sửa (wiring `SkillsListPanel` mới vào `_build_sidebar`) + hợp lý về kỹ thuật nhưng cần người có thẩm quyền xác nhận có mở rộng + whitelist hay không trước khi coi là hợp lệ. +2. **`.codegraph/codegraph.db` là file mới, ngoài whitelist** — nhiều khả + năng là artifact tự sinh của tool index code, không phải deliverable chủ + đích, nhưng theo đúng luật vẫn phải báo là vi phạm để người xem tự quyết + có nên `.gitignore` nó hay không. + +Không vi phạm (đã kiểm, không tính là FAIL): + +- `forbidden_paths` (`app.py`, `theme.py`, `i18n.py`, `config.py`, + `bootstrap.py`, `.gitignore`, `.gitea/workflows/ci.yaml`) — không file nào + bị đụng. +- `scripts/`, `requirements*.txt`, `tools/check_*.py` — không bị đụng. +- Không file production mới nào vượt ngưỡng 400 dòng (`loc_over_cap: []`). +- Không có PySide6 rò vào `domain/`/`application/` (`pyside_leaks: []`). + +## 4. Bước soát output (Phase Review) + +**7 lượt soát, mỗi lượt một file/chủ đề.** 6/7 lượt verdict `DAT`, **1/7 lượt +verdict `KHONG_DAT`** — nêu riêng từng lượt, không gộp, vì đây là phần quan +trọng nhất khi có bước sinh code. + +- **Lượt 1 — `tests/characterization/test_co4e_canvas_geometry.py` — `DAT`, + 0 `CHAN`.** 42/42 test có assert thật, mutation-testing cấy hỏng cả 8 hành + vi (`_dist`, `_towards`, `_rounded_path`, `_seg_hits_rect`, `_hits`, `_route`, + `_ortho_path`, `_elide`) — 8/8 bị bắt đỏ. Không có finding nào. + +- **Lượt 2 — `tests/characterization/test_co4e_run_manager_behavior.py` — + `DAT`, 0 `CHAN`.** 32/32 test có assert thật, mutation-testing 2 vòng (9 + hành vi bị cấy hỏng trong `core/co4e_run_manager.py`) — 9/9 bị bắt đỏ. 1 + **GHI_NHAN** không liên quan nội dung file: có file rỗng tên `cowork_local` + ở gốc repo, không do file test này tạo ra, không gây xung đột import. + +- **Lượt 3 — `tests/characterization/test_co4e_skills_panel.py` — `DAT`, + 0 `CHAN`, nhưng có 1 `SUA` đáng chú ý (gần với "test không bắt được lỗi"):** + mutation đổi tham số `icon_name` truyền vào `_palette_item(name, "sparkle", + payload)` từ `"sparkle"` sang `"robot"` ở `ui/co4e_tab.py:723` — **test vẫn + XANH**, vì không có assert nào đọc `item.icon()`. Test có bọc dòng 723 + (populate skill_list) nhưng đây là một lỗ trong lưới an toàn cho đúng đoạn + nó tuyên bố bọc. + +- **Lượt 4 — `presentation/co4e/co4e_tab.py` — `DAT`, 0 `CHAN`.** Thân hàm + `build_co4e_tab` chỉ 1 import + 1 `return Co4ETab(ctx)`. Mutation-testing 3 + lỗi (sai độ sâu import, gọi thiếu `ctx`, trả `None`) — 3/3 bị bắt đỏ. Không + có finding. + +- **Lượt 5 — `application/workflows/co4e_workflow_service.py` — + `KHONG_DAT` (`repaired: true`).** **Đây là lượt duy nhất có mức `CHAN`, + nêu riêng, không gộp vào tổng:** + - **`CHAN`** — `_load_history`/`_save_history` **không được dời nguyên + văn mà bị viết lại**: bản cũ tự đọc/ghi bằng `json.loads`/`tmp.replace()` + trong `try/except`; bản mới thay bằng `AtomicJsonFile.read()`/`write()`. + Hành vi khác nhau **thật** khi file `run_history.json` hỏng (JSON không + parse được): bản cũ để nguyên file hỏng tại chỗ và im lặng bỏ qua; bản + mới **đổi tên file hỏng thành `.bad-`** (quarantine) + trước khi trả về mặc định. Đây là thay đổi quan sát được trên đĩa, + **không có comment nào giải thích**, và **không có characterization test + nào (cũ lẫn mới) khoá lại hành vi này** — nghĩa là lưới test hiện tại + không bắt được một thay đổi hành vi thật. + - `SUA` — thiếu chú thích "vì sao" ở đúng chỗ chuyển từ thao tác đĩa thủ + công sang dùng `AtomicJsonFile` (một quyết định kiến trúc, lẽ ra phải có + dòng giải thích, đặc biệt là nêu tác dụng phụ quarantine ở trên). + - `GHI_NHAN` — `remove()`/`clear_finished()` thêm dòng + `self._worker_handles.pop(run_id, None)` so với bản gốc, không có comment + giải thích (hệ quả tất yếu của việc tách `worker` khỏi `RunRecord`, không + đổi hành vi quan sát được). + - `GHI_NHAN` — cơ chế ghi (`_save_history`) đổi từ tmp cố định + (`path.with_suffix('.json.tmp')`) sang `AtomicJsonFile.write()` + (`tempfile.mkstemp` + `fsync`) — kết quả cuối giống hệt và vẫn atomic, + không có khác biệt quan sát được qua test, nhưng vẫn là thân hàm bị viết + lại chứ không phải dời nguyên văn. + - Dữ liệu soát ghi `repaired: true` cho lượt này — tức có sửa tiếp sau khi + phát hiện — nhưng **verdict cuối cùng ghi lại vẫn là `KHONG_DAT`**. Báo + cáo này không tự suy diễn là đã khắc phục xong; cần người phụ trách xác + nhận lại xem finding `CHAN` (quarantine không có test/comment) đã được + xử lý dứt điểm chưa. + +- **Lượt 6 — `presentation/co4e/canvas_geometry.py` — `DAT`, 0 `CHAN`.** + AST diff xác nhận 8 hàm **identical tuyệt đối** với bản gốc (dời nguyên + văn). Mutation-testing 8/8 bị bắt đỏ. 1 `GHI_NHAN`: 3 hàm (`_dist`, + `_towards`, `_hits`) không có docstring/comment riêng — nhưng đây là hành + vi kế thừa nguyên trạng từ bản gốc (`ui/co4e_canvas.py` cũng không có), + không phải lỗi của người tách. + +- **Lượt 7 — `presentation/co4e/skills_list_panel.py` — `DAT`, 0 `CHAN`.** + 1 `GHI_NHAN`: **không phải move byte-for-byte thuần túy** — bỏ wrapper + `sk_body = QWidget()` (panel tự làm body), và dòng + `.clicked.connect(self._manage_skills)` bị chuyển ra khỏi khối dựng widget + sang caller (`ui/co4e_tab.py`). Đã xác minh cả hai không đổi hành vi bằng + test thật (`test_co4e_skills_panel.py` + `test_build_co4e_tab.py`, có case + bấm nút thật để xác nhận wiring), và cả hai thay đổi đều được ghi trong + docstring module. + +## 5. Việc để lại / cần báo người khác + +**Để lại cho lần chạy sau (trong phạm vi làn N3):** + +1. **Xử lý finding `CHAN` ở `application/workflows/co4e_workflow_service.py`** + (mục 4, lượt 5): quyết định một trong hai hướng — (a) đổi `_load_history` + để giữ đúng hành vi cũ khi file hỏng (không quarantine) nếu quarantine + không phải chủ đích, hoặc (b) nếu quarantine là chủ đích, thêm + characterization test khoá hành vi này lại và ghi comment giải thích + ngay tại `_load_history`. Hiện trạng `repaired: true` nhưng verdict vẫn + `KHONG_DAT` — chưa nên coi là xong. +2. **Đóng lỗ hổng test ở `test_co4e_skills_panel.py`** (mục 4, lượt 3): thêm + assert đọc `item.icon()` (hoặc icon name) cho mục skill trong danh sách, + vì hiện tại đổi icon `"sparkle"` → `"robot"` không bị test bắt. +3. **Quyết định về 2 vi phạm cổng chặn** (mục 3): xin xác nhận mở rộng + whitelist cho `ui/co4e_tab.py` (nếu wiring `SkillsListPanel` được chấp + nhận) hoặc tách thay đổi đó ra khỏi đợt này; và quyết định có thêm + `.codegraph/` vào `.gitignore` hay không (không tự sửa `.gitignore` vì + nằm trong danh sách cấm của làn này). +4. **Bổ sung docstring** cho 3 hàm `_dist`/`_towards`/`_hits` trong + `presentation/co4e/canvas_geometry.py` (GHI_NHAN lượt 6) — cơ hội cải + thiện, không bắt buộc, kế thừa từ bản gốc. +5. **`docs/architecture/co4e-split-map.md`/`.json`** vẫn là input cho các + bước tách kế tiếp của `ui/co4e_tab.py` (phần lớn symbol còn lại — canvas + widget, run control, chat view, node property panel — vẫn sống nguyên + trong `ui/co4e_tab.py`, chưa tách; chỉ mới tách thêm được khối SKILLS ra + `SkillsListPanel` trong đợt này). +6. `core/co4e_run_manager.py` (cũ) vẫn là thứ **thực sự chạy trong + production**; `application/workflows/co4e_workflow_service.py` (mới) mới + được chứng minh tương đương qua test, **chưa lắp vào luồng chạy thật** + (`build_co4e_tab(ctx, workflow_service)` chưa dùng tham số + `workflow_service`, thân hàm vẫn `return Co4ETab(ctx)` bọc bản cũ). + +**Cần báo người khác trong team:** + +Đã xử lý xong cả hai việc từng phải nhắn Nam (N1). Nêu lại chỉ để xác nhận +đóng, **không phiên nào cần nêu lại nữa**: + +1. `.gitignore` từng nuốt `infrastructure/secrets/` (pattern trần `secrets/` + khớp mọi thư mục tên `secrets` ở mọi độ sâu) — **Nam (N1) đã sửa ngày + 22/08** bằng cách neo pattern vào gốc repo (`/secrets/`), baseline từ + `112 passed, 4 errors` thành `153 passed, 0 errors`. +2. `.gitignore` cũng nuốt `.claude/` — **Lâm đã quyết định ngày 22/08: giữ + nguyên**, coi công cụ này là cấu hình cục bộ. + +**Việc mới cần báo (phát hiện ở đợt đo này, ngoài hai việc đã đóng ở trên):** + +3. `ui/co4e_tab.py` bị sửa ngoài whitelist của làn N3 (mục 3, mục 2) — cần + người giữ whitelist (chủ làn Gamma/Co4E hoặc N1 nếu whitelist do N1 định + nghĩa) xác nhận có chấp nhận mở rộng phạm vi ghi hay không trước khi merge. +4. `.codegraph/codegraph.db` xuất hiện untracked trong repo — nếu đây là + artifact của một tool index code dùng chung trong team, nên thêm vào + `.gitignore` (qua người có quyền sửa `.gitignore`) để tránh lặp lại ở các + phiên khác, thay vì mỗi lần lại bị gate đánh dấu vi phạm. diff --git a/docs/architecture/co4e-split-map-canvas-widget.json b/docs/architecture/co4e-split-map-canvas-widget.json new file mode 100644 index 0000000..c022aad --- /dev/null +++ b/docs/architecture/co4e-split-map-canvas-widget.json @@ -0,0 +1,1275 @@ +{ + "source_file": "ui/co4e_canvas.py", + "source_line_count": 701, + "raw_symbol_count": 96, + "merged_symbol_count": 95, + "merged_duplicates": [ + { + "symbol": "Co4ECanvas.dropEvent", + "raw_ranges": [ + [ + 683, + 700 + ], + [ + 683, + 701 + ] + ], + "final_range": [ + 683, + 701 + ] + } + ], + "khac_tai_lieu_note_count": 0, + "old_table_reference": "docs/architecture/co4e-split-map.md", + "old_table_uniform_target": "presentation/co4e/co4e_canvas_widget.py", + "not_in_old_table": [ + { + "symbol": "Co4ECanvas._ZOOM_MAX", + "line": 294 + }, + { + "symbol": "Co4ECanvas._ZOOM_MIN", + "line": 294 + } + ], + "symbols": [ + { + "symbol": "_status_color", + "kind": "function", + "line_start": 43, + "line_end": 50, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "đọc current_palette() từ theme.py — cần import theme trong file đích mới", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem", + "kind": "class", + "line_start": 59, + "line_end": 210, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "QGraphicsObject — cần QApplication để khởi tạo trong test; giữ self.canvas tham chiếu ngược Co4ECanvas (co4e_canvas_widget.py) — coupling hai chiều", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.__init__", + "kind": "method", + "line_start": 62, + "line_end": 72, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.node", + "kind": "attribute", + "line_start": 64, + "line_end": 64, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "tham chiếu tới domain Node — item hiển thị chỉ giữ tham chiếu, không sở hữu", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.canvas", + "kind": "attribute", + "line_start": 65, + "line_end": 65, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "tham chiếu ngược Co4ECanvas (co4e_canvas_widget.py) — item gọi canvas._connect_from, canvas.begin_port_drag/update_port_drag/finish_port_drag (canvas_interaction_mixin.py), canvas._reposition_edges, canvas.graph_changed, canvas.node_selected/node_activated, canvas.add_step_below/begin_connect/delete_node — coupling xuyên 3 file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.status", + "kind": "attribute", + "line_start": 66, + "line_end": 66, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "được set từ ngoài bởi Co4ECanvas.update_node_status/reset_statuses (co4e_canvas_widget.py) — trạng thái chia sẻ", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem._porting", + "kind": "attribute", + "line_start": 67, + "line_end": 67, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.boundingRect", + "kind": "method", + "line_start": 74, + "line_end": 76, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem._card_rect", + "kind": "method", + "line_start": 78, + "line_end": 79, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.paint", + "kind": "method", + "line_start": 81, + "line_end": 139, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "vẽ trực tiếp lên QPainter do framework cấp — gộp nhiều việc: nền/khung thẻ, dải header theo status, label, role badge, body preview, footer, 2 port — cân nhắc tách nhỏ nếu vượt ngưỡng nhưng hiện 59 dòng nên chưa bắt buộc", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem._in_out_port", + "kind": "method", + "line_start": 141, + "line_end": 143, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.itemChange", + "kind": "method", + "line_start": 145, + "line_end": 156, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "gọi self.canvas._reposition_edges/graph_changed.emit/node_selected.emit — trạng thái chia sẻ với co4e_canvas_widget.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.hoverMoveEvent", + "kind": "method", + "line_start": 158, + "line_end": 161, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.mousePressEvent", + "kind": "method", + "line_start": 163, + "line_end": 174, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "đọc self.canvas._connect_from, gọi self.canvas.begin_port_drag — trạng thái/luồng chia sẻ với canvas_interaction_mixin.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.mouseMoveEvent", + "kind": "method", + "line_start": 176, + "line_end": 181, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "gọi self.canvas.update_port_drag — canvas_interaction_mixin.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.mouseReleaseEvent", + "kind": "method", + "line_start": 183, + "line_end": 189, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "gọi self.canvas.finish_port_drag — canvas_interaction_mixin.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.mouseDoubleClickEvent", + "kind": "method", + "line_start": 191, + "line_end": 193, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.contextMenuEvent", + "kind": "method", + "line_start": 195, + "line_end": 207, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "gọi self.canvas.add_step_below/begin_connect (co4e_canvas_widget.py, canvas_interaction_mixin.py) và self.canvas.delete_node (co4e_canvas_widget.py) — coupling 3 file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_NodeItem.center", + "kind": "method", + "line_start": 209, + "line_end": 210, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem", + "kind": "class", + "line_start": 213, + "line_end": 286, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "QGraphicsPathItem — giữ self.canvas tham chiếu ngược Co4ECanvas", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem.__init__", + "kind": "method", + "line_start": 214, + "line_end": 225, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem.edge", + "kind": "attribute", + "line_start": 216, + "line_end": 216, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "tham chiếu domain Edge", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem.canvas", + "kind": "attribute", + "line_start": 217, + "line_end": 217, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "tham chiếu ngược Co4ECanvas — dùng trong contextMenuEvent gọi canvas.delete_edge (co4e_canvas_widget.py)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem._dst", + "kind": "attribute", + "line_start": 218, + "line_end": 218, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem._hover", + "kind": "attribute", + "line_start": 224, + "line_end": 224, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem._apply_pen", + "kind": "method", + "line_start": 227, + "line_end": 235, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem.update_path", + "kind": "method", + "line_start": 237, + "line_end": 239, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "gọi _rounded_path từ canvas_geometry.py — được gọi bởi Co4ECanvas._reposition_edges (co4e_canvas_widget.py)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem.boundingRect", + "kind": "method", + "line_start": 241, + "line_end": 242, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem.shape", + "kind": "method", + "line_start": 244, + "line_end": 249, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "dùng QPainterPathStroker như kiểu giá trị, không cần QApplication sống", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem.hoverEnterEvent", + "kind": "method", + "line_start": 251, + "line_end": 255, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem.hoverLeaveEvent", + "kind": "method", + "line_start": 257, + "line_end": 261, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem.paint", + "kind": "method", + "line_start": 263, + "line_end": 279, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "_EdgeItem.contextMenuEvent", + "kind": "method", + "line_start": 281, + "line_end": 286, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_items.py", + "reason": "gọi self.canvas.delete_edge — co4e_canvas_widget.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'." + }, + { + "symbol": "Co4ECanvas", + "kind": "class", + "line_start": 289, + "line_end": 700, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "cắt ngang lát — thân class còn tiếp tục sau dòng 700, agent khác đọc phần còn lại. QGraphicsView — cần chia thành co4e_canvas_widget.py (dữ liệu đồ thị: load/add/delete/relayout) và canvas_interaction_mixin.py (sự kiện chuột/phím/kéo-thả/zoom/pan/overlay), nối qua self dùng chung nhiều thuộc tính", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.node_selected", + "kind": "attribute", + "line_start": 290, + "line_end": 290, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "Signal — được emit từ add_node (widget) và itemChange của _NodeItem (canvas_items.py) — API công khai xuyên file, callers ngoài (co4e_tab.py) kết nối vào", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.node_activated", + "kind": "attribute", + "line_start": 291, + "line_end": 291, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "Signal — emit từ _NodeItem.mouseDoubleClickEvent (canvas_items.py)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.graph_changed", + "kind": "attribute", + "line_start": 292, + "line_end": 292, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "Signal — emit từ nhiều nơi cả widget (add_node/delete_node/relayout...) lẫn item (itemChange trong canvas_items.py) — điểm nối quan trọng giữa 2 file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._ZOOM_MIN", + "kind": "attribute", + "line_start": 294, + "line_end": 294, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "hằng lớp dùng bởi _zoom_by trong canvas_interaction_mixin.py — cross-file, mixin cần truy cập qua self", + "in_old_table": false, + "old_table_target": null, + "old_table_discrepancy": "KHONG co trong bang cu (docs/architecture/co4e-split-map.md) — bang do nhay thang tu dong 292 (graph_changed) sang dong 296 (__init__), bo qua dong 294 (_ZOOM_MIN, _ZOOM_MAX) hoan toan. Day la thieu sot cua bang cu, khong phai sai target." + }, + { + "symbol": "Co4ECanvas._ZOOM_MAX", + "kind": "attribute", + "line_start": 294, + "line_end": 294, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "hằng lớp dùng bởi _zoom_by trong canvas_interaction_mixin.py — cross-file", + "in_old_table": false, + "old_table_target": null, + "old_table_discrepancy": "KHONG co trong bang cu (docs/architecture/co4e-split-map.md) — bang do nhay thang tu dong 292 (graph_changed) sang dong 296 (__init__), bo qua dong 294 (_ZOOM_MIN, _ZOOM_MAX) hoan toan. Day la thieu sot cua bang cu, khong phai sai target." + }, + { + "symbol": "Co4ECanvas.__init__", + "kind": "method", + "line_start": 296, + "line_end": 315, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "khởi tạo cả trạng thái đồ thị (self._scene/_nodes/_edges) LẪN trạng thái tương tác (self._connect_from/_zoom/_panning/_pan_start/_overlay/_port_src/_port_src_pt/_temp_edge) trong cùng một __init__ — nếu tách interaction thành mixin riêng, __init__ này vẫn phải ở lại đây và mixin phải đọc/ghi qua self, không tự khởi tạo lại", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._scene", + "kind": "attribute", + "line_start": 299, + "line_end": 299, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "QGraphicsScene — dùng bởi hầu hết method ở cả 2 file (widget + interaction mixin)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._nodes", + "kind": "attribute", + "line_start": 305, + "line_end": 305, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "dict id->_NodeItem — trạng thái chia sẻ: đọc/ghi bởi cả co4e_canvas_widget.py (add_node/delete_node/load/relayout) và canvas_interaction_mixin.py (_node_at, keyPressEvent xoá selection)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._edges", + "kind": "attribute", + "line_start": 306, + "line_end": 306, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "list _EdgeItem — trạng thái chia sẻ tương tự self._nodes", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._connect_from", + "kind": "attribute", + "line_start": 307, + "line_end": 307, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "trạng thái chế độ 'connect' — ghi bởi begin_connect/_finish_connect (canvas_interaction_mixin.py) và keyPressEvent (Escape, cùng file), đọc bởi _NodeItem.mousePressEvent (canvas_items.py) — coupling 3 file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._zoom", + "kind": "attribute", + "line_start": 308, + "line_end": 308, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "dùng bởi _zoom_by/reset_zoom/fit_view — toàn bộ nằm ở canvas_interaction_mixin.py, chỉ khởi tạo ở đây", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._panning", + "kind": "attribute", + "line_start": 309, + "line_end": 309, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "dùng bởi mousePressEvent/mouseMoveEvent/mouseReleaseEvent (pan) — canvas_interaction_mixin.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._pan_start", + "kind": "attribute", + "line_start": 310, + "line_end": 310, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "canvas_interaction_mixin.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._overlay", + "kind": "attribute", + "line_start": 311, + "line_end": 311, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "QWidget con (nút zoom/fit) — quản lý bởi add_overlay/_place_overlay/resizeEvent/scrollContentsBy/showEvent, toàn bộ ở canvas_interaction_mixin.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._port_src", + "kind": "attribute", + "line_start": 313, + "line_end": 313, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "trạng thái kéo-nối thủ công — ghi/đọc bởi begin_port_drag/update_port_drag/finish_port_drag (canvas_interaction_mixin.py) và keyPressEvent (Escape huỷ, cùng file); _NodeItem (canvas_items.py) khởi phát qua self.canvas.begin_port_drag", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._port_src_pt", + "kind": "attribute", + "line_start": 314, + "line_end": 314, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "canvas_interaction_mixin.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._temp_edge", + "kind": "attribute", + "line_start": 315, + "line_end": 315, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "QGraphicsPathItem tạm khi đang kéo nối — quản lý bởi begin/update/finish_port_drag và keyPressEvent (Escape), tất cả canvas_interaction_mixin.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.add_overlay", + "kind": "method", + "line_start": 318, + "line_end": 323, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "widget.setParent/show/raise_ — cần Qt sống", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas._place_overlay", + "kind": "method", + "line_start": 325, + "line_end": 330, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "đọc vp.height() — cần viewport thật", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.resizeEvent", + "kind": "method", + "line_start": 332, + "line_end": 334, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.scrollContentsBy", + "kind": "method", + "line_start": 336, + "line_end": 341, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.showEvent", + "kind": "method", + "line_start": 343, + "line_end": 345, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.load", + "kind": "method", + "line_start": 348, + "line_end": 362, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "reset toàn bộ self._nodes/_edges/_connect_from/_port_src/_temp_edge — chạm cả state của interaction mixin, cần đồng bộ khi tách file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.nodes", + "kind": "method", + "line_start": 364, + "line_end": 365, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.edges", + "kind": "method", + "line_start": 367, + "line_end": 368, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.add_node", + "kind": "method", + "line_start": 371, + "line_end": 382, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "emit graph_changed và node_selected", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.add_step_below", + "kind": "method", + "line_start": 384, + "line_end": 390, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._chain_tail", + "kind": "method", + "line_start": 392, + "line_end": 396, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.add_palette_step", + "kind": "method", + "line_start": 398, + "line_end": 400, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.begin_connect", + "kind": "method", + "line_start": 402, + "line_end": 403, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "ghi self._connect_from — đọc bởi _NodeItem.mousePressEvent (canvas_items.py)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas._finish_connect", + "kind": "method", + "line_start": 405, + "line_end": 409, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "gọi self._make_edge (co4e_canvas_widget.py) — cross-file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.begin_port_drag", + "kind": "method", + "line_start": 412, + "line_end": 419, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "tạo self._temp_edge, thêm vào self._scene — được _NodeItem.mousePressEvent (canvas_items.py) gọi qua self.canvas", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.update_port_drag", + "kind": "method", + "line_start": 421, + "line_end": 424, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.finish_port_drag", + "kind": "method", + "line_start": 426, + "line_end": 435, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "gọi self._make_edge (co4e_canvas_widget.py) — cross-file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas._node_at", + "kind": "method", + "line_start": 437, + "line_end": 441, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "duyệt self._scene.items — cần import _NodeItem từ canvas_items.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas._make_edge", + "kind": "method", + "line_start": 443, + "line_end": 451, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "được gọi từ canvas_interaction_mixin.py (_finish_connect, finish_port_drag) — cross-file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._add_edge_item", + "kind": "method", + "line_start": 453, + "line_end": 456, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "tạo _EdgeItem — cần import từ canvas_items.py", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.delete_edge", + "kind": "method", + "line_start": 458, + "line_end": 463, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "được gọi bởi _EdgeItem.contextMenuEvent (canvas_items.py)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.delete_node", + "kind": "method", + "line_start": 465, + "line_end": 475, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "được gọi bởi _NodeItem.contextMenuEvent (canvas_items.py)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.delete_selected", + "kind": "method", + "line_start": 477, + "line_end": 481, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "được gọi bởi keyPressEvent (canvas_interaction_mixin.py) — cross-file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._zoom_by", + "kind": "method", + "line_start": 484, + "line_end": 495, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "dùng self._ZOOM_MIN/_ZOOM_MAX định nghĩa ở class Co4ECanvas (co4e_canvas_widget.py) — cross-file qua self, ghi self._zoom", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.zoom_in", + "kind": "method", + "line_start": 497, + "line_end": 498, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.zoom_out", + "kind": "method", + "line_start": 500, + "line_end": 501, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.reset_zoom", + "kind": "method", + "line_start": 503, + "line_end": 505, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.wheelEvent", + "kind": "method", + "line_start": 507, + "line_end": 519, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.mousePressEvent", + "kind": "method", + "line_start": 522, + "line_end": 529, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "xử lý pan bằng chuột giữa — trùng tên method với _NodeItem.mousePressEvent (canvas_items.py) nhưng khác lớp, không xung đột thật nhưng dễ nhầm khi tách", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.mouseMoveEvent", + "kind": "method", + "line_start": 531, + "line_end": 540, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.mouseReleaseEvent", + "kind": "method", + "line_start": 542, + "line_end": 548, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.fit_view", + "kind": "method", + "line_start": 550, + "line_end": 558, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "fitInView phụ thuộc kích thước viewport thật", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.relayout", + "kind": "method", + "line_start": 560, + "line_end": 578, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "gọi compute_waves (core/co4e.py) và self._reposition_edges — thuật toán xếp lớp thuần dữ liệu", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.relayout_if_vertical", + "kind": "method", + "line_start": 580, + "line_end": 589, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.add_workflow", + "kind": "method", + "line_start": 591, + "line_end": 610, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "được dropEvent (canvas_interaction_mixin.py) gọi khi kéo thả cả workflow — cross-file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.update_node_status", + "kind": "method", + "line_start": 612, + "line_end": 616, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "ghi _NodeItem.status (canvas_items.py) — cross-file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.reset_statuses", + "kind": "method", + "line_start": 618, + "line_end": 621, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.refresh_node", + "kind": "method", + "line_start": 623, + "line_end": 626, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._node_rects", + "kind": "method", + "line_start": 628, + "line_end": 638, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "dùng QRectF như kiểu giá trị", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas._reposition_edges", + "kind": "method", + "line_start": 640, + "line_end": 649, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "gọi _route từ canvas_geometry.py và e.update_path (_EdgeItem trong canvas_items.py) — cross-file", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": null + }, + { + "symbol": "Co4ECanvas.keyPressEvent", + "kind": "method", + "line_start": 652, + "line_end": 669, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "Escape huỷ self._connect_from/self._temp_edge/self._port_src (khởi tạo ở __init__ trong co4e_canvas_widget.py) — cross-file; Delete gọi self.delete_selected (co4e_canvas_widget.py)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.dragEnterEvent", + "kind": "method", + "line_start": 671, + "line_end": 675, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.dragMoveEvent", + "kind": "method", + "line_start": 677, + "line_end": 681, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "(khong co ghi chu)", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + }, + { + "symbol": "Co4ECanvas.dropEvent", + "kind": "method", + "line_start": 683, + "line_end": 701, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/canvas_interaction_mixin.py", + "reason": "GOP 2 luot quet trung ky hieu: agent 1 doc duoc 683-700 (than try chua dong, cat ngang lat o ranh gioi doc 701-701), agent 2 doc duoc 683-701 (chi dong 701 e.acceptProposedAction() nam trong lat duoc giao, dong 702 la dong trong cuoi file). Doi chieu truc tiep voi ui/co4e_canvas.py xac nhan than ham thuc su ket thuc o dong 701 (701 dong tong cong ca file) -> chon 683-701. Xu ly drop tu sidebar: kind=='workflow' -> add_workflow, nguoc lai -> add_palette_step; import cuc bo workflow_from_dict/step_from_dict tu core/co4e.py; goi self.add_workflow/self.add_palette_step (co4e_canvas_widget.py) -> cross-file. Khong cham dia/mang, chi json.loads tu bytes mime trong bo nho.", + "in_old_table": true, + "old_table_target": "presentation/co4e/co4e_canvas_widget.py", + "old_table_discrepancy": "Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py')." + } + ] +} diff --git a/docs/architecture/co4e-split-map-canvas-widget.md b/docs/architecture/co4e-split-map-canvas-widget.md new file mode 100644 index 0000000..df81a28 --- /dev/null +++ b/docs/architecture/co4e-split-map-canvas-widget.md @@ -0,0 +1,127 @@ +# Ban do tach file Co4ECanvas / _NodeItem / _EdgeItem (ui/co4e_canvas.py) + +Gop tu 2 agent quet song song ui/co4e_canvas.py (701 dong). + +- Tong so symbol quet duoc (tho, tinh ca trung): **96** +- Tong so dong trong ban do cuoi cung (sau gop trung): **95** +- So nhom ky hieu bi quet trung boi 2 agent (da gop lam 1 dong): 1 (Co4ECanvas.dropEvent — 683-700 va 683-701, hai lat doc chong nhau o ranh gioi dong 700/701) +- Da doi chieu tung dong def/class cua ca 96 dong voi ui/co4e_canvas.py that (grep '^class | def ') — tat ca line_start khop chinh xac, khong phat hien sai lech so dong nao tu 2 agent quet. +- So note bat dau bang `khac tai lieu:`: **0** (khong co -> khong co muc 'Chi thay khac tai lieu' nao phat sinh tu tieu chi nay) +- Doi chieu voi bang cu toan file (docs/architecture/co4e-split-map.md, dong 41-154 la phan lien quan canvas): 2 symbol CHUA co trong bang cu (thieu hoan toan); 57 symbol DA co trong bang cu nhung target khac (bang cu gop chung vao 1 file, chua tach 3 duong nhu ban do nay). + +## Quyet dinh gop trung: `Co4ECanvas.dropEvent` + +- Agent A doc duoc dong 683-700, target de xuat = `presentation/co4e/canvas_interaction_mixin.py` — ghi chu 'cat ngang lat, than try chua dong o dong 700, con tiep'. +- Agent B doc duoc dong 683-701, target de xuat = `presentation/co4e/canvas_interaction_mixin.py` — ghi chu 'chi dong 701 (e.acceptProposedAction()) nam trong lat duoc giao; dong 702 la dong trong cuoi file'. +- **Da doi chieu truc tiep voi `ui/co4e_canvas.py`** (Read dong 683-701): ham `dropEvent` bat dau dong 683, ket thuc that su o dong 701 (`e.acceptProposedAction()`); `wc -l` xac nhan file co dung 701 dong. +- **Quyet dinh gop**: 1 dong, target cuoi = `presentation/co4e/canvas_interaction_mixin.py`, dong 683-701. +- Doi chieu voi bang cu: bang cu (`co4e-split-map.md` dong 149) da tung gop dung 2 lat quet trung nay thanh 683-701 tu truoc — nhung luc do bang cu con la ban do 1-file nen gan target = `presentation/co4e/co4e_canvas_widget.py`. Ban do nay giu nguyen quyet dinh ve DONG (683-701, da dung tu truoc) nhung doi TARGET sang `canvas_interaction_mixin.py` vi day la mixin xu ly su kien keo-tha, khong phai du lieu do thi thuan. + +## Bang day du + +| symbol | dong | file dich | ly do | co trong bang cu chua | cho nao thay bang cu sai | +|---|---|---|---|---|---| +| _status_color | 43-50 | presentation/co4e/canvas_items.py | đọc current_palette() từ theme.py — cần import theme trong file đích mới | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem | 59-210 | presentation/co4e/canvas_items.py | QGraphicsObject — cần QApplication để khởi tạo trong test; giữ self.canvas tham chiếu ngược Co4ECanvas (co4e_canvas_widget.py) — coupling hai chiều | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.__init__ | 62-72 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.node | 64 | presentation/co4e/canvas_items.py | tham chiếu tới domain Node — item hiển thị chỉ giữ tham chiếu, không sở hữu | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.canvas | 65 | presentation/co4e/canvas_items.py | tham chiếu ngược Co4ECanvas (co4e_canvas_widget.py) — item gọi canvas._connect_from, canvas.begin_port_drag/update_port_drag/finish_port_drag (canvas_interaction_mixin.py), canvas._reposition_edges, canvas.graph_changed, canvas.node_selected/node_activated, canvas.add_step_below/begin_connect/delete_node — coupling xuyên 3 file | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.status | 66 | presentation/co4e/canvas_items.py | được set từ ngoài bởi Co4ECanvas.update_node_status/reset_statuses (co4e_canvas_widget.py) — trạng thái chia sẻ | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem._porting | 67 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.boundingRect | 74-76 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem._card_rect | 78-79 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.paint | 81-139 | presentation/co4e/canvas_items.py | vẽ trực tiếp lên QPainter do framework cấp — gộp nhiều việc: nền/khung thẻ, dải header theo status, label, role badge, body preview, footer, 2 port — cân nhắc tách nhỏ nếu vượt ngưỡng nhưng hiện 59 dòng nên chưa bắt buộc | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem._in_out_port | 141-143 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.itemChange | 145-156 | presentation/co4e/canvas_items.py | gọi self.canvas._reposition_edges/graph_changed.emit/node_selected.emit — trạng thái chia sẻ với co4e_canvas_widget.py | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.hoverMoveEvent | 158-161 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.mousePressEvent | 163-174 | presentation/co4e/canvas_items.py | đọc self.canvas._connect_from, gọi self.canvas.begin_port_drag — trạng thái/luồng chia sẻ với canvas_interaction_mixin.py | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.mouseMoveEvent | 176-181 | presentation/co4e/canvas_items.py | gọi self.canvas.update_port_drag — canvas_interaction_mixin.py | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.mouseReleaseEvent | 183-189 | presentation/co4e/canvas_items.py | gọi self.canvas.finish_port_drag — canvas_interaction_mixin.py | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.mouseDoubleClickEvent | 191-193 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.contextMenuEvent | 195-207 | presentation/co4e/canvas_items.py | gọi self.canvas.add_step_below/begin_connect (co4e_canvas_widget.py, canvas_interaction_mixin.py) và self.canvas.delete_node (co4e_canvas_widget.py) — coupling 3 file | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _NodeItem.center | 209-210 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem | 213-286 | presentation/co4e/canvas_items.py | QGraphicsPathItem — giữ self.canvas tham chiếu ngược Co4ECanvas | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem.__init__ | 214-225 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem.edge | 216 | presentation/co4e/canvas_items.py | tham chiếu domain Edge | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem.canvas | 217 | presentation/co4e/canvas_items.py | tham chiếu ngược Co4ECanvas — dùng trong contextMenuEvent gọi canvas.delete_edge (co4e_canvas_widget.py) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem._dst | 218 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem._hover | 224 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem._apply_pen | 227-235 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem.update_path | 237-239 | presentation/co4e/canvas_items.py | gọi _rounded_path từ canvas_geometry.py — được gọi bởi Co4ECanvas._reposition_edges (co4e_canvas_widget.py) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem.boundingRect | 241-242 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem.shape | 244-249 | presentation/co4e/canvas_items.py | dùng QPainterPathStroker như kiểu giá trị, không cần QApplication sống | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem.hoverEnterEvent | 251-255 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem.hoverLeaveEvent | 257-261 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem.paint | 263-279 | presentation/co4e/canvas_items.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| _EdgeItem.contextMenuEvent | 281-286 | presentation/co4e/canvas_items.py | gọi self.canvas.delete_edge — co4e_canvas_widget.py | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach _NodeItem/_EdgeItem/_status_color thanh file rieng). Ban do nay tach canvas_items.py vi day la QGraphicsObject/QGraphicsPathItem hien thi thuan, tach khoi Co4ECanvas (QGraphicsView) de giam kich thuoc file va tach lop 've' khoi lop 'dieu khien do thi'. | +| Co4ECanvas | 289-700 | presentation/co4e/co4e_canvas_widget.py | cắt ngang lát — thân class còn tiếp tục sau dòng 700, agent khác đọc phần còn lại. QGraphicsView — cần chia thành co4e_canvas_widget.py (dữ liệu đồ thị: load/add/delete/relayout) và canvas_interaction_mixin.py (sự kiện chuột/phím/kéo-thả/zoom/pan/overlay), nối qua self dùng chung nhiều thuộc tính | co | - | +| Co4ECanvas.node_selected | 290 | presentation/co4e/co4e_canvas_widget.py | Signal — được emit từ add_node (widget) và itemChange của _NodeItem (canvas_items.py) — API công khai xuyên file, callers ngoài (co4e_tab.py) kết nối vào | co | - | +| Co4ECanvas.node_activated | 291 | presentation/co4e/co4e_canvas_widget.py | Signal — emit từ _NodeItem.mouseDoubleClickEvent (canvas_items.py) | co | - | +| Co4ECanvas.graph_changed | 292 | presentation/co4e/co4e_canvas_widget.py | Signal — emit từ nhiều nơi cả widget (add_node/delete_node/relayout...) lẫn item (itemChange trong canvas_items.py) — điểm nối quan trọng giữa 2 file | co | - | +| Co4ECanvas._ZOOM_MIN | 294 | presentation/co4e/co4e_canvas_widget.py | hằng lớp dùng bởi _zoom_by trong canvas_interaction_mixin.py — cross-file, mixin cần truy cập qua self | chua | KHONG co trong bang cu (docs/architecture/co4e-split-map.md) — bang do nhay thang tu dong 292 (graph_changed) sang dong 296 (__init__), bo qua dong 294 (_ZOOM_MIN, _ZOOM_MAX) hoan toan. Day la thieu sot cua bang cu, khong phai sai target. | +| Co4ECanvas._ZOOM_MAX | 294 | presentation/co4e/co4e_canvas_widget.py | hằng lớp dùng bởi _zoom_by trong canvas_interaction_mixin.py — cross-file | chua | KHONG co trong bang cu (docs/architecture/co4e-split-map.md) — bang do nhay thang tu dong 292 (graph_changed) sang dong 296 (__init__), bo qua dong 294 (_ZOOM_MIN, _ZOOM_MAX) hoan toan. Day la thieu sot cua bang cu, khong phai sai target. | +| Co4ECanvas.__init__ | 296-315 | presentation/co4e/co4e_canvas_widget.py | khởi tạo cả trạng thái đồ thị (self._scene/_nodes/_edges) LẪN trạng thái tương tác (self._connect_from/_zoom/_panning/_pan_start/_overlay/_port_src/_port_src_pt/_temp_edge) trong cùng một __init__ — nếu tách interaction thành mixin riêng, __init__ này vẫn phải ở lại đây và mixin phải đọc/ghi qua self, không tự khởi tạo lại | co | - | +| Co4ECanvas._scene | 299 | presentation/co4e/co4e_canvas_widget.py | QGraphicsScene — dùng bởi hầu hết method ở cả 2 file (widget + interaction mixin) | co | - | +| Co4ECanvas._nodes | 305 | presentation/co4e/co4e_canvas_widget.py | dict id->_NodeItem — trạng thái chia sẻ: đọc/ghi bởi cả co4e_canvas_widget.py (add_node/delete_node/load/relayout) và canvas_interaction_mixin.py (_node_at, keyPressEvent xoá selection) | co | - | +| Co4ECanvas._edges | 306 | presentation/co4e/co4e_canvas_widget.py | list _EdgeItem — trạng thái chia sẻ tương tự self._nodes | co | - | +| Co4ECanvas._connect_from | 307 | presentation/co4e/co4e_canvas_widget.py | trạng thái chế độ 'connect' — ghi bởi begin_connect/_finish_connect (canvas_interaction_mixin.py) và keyPressEvent (Escape, cùng file), đọc bởi _NodeItem.mousePressEvent (canvas_items.py) — coupling 3 file | co | - | +| Co4ECanvas._zoom | 308 | presentation/co4e/co4e_canvas_widget.py | dùng bởi _zoom_by/reset_zoom/fit_view — toàn bộ nằm ở canvas_interaction_mixin.py, chỉ khởi tạo ở đây | co | - | +| Co4ECanvas._panning | 309 | presentation/co4e/co4e_canvas_widget.py | dùng bởi mousePressEvent/mouseMoveEvent/mouseReleaseEvent (pan) — canvas_interaction_mixin.py | co | - | +| Co4ECanvas._pan_start | 310 | presentation/co4e/co4e_canvas_widget.py | canvas_interaction_mixin.py | co | - | +| Co4ECanvas._overlay | 311 | presentation/co4e/co4e_canvas_widget.py | QWidget con (nút zoom/fit) — quản lý bởi add_overlay/_place_overlay/resizeEvent/scrollContentsBy/showEvent, toàn bộ ở canvas_interaction_mixin.py | co | - | +| Co4ECanvas._port_src | 313 | presentation/co4e/co4e_canvas_widget.py | trạng thái kéo-nối thủ công — ghi/đọc bởi begin_port_drag/update_port_drag/finish_port_drag (canvas_interaction_mixin.py) và keyPressEvent (Escape huỷ, cùng file); _NodeItem (canvas_items.py) khởi phát qua self.canvas.begin_port_drag | co | - | +| Co4ECanvas._port_src_pt | 314 | presentation/co4e/co4e_canvas_widget.py | canvas_interaction_mixin.py | co | - | +| Co4ECanvas._temp_edge | 315 | presentation/co4e/co4e_canvas_widget.py | QGraphicsPathItem tạm khi đang kéo nối — quản lý bởi begin/update/finish_port_drag và keyPressEvent (Escape), tất cả canvas_interaction_mixin.py | co | - | +| Co4ECanvas.add_overlay | 318-323 | presentation/co4e/canvas_interaction_mixin.py | widget.setParent/show/raise_ — cần Qt sống | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas._place_overlay | 325-330 | presentation/co4e/canvas_interaction_mixin.py | đọc vp.height() — cần viewport thật | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.resizeEvent | 332-334 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.scrollContentsBy | 336-341 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.showEvent | 343-345 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.load | 348-362 | presentation/co4e/co4e_canvas_widget.py | reset toàn bộ self._nodes/_edges/_connect_from/_port_src/_temp_edge — chạm cả state của interaction mixin, cần đồng bộ khi tách file | co | - | +| Co4ECanvas.nodes | 364-365 | presentation/co4e/co4e_canvas_widget.py | (khong co ghi chu) | co | - | +| Co4ECanvas.edges | 367-368 | presentation/co4e/co4e_canvas_widget.py | (khong co ghi chu) | co | - | +| Co4ECanvas.add_node | 371-382 | presentation/co4e/co4e_canvas_widget.py | emit graph_changed và node_selected | co | - | +| Co4ECanvas.add_step_below | 384-390 | presentation/co4e/co4e_canvas_widget.py | (khong co ghi chu) | co | - | +| Co4ECanvas._chain_tail | 392-396 | presentation/co4e/co4e_canvas_widget.py | (khong co ghi chu) | co | - | +| Co4ECanvas.add_palette_step | 398-400 | presentation/co4e/co4e_canvas_widget.py | (khong co ghi chu) | co | - | +| Co4ECanvas.begin_connect | 402-403 | presentation/co4e/canvas_interaction_mixin.py | ghi self._connect_from — đọc bởi _NodeItem.mousePressEvent (canvas_items.py) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas._finish_connect | 405-409 | presentation/co4e/canvas_interaction_mixin.py | gọi self._make_edge (co4e_canvas_widget.py) — cross-file | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.begin_port_drag | 412-419 | presentation/co4e/canvas_interaction_mixin.py | tạo self._temp_edge, thêm vào self._scene — được _NodeItem.mousePressEvent (canvas_items.py) gọi qua self.canvas | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.update_port_drag | 421-424 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.finish_port_drag | 426-435 | presentation/co4e/canvas_interaction_mixin.py | gọi self._make_edge (co4e_canvas_widget.py) — cross-file | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas._node_at | 437-441 | presentation/co4e/canvas_interaction_mixin.py | duyệt self._scene.items — cần import _NodeItem từ canvas_items.py | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas._make_edge | 443-451 | presentation/co4e/co4e_canvas_widget.py | được gọi từ canvas_interaction_mixin.py (_finish_connect, finish_port_drag) — cross-file | co | - | +| Co4ECanvas._add_edge_item | 453-456 | presentation/co4e/co4e_canvas_widget.py | tạo _EdgeItem — cần import từ canvas_items.py | co | - | +| Co4ECanvas.delete_edge | 458-463 | presentation/co4e/co4e_canvas_widget.py | được gọi bởi _EdgeItem.contextMenuEvent (canvas_items.py) | co | - | +| Co4ECanvas.delete_node | 465-475 | presentation/co4e/co4e_canvas_widget.py | được gọi bởi _NodeItem.contextMenuEvent (canvas_items.py) | co | - | +| Co4ECanvas.delete_selected | 477-481 | presentation/co4e/co4e_canvas_widget.py | được gọi bởi keyPressEvent (canvas_interaction_mixin.py) — cross-file | co | - | +| Co4ECanvas._zoom_by | 484-495 | presentation/co4e/canvas_interaction_mixin.py | dùng self._ZOOM_MIN/_ZOOM_MAX định nghĩa ở class Co4ECanvas (co4e_canvas_widget.py) — cross-file qua self, ghi self._zoom | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.zoom_in | 497-498 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.zoom_out | 500-501 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.reset_zoom | 503-505 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.wheelEvent | 507-519 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.mousePressEvent | 522-529 | presentation/co4e/canvas_interaction_mixin.py | xử lý pan bằng chuột giữa — trùng tên method với _NodeItem.mousePressEvent (canvas_items.py) nhưng khác lớp, không xung đột thật nhưng dễ nhầm khi tách | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.mouseMoveEvent | 531-540 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.mouseReleaseEvent | 542-548 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.fit_view | 550-558 | presentation/co4e/canvas_interaction_mixin.py | fitInView phụ thuộc kích thước viewport thật | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.relayout | 560-578 | presentation/co4e/co4e_canvas_widget.py | gọi compute_waves (core/co4e.py) và self._reposition_edges — thuật toán xếp lớp thuần dữ liệu | co | - | +| Co4ECanvas.relayout_if_vertical | 580-589 | presentation/co4e/co4e_canvas_widget.py | (khong co ghi chu) | co | - | +| Co4ECanvas.add_workflow | 591-610 | presentation/co4e/co4e_canvas_widget.py | được dropEvent (canvas_interaction_mixin.py) gọi khi kéo thả cả workflow — cross-file | co | - | +| Co4ECanvas.update_node_status | 612-616 | presentation/co4e/co4e_canvas_widget.py | ghi _NodeItem.status (canvas_items.py) — cross-file | co | - | +| Co4ECanvas.reset_statuses | 618-621 | presentation/co4e/co4e_canvas_widget.py | (khong co ghi chu) | co | - | +| Co4ECanvas.refresh_node | 623-626 | presentation/co4e/co4e_canvas_widget.py | (khong co ghi chu) | co | - | +| Co4ECanvas._node_rects | 628-638 | presentation/co4e/co4e_canvas_widget.py | dùng QRectF như kiểu giá trị | co | - | +| Co4ECanvas._reposition_edges | 640-649 | presentation/co4e/co4e_canvas_widget.py | gọi _route từ canvas_geometry.py và e.update_path (_EdgeItem trong canvas_items.py) — cross-file | co | - | +| Co4ECanvas.keyPressEvent | 652-669 | presentation/co4e/canvas_interaction_mixin.py | Escape huỷ self._connect_from/self._temp_edge/self._port_src (khởi tạo ở __init__ trong co4e_canvas_widget.py) — cross-file; Delete gọi self.delete_selected (co4e_canvas_widget.py) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.dragEnterEvent | 671-675 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.dragMoveEvent | 677-681 | presentation/co4e/canvas_interaction_mixin.py | (khong co ghi chu) | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | +| Co4ECanvas.dropEvent | 683-701 | presentation/co4e/canvas_interaction_mixin.py | GOP 2 luot quet trung ky hieu: agent 1 doc duoc 683-700 (than try chua dong, cat ngang lat o ranh gioi doc 701-701), agent 2 doc duoc 683-701 (chi dong 701 e.acceptProposedAction() nam trong lat duoc giao, dong 702 la dong trong cuoi file). Doi chieu truc tiep voi ui/co4e_canvas.py xac nhan than ham thuc su ket thuc o dong 701 (701 dong tong cong ca file) -> chon 683-701. Xu ly drop tu sidebar: kind=='workflow' -> add_workflow, nguoc lai -> add_palette_step; import cuc bo workflow_from_dict/step_from_dict tu core/co4e.py; goi self.add_workflow/self.add_palette_step (co4e_canvas_widget.py) -> cross-file. Khong cham dia/mang, chi json.loads tu bytes mime trong bo nho. | co | Bang cu gop chung vao presentation/co4e/co4e_canvas_widget.py (chua tach nhom su kien chuot/phim/keo-tha/zoom/pan/overlay ra mixin rieng). Ban do nay tach canvas_interaction_mixin.py theo dung de xuat trong note cua chinh scan Co4ECanvas o bang cu (dong 90: 'can chia thanh co4e_canvas_widget.py ... va canvas_interaction_mixin.py'). | + +## Cho thay khac tai lieu — can nguoi quyet + +Khong co symbol nao trong 96 dong quet mang note bat dau bang `khac tai lieu:` (da kiem bang script, dem duoc 0). Muc nay de trong theo dung yeu cau tu kiem; khong co gi can nguoi quyet tu tieu chi nay. + +Tuy nhien co 2 nhom lech thuc te voi bang cu toan file, liet ke de nguoi soat bien: + +1. **2 symbol thieu hoan toan trong bang cu**: `Co4ECanvas._ZOOM_MIN`, `Co4ECanvas._ZOOM_MAX` (dong 294) — bang cu nhay tu dong 292 sang 296, bo sot hang class-constant nay. +2. **57 symbol co trong bang cu nhung target khac** — bang cu (1-file) gop tat ca vao `presentation/co4e/co4e_canvas_widget.py`; ban do nay tach thanh 3 file (`canvas_items.py` cho _NodeItem/_EdgeItem/_status_color, `canvas_interaction_mixin.py` cho nhom su kien chuot/phim/keo-tha/zoom/pan/overlay, phan con lai o lai `co4e_canvas_widget.py`). Day la tach chi tiet hon, phu hop voi chinh ghi chu cua scan Co4ECanvas trong bang cu (dong 90) da de xuat huong tach nay. diff --git a/docs/architecture/co4e-split-map-chat-view.json b/docs/architecture/co4e-split-map-chat-view.json new file mode 100644 index 0000000..be675bb --- /dev/null +++ b/docs/architecture/co4e-split-map-chat-view.json @@ -0,0 +1,3079 @@ +{ + "lane": "chat-view (khung Chat / Messages / composer)", + "source_file_scanned": "ui/co4e_tab.py", + "generated_from_raw_symbol_count": 220, + "raw_scan_agents": 3, + "final_row_count": 218, + "chat_view_target": "presentation/co4e/co4e_chat_view.py", + "container_target": "ui/co4e_tab.py", + "chat_view_symbol_count": 21, + "container_symbol_count": 197, + "other_lane_symbol_count": 0, + "khac_tai_lieu_notes_found": 0, + "merged_duplicate_symbol_groups": [ + "Co4ETab._reload_sidebar (dong 686 va 701, 2 luot quet trung, gop thanh 686-719)", + "Co4ETab._run_from (dong 1399 va unknown_method_fragment_before_1401 dong 1401, 2 luot quet trung, gop thanh 1399-1403)" + ], + "kept_separate_anomaly_symbols": [ + "Co4ETab.showEvent (2 dinh nghia cung ten trong 1 class -- anomaly co that trong source, ban thu 2 (dong 1772-1775) de len ban dau (dong 939-941) luc runtime; khop voi 'kept_separate_anomaly_symbols' cua ca bang cu va ban do run-control)" + ], + "old_table_reference": "docs/architecture/co4e-split-map.json", + "systemic_old_table_finding": "Bang cu dung target_file='presentation/co4e/co4e_tab.py' cho toan bo than con lai cua lop Co4ETab (75 dong), nhung file do o repo hien tai chi la factory build_co4e_tab() mong (~53 dong, boc nguyen Co4ETab cu 1:1) -- KHONG phai noi lop Co4ETab that su song. Lop do van dang o ui/co4e_tab.py. Da xac nhan lai phat hien nay tu ban do run-control (docs/architecture/co4e-split-map-run-control.md, muc 1). Ban do nay tu quy doi 'presentation/co4e/co4e_tab.py' -> 'ui/co4e_tab.py' truoc khi ket luan lech o cot cuoi cung.", + "scope_narrowing_finding": "Bang cu (50 dong, luc no duoc quet) coi 'chat view' theo nghia rong: gom ca KHUNG widget (header Messages, QStackedWidget chat_stack, composer, _ChatInput, RoutingToggle) LAN toan bo business logic dieu phoi luot chat (_chat_send, _apply_co4e_routing, _run_chat_turn va 4 closure long ben trong, _extract_agent_directive, _resolve_agent, _append_chat/_append_diff/_append_plan, _fmt_usage/_apply_usage/_refresh_usage_total, _toggle_messages/_ensure_flow_log/_active_log/chat_log/_plan_bubble). Mo ta dich cua lan quet 3-agent hien tai (lap lai trong tung ghi chu rieng le, tu khoa 'theo yeu cau KHONG thuoc co4e_chat_view.py') thu hep pham vi presentation/co4e/co4e_chat_view.py CHI con la KHUNG WIDGET thuan tuy: _ChatInput + _directive_token, va phan _build_chat dung UI (header/composer/stack) cua Co4ETab. Toan bo business logic dieu phoi luot chat, quan ly log per-flow, usage va routing o LAI ui/co4e_tab.py. Day la khac biet lon nhat giua bang cu va ban do nay -- anh huong toi hon 20 dong ben duoi (xem cot cuoi cung cua tung dong lien quan).", + "plan_glyph_and_friends_finding": "_PLAN_GLYPH, _fmt_plan, _skill_names, _agent_names, _qcolor la cac symbol PHUC VU chat (glyph/format cho bong bong 'plan', autocomplete /skill /agent trong o nhap, mau cot trang thai) nhung bang cu lai xep chung vao presentation/co4e/co4e_run_control_widget.py (khong phai chat_view.py, cung khong phai ui/co4e_tab.py) -- cung sai giong he phat hien da ghi nhan o ban do run-control cho chinh 4 symbol nay (_PLAN_GLYPH, _fmt_plan, _qcolor) cong them 2 symbol moi (_skill_names, _agent_names) chua tung duoc doi chieu truoc do. Ly do cac symbol nay o lai ui/co4e_tab.py thay vi chat_view.py: _skill_names/_agent_names duoc dung o nhieu noi trong file (khong chi trong composer chat), con _PLAN_GLYPH/_fmt_plan phuc vu _append_plan (business logic, KHONG thuoc widget) va _qcolor la kieu gia tri dung trong _refresh_runs (khong lien quan chat).", + "khac_tai_lieu_rows": [], + "rows": [ + { + "symbol": "_PLAN_GLYPH", + "kind": "attribute", + "line_start": 47, + "line_end": 48, + "line_display": "47-48", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "hằng số module dùng bởi _fmt_plan cho việc hiển thị plan trong chat log — thuộc business logic của Co4ETab, không phải khung widget chat", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 45-46) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "_fmt_plan", + "kind": "function", + "line_start": 51, + "line_end": 60, + "line_display": "51-60", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "dùng bởi _append_plan (business logic per-flow, ở lại Co4ETab theo mô tả target)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 49-58) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "_skill_names", + "kind": "function", + "line_start": 63, + "line_end": 67, + "line_display": "63-67", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "đọc skills từ đĩa qua core.skills.list_skills/builtin_skills; dùng ở nhiều nơi trong file (dòng 164, 714, 1294, 1321, 1344) không chỉ trong chat composer nên không chuyển riêng vào co4e_chat_view.py", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 61-65) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "_agent_names", + "kind": "function", + "line_start": 70, + "line_end": 73, + "line_display": "70-73", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "đọc agents từ đĩa qua core.co4e.list_custom_agents; dùng ở nhiều nơi (dòng 168 và ngoài phạm vi đọc), giữ ở Co4ETab như _skill_names", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 68-71) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "_EqualTabBar", + "kind": "class", + "line_start": 76, + "line_end": 96, + "line_display": "76-96", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "không thấy chỗ nào khởi tạo _EqualTabBar trong toàn file (grep 'flow_bar =' cho thấy dùng QTabBar thường ở dòng 735) — có thể là code chết, cần người quyết có xoá hay giữ -- QUYET DINH: khong tim thay noi nao khoi tao _EqualTabBar trong toan file (flow_bar dung QTabBar thuong o dong 735) -- co the la code chet, nhung du con hay khong no la mot QTabBar tien ich cho sidebar icon-tabs, KHONG lien quan chat -- khop voi quyet dinh da chot cho cung symbol nay o lane run-control (ui/co4e_tab.py).", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_EqualTabBar.tabSizeHint", + "kind": "method", + "line_start": 84, + "line_end": 92, + "line_display": "84-92", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "thuộc _EqualTabBar — xem note ở class, có vẻ không còn dùng -- QUYET DINH: thuoc _EqualTabBar -- xem ly do o class, khong lien quan chat.", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_EqualTabBar.resizeEvent", + "kind": "method", + "line_start": 94, + "line_end": 96, + "line_display": "94-96", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "thuộc _EqualTabBar — xem note ở class -- QUYET DINH: thuoc _EqualTabBar -- xem ly do o class, khong lien quan chat.", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_PaletteList", + "kind": "class", + "line_start": 99, + "line_end": 121, + "line_display": "99-121", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "dùng cho wf_list ở sidebar (drag workflow lên canvas), không liên quan chat view", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `unsure` (dong 97-119) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "_PaletteList.__init__", + "kind": "method", + "line_start": 104, + "line_end": 108, + "line_display": "104-108", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `unsure` (dong 102-106) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "_PaletteList.startDrag", + "kind": "method", + "line_start": 110, + "line_end": 121, + "line_display": "110-121", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `unsure` (dong 108-119) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "_directive_token", + "kind": "function", + "line_start": 124, + "line_end": 136, + "line_display": "124-136", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "chỉ được gọi bởi _ChatInput (dòng 156, 194) — hàm thuần Python phục vụ autocomplete của ô nhập chat, nên đi cùng _ChatInput", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput", + "kind": "class", + "line_start": 139, + "line_end": 228, + "line_display": "139-228", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "ô nhập của composer — nằm trong phạm vi widget khung chat theo mô tả target", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput.submit", + "kind": "attribute", + "line_start": 143, + "line_end": 143, + "line_display": "143", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "Signal lớp, phát khi Enter được nhấn — Co4ETab._chat_send (nằm ngoài phạm vi đọc) sẽ nối vào signal này từ bên ngoài widget", + "merge_note": null, + "in_old_table": "chua", + "old_table_mismatch": "BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam)." + }, + { + "symbol": "_ChatInput.__init__", + "kind": "method", + "line_start": 145, + "line_end": 153, + "line_display": "145-153", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput._maybe_popup", + "kind": "method", + "line_start": 155, + "line_end": 180, + "line_display": "155-180", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "gọi _skill_names()/_agent_names() (đọc đĩa) để dựng popup gợi ý — phần Qt (định vị popup, resize) đòi QWidget sống", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput._add_row", + "kind": "method", + "line_start": 182, + "line_end": 186, + "line_display": "182-186", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput._accept", + "kind": "method", + "line_start": 188, + "line_end": 201, + "line_display": "188-201", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput.focusOutEvent", + "kind": "method", + "line_start": 203, + "line_end": 206, + "line_display": "203-206", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput.keyPressEvent", + "kind": "method", + "line_start": 208, + "line_end": 228, + "line_display": "208-228", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "phát submit khi Enter và popup không hiện — Co4ETab nối submit -> _chat_send ở ngoài widget", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab", + "kind": "class", + "line_start": 231, + "line_end": 700, + "line_display": "231-700", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "cắt ngang lát — cần agent gộp đối chiếu (class tiếp tục sau dòng 700)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.status_message", + "kind": "attribute", + "line_start": 232, + "line_end": 232, + "line_display": "232", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "Signal lớp", + "merge_note": null, + "in_old_table": "chua", + "old_table_mismatch": "BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam)." + }, + { + "symbol": "Co4ETab.__init__", + "kind": "method", + "line_start": 234, + "line_end": 306, + "line_display": "234-306", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "dựng toàn bộ layout 3 cột (sidebar/center/config); chưa thấy lệnh dựng chat panel trong phạm vi 1-700 — có thể nằm trong _build_center() ở dòng > 700", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.ctx", + "kind": "attribute", + "line_start": 236, + "line_end": 236, + "line_display": "236", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._wf", + "kind": "attribute", + "line_start": 237, + "line_end": 237, + "line_display": "237", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "trạng thái chia sẻ rộng — flow đang hiển thị trên canvas; nhiều method (kể cả chat log lookup ngoài phạm vi đọc) phụ thuộc vào self._wf", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._chat_worker", + "kind": "attribute", + "line_start": 238, + "line_end": 238, + "line_display": "238", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "AgentWorker của chat — theo mô tả target, _chat_send/job()/AgentWorker KHÔNG chuyển vào co4e_chat_view.py, ở lại Co4ETab", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 236) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.manager", + "kind": "attribute", + "line_start": 240, + "line_end": 240, + "line_display": "240", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "Co4ERunManager — đã có RunsPagePanel/co4e_run_control_widget.py riêng, nhưng self.manager là thuộc tính của Co4ETab, ở lại", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 238) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._flow_runs", + "kind": "attribute", + "line_start": 245, + "line_end": 245, + "line_display": "245", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "trạng thái chia sẻ: wf_id -> run_id đang chạy trên canvas, dùng bởi nhiều method flow tab", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 243) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._run_logs", + "kind": "attribute", + "line_start": 246, + "line_end": 246, + "line_display": "246", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "map run_id -> ChatView; theo mô tả target đây là business logic per-flow, ở lại Co4ETab dù ChatView instance được hiển thị trong QStackedWidget của co4e_chat_view.py", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 244) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._flow_outputs", + "kind": "attribute", + "line_start": 247, + "line_end": 247, + "line_display": "247", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 245) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._flow_usage", + "kind": "attribute", + "line_start": 250, + "line_end": 250, + "line_display": "250", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "usage per-flow (↓in ↑out ▤ctx $cost) — hiển thị ở label usage-total trong composer của co4e_chat_view.py, nhưng dữ liệu và logic tính toán ở lại Co4ETab (chỉ phần dựng label rỗng thuộc chat_view)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 248) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._project_id", + "kind": "attribute", + "line_start": 251, + "line_end": 251, + "line_display": "251", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `unsure` (dong 249) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._project_dir", + "kind": "attribute", + "line_start": 252, + "line_end": 252, + "line_display": "252", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `unsure` (dong 250) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._manual_active", + "kind": "attribute", + "line_start": 254, + "line_end": 254, + "line_display": "254", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 252) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._manual_order", + "kind": "attribute", + "line_start": 255, + "line_end": 255, + "line_display": "255", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 253) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._manual_idx", + "kind": "attribute", + "line_start": 256, + "line_end": 256, + "line_display": "256", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 254) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._flows", + "kind": "attribute", + "line_start": 259, + "line_end": 259, + "line_display": "259", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "trạng thái chia sẻ — danh sách flow đang mở dạng tab kiểu trình duyệt, dùng bởi hầu hết method _*flow_tab*", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._active_flow_idx", + "kind": "attribute", + "line_start": 260, + "line_end": 260, + "line_display": "260", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._split", + "kind": "attribute", + "line_start": 263, + "line_end": 263, + "line_display": "263", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.config", + "kind": "attribute", + "line_start": 270, + "line_end": 270, + "line_display": "270", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "StepConfigPanel — đã tách sang presentation/co4e/node_property_panel.py ở làn khác; thuộc tính self.config trên Co4ETab ở lại đây", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 268) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._config_collapsed", + "kind": "attribute", + "line_start": 276, + "line_end": 276, + "line_display": "276", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._config_expanded_w", + "kind": "attribute", + "line_start": 277, + "line_end": 277, + "line_display": "277", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._narrow_guard", + "kind": "attribute", + "line_start": 282, + "line_end": 282, + "line_display": "282", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._open_flow", + "kind": "method", + "line_start": 309, + "line_end": 340, + "line_display": "309-340", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc/ghi self._flows, self.flow_bar — trạng thái chia sẻ giữa các flow tab", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._close_other_flows", + "kind": "method", + "line_start": 342, + "line_end": 357, + "line_display": "342-357", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "self._flows, self._active_flow_idx", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._show_runs", + "kind": "method", + "line_start": 359, + "line_end": 369, + "line_display": "359-369", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "self.flow_bar dùng chung với logic mở flow tab", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._on_flow_tab_changed", + "kind": "method", + "line_start": 371, + "line_end": 387, + "line_display": "371-387", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc self.center_stack (được gán ở ngoài phạm vi đọc, có thể trong _build_center) — trạng thái chia sẻ quan trọng theo mô tả của team", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._sync_runs_toggle", + "kind": "method", + "line_start": 389, + "line_end": 396, + "line_display": "389-396", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._add_tab_close_button", + "kind": "method", + "line_start": 398, + "line_end": 408, + "line_display": "398-408", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._close_flow_tab_button", + "kind": "method", + "line_start": 410, + "line_end": 414, + "line_display": "410-414", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._close_flow_tab", + "kind": "method", + "line_start": 416, + "line_end": 444, + "line_display": "416-444", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "self._flows, self._flow_runs, self._run_logs — trạng thái chia sẻ giữa flow tab và run log của chat", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._sync_active_flow_tab_text", + "kind": "method", + "line_start": 446, + "line_end": 449, + "line_display": "446-449", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._reflect_active_run", + "kind": "method", + "line_start": 451, + "line_end": 459, + "line_display": "451-459", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "self._flow_runs, self.canvas — canvas là thuộc tính được gán ngoài phạm vi đọc", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `unsure` (dong 449-457) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._cur_run_id", + "kind": "method", + "line_start": 462, + "line_end": 475, + "line_display": "462-475", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "self._wf, self._flow_runs — logic thuần, không đụng Qt trực tiếp (chỉ đọc self._wf là attribute)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 460-473) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._outputs_for", + "kind": "method", + "line_start": 477, + "line_end": 480, + "line_display": "477-480", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "self._flow_outputs — logic thuần", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 475-478) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._update_run_btn", + "kind": "method", + "line_start": 482, + "line_end": 484, + "line_display": "482-484", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "self.run_btn được gán ngoài phạm vi đọc", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 480-482) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._build_sidebar", + "kind": "method", + "line_start": 487, + "line_end": 600, + "line_display": "487-600", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "method dài 113 dòng, gộp nhiều việc không liên quan: dựng section Workflows (list+CRUD+run-bg), section Agents (AgentListPanel), section Skills (SkillsListPanel), và section Runs (danh sách rút gọn) — nên tách thành các hàm _build_workflows_section/_build_agents_section/_build_skills_section/_build_runs_section riêng", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._sections", + "kind": "attribute", + "line_start": 495, + "line_end": 495, + "line_display": "495", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "trạng thái chia sẻ giữa _section/_fold_section/_sync_section_arrow — map key -> (header, body, stretch)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.sidebar", + "kind": "attribute", + "line_start": 496, + "line_end": 496, + "line_display": "496", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.side_split", + "kind": "attribute", + "line_start": 500, + "line_end": 500, + "line_display": "500", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._build_sidebar.._Col", + "kind": "class", + "line_start": 505, + "line_end": 514, + "line_display": "505-514", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "lớp adapter cục bộ bên trong _build_sidebar, bọc QSplitter để các section builder gọi .addWidget(w, stretch) như trước", + "merge_note": null, + "in_old_table": "chua", + "old_table_mismatch": "BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam)." + }, + { + "symbol": "Co4ETab._build_sidebar.._Col.__init__", + "kind": "method", + "line_start": 508, + "line_end": 509, + "line_display": "508-509", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "chua", + "old_table_mismatch": "BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam)." + }, + { + "symbol": "Co4ETab._build_sidebar.._Col.addWidget", + "kind": "method", + "line_start": 511, + "line_end": 513, + "line_display": "511-513", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "chua", + "old_table_mismatch": "BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam)." + }, + { + "symbol": "Co4ETab.wf_new_btn", + "kind": "attribute", + "line_start": 518, + "line_end": 518, + "line_display": "518", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_list", + "kind": "attribute", + "line_start": 529, + "line_end": 529, + "line_display": "529", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_edit_btn", + "kind": "attribute", + "line_start": 536, + "line_end": 536, + "line_display": "536", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_dup_btn", + "kind": "attribute", + "line_start": 537, + "line_end": 537, + "line_display": "537", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_del_btn", + "kind": "attribute", + "line_start": 538, + "line_end": 538, + "line_display": "538", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_runbg_btn", + "kind": "attribute", + "line_start": 545, + "line_end": 545, + "line_display": "545", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._agent_panel", + "kind": "attribute", + "line_start": 557, + "line_end": 557, + "line_display": "557", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "AgentListPanel — widget đã tách sẵn ở làn khác (presentation/co4e/agent_list_panel.py), Co4ETab chỉ giữ tham chiếu và nối signal", + "merge_note": null, + "in_old_table": "chua", + "old_table_mismatch": "BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam)." + }, + { + "symbol": "Co4ETab.ag_new_btn", + "kind": "attribute", + "line_start": 558, + "line_end": 558, + "line_display": "558", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 550) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.agent_list", + "kind": "attribute", + "line_start": 560, + "line_end": 560, + "line_display": "560", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 558) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.ag_edit_btn", + "kind": "attribute", + "line_start": 561, + "line_end": 561, + "line_display": "561", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 562) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.ag_del_btn", + "kind": "attribute", + "line_start": 563, + "line_end": 563, + "line_display": "563", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 563) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._skills_panel", + "kind": "attribute", + "line_start": 572, + "line_end": 572, + "line_display": "572", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "SkillsListPanel — đã tách sẵn ở làn khác (presentation/co4e/skills_list_panel.py)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.sk_manage_btn", + "kind": "attribute", + "line_start": 573, + "line_end": 573, + "line_display": "573", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.skill_list", + "kind": "attribute", + "line_start": 575, + "line_end": 575, + "line_display": "575", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.runs_more_btn", + "kind": "attribute", + "line_start": 583, + "line_end": 583, + "line_display": "583", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 586) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.runs_side_list", + "kind": "attribute", + "line_start": 591, + "line_end": 591, + "line_display": "591", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 594) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._SIDE_RUNS", + "kind": "attribute", + "line_start": 602, + "line_end": 602, + "line_display": "602", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "hằng số lớp", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 605) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._refresh_side_runs", + "kind": "method", + "line_start": 604, + "line_end": 616, + "line_display": "604-616", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "self.manager.runs() — trạng thái run manager", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 607-619) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._on_side_run_clicked", + "kind": "method", + "line_start": 618, + "line_end": 626, + "line_display": "618-626", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "self.runs_table được gán ngoài phạm vi đọc", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 621-629) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._section", + "kind": "method", + "line_start": 628, + "line_end": 660, + "line_display": "628-660", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "ghi vào self._sections — trạng thái chia sẻ", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._fold_section", + "kind": "method", + "line_start": 662, + "line_end": 674, + "line_display": "662-674", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._sync_section_arrow", + "kind": "method", + "line_start": 676, + "line_end": 678, + "line_display": "676-678", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._icon_btn", + "kind": "method", + "line_start": 680, + "line_end": 684, + "line_display": "680-684", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._reload_sidebar", + "kind": "method", + "line_start": 686, + "line_end": 719, + "line_display": "686-719", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "[GOP 2 luot quet trung ky hieu, dong 686] mot agent doc than den 700 (cat ngang lat), agent kia doc tiep 701-719 (vong lap nap agent list + skill list vao palette qua co4e.list_custom_agents()/skills_mod.skill_prefix_for) -- QUYET DINH: nap lai toan bo sidebar (Workflows/Agents/Skills/Runs quick-list), khong lien quan chat -- khop voi quyet dinh da chot o lane run-control (dong 685-718 trong ban do do).", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._palette_item", + "kind": "method", + "line_start": 721, + "line_end": 725, + "line_display": "721-725", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "helper tĩnh dựng QListWidgetItem với icon() — không liên quan chat", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `unsure` (dong 724-728) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._build_center", + "kind": "method", + "line_start": 728, + "line_end": 868, + "line_display": "728-868", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "method dài ~140 dòng, gộp nhiều việc không liên quan: (1) dựng flow tab bar + scroll ẩn (không hiển thị), (2) center_stack + trang Runs, (3) toolbar flow editor (name_edit/add/save/mode/run/runs_btn), (4) canvas + overlay zoom, (5) tích hợp splitter canvas/chat qua self._build_chat(). Nên tách nhỏ thêm. Đọc/ghi self.center_stack, self.canvas, self._vsplit — trạng thái chia sẻ rộng với nhiều nhóm chức năng khác (canvas widget, run control, chat view)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.flow_bar", + "kind": "attribute", + "line_start": 735, + "line_end": 735, + "line_display": "735", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.flow_add_btn", + "kind": "attribute", + "line_start": 761, + "line_end": 761, + "line_display": "761", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.flow_scroll", + "kind": "attribute", + "line_start": 778, + "line_end": 778, + "line_display": "778", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.center_stack", + "kind": "attribute", + "line_start": 802, + "line_end": 802, + "line_display": "802", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "trạng thái chia sẻ — self.center_stack được dùng bởi _build_runs_page, _show_runs và nhiều nơi khác ngoài lát này; chuyển trang giữa Runs table và flow editor", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.name_edit", + "kind": "attribute", + "line_start": 811, + "line_end": 811, + "line_display": "811", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.add_step_btn", + "kind": "attribute", + "line_start": 816, + "line_end": 816, + "line_display": "816", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.save_btn", + "kind": "attribute", + "line_start": 819, + "line_end": 819, + "line_display": "819", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.save_tpl_btn", + "kind": "attribute", + "line_start": 823, + "line_end": 824, + "line_display": "823-824", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.mode_combo", + "kind": "attribute", + "line_start": 825, + "line_end": 825, + "line_display": "825", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 828) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.run_btn", + "kind": "attribute", + "line_start": 830, + "line_end": 830, + "line_display": "830", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 833) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.runs_btn", + "kind": "attribute", + "line_start": 837, + "line_end": 837, + "line_display": "837", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 840) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.canvas", + "kind": "attribute", + "line_start": 853, + "line_end": 853, + "line_display": "853", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "trạng thái chia sẻ rộng — self.canvas đọc/ghi bởi rất nhiều method trong và ngoài lát này (add_blank_step, _on_node_selected, _on_config_changed, _sync_wf_from_canvas, _apply_workflow, _start_canvas_run...)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_canvas_widget.py` (dong 856) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._vsplit", + "kind": "attribute", + "line_start": 860, + "line_end": 860, + "line_display": "860", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "trạng thái chia sẻ — self._vsplit dùng bởi _toggle_messages để co giãn giữa canvas và chat box; đúng như cảnh báo trong đề bài", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._build_runs_page", + "kind": "method", + "line_start": 870, + "line_end": 898, + "line_display": "870-898", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "chỉ wiring RunsPagePanel (đã tách ở co4e_run_control_widget.py, không thuộc lát này) vào handler của Co4ETab — ở lại ui/co4e_tab.py theo đúng mô tả docstring của method", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 873-932) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.runs_back_btn", + "kind": "attribute", + "line_start": 881, + "line_end": 881, + "line_display": "881", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 882) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.runs_title", + "kind": "attribute", + "line_start": 883, + "line_end": 883, + "line_display": "883", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 887) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.ws_folder_btn", + "kind": "attribute", + "line_start": 884, + "line_end": 884, + "line_display": "884", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 892) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.run_stop_btn", + "kind": "attribute", + "line_start": 887, + "line_end": 887, + "line_display": "887", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 900) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.run_rename_btn", + "kind": "attribute", + "line_start": 889, + "line_end": 889, + "line_display": "889", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 905) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.run_del_btn", + "kind": "attribute", + "line_start": 891, + "line_end": 891, + "line_display": "891", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 909) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.run_clear_btn", + "kind": "attribute", + "line_start": 893, + "line_end": 893, + "line_display": "893", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 913) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.runs_table", + "kind": "attribute", + "line_start": 895, + "line_end": 895, + "line_display": "895", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 921) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._wrap_config", + "kind": "method", + "line_start": 900, + "line_end": 930, + "line_display": "900-930", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "không liên quan chat; liên quan node-property config panel (đã tách riêng ở node_property_panel.py, không thuộc lát/target được giao cho agent này)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 934-964) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.config_toggle_btn", + "kind": "attribute", + "line_start": 912, + "line_end": 912, + "line_display": "912", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 946) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.config_title", + "kind": "attribute", + "line_start": 917, + "line_end": 917, + "line_display": "917", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 951) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._cfg_vlayout", + "kind": "attribute", + "line_start": 923, + "line_end": 923, + "line_display": "923", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 957) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._cfg_top_spacer", + "kind": "attribute", + "line_start": 927, + "line_end": 927, + "line_display": "927", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 961) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._cfg_bot_spacer", + "kind": "attribute", + "line_start": 928, + "line_end": 928, + "line_display": "928", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 962) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.config_container", + "kind": "attribute", + "line_start": 929, + "line_end": 929, + "line_display": "929", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 963) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._NARROW", + "kind": "attribute", + "line_start": 937, + "line_end": 937, + "line_display": "937", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "hằng số class-level (không phải self.) — ngưỡng bề rộng cửa sổ hẹp, không liên quan chat", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.showEvent", + "kind": "method", + "line_start": 939, + "line_end": 941, + "line_display": "939-941", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "Qt override, không liên quan chat", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._apply_narrow_layout", + "kind": "method", + "line_start": 943, + "line_end": 953, + "line_display": "943-953", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "không liên quan chat", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._toggle_config", + "kind": "method", + "line_start": 955, + "line_end": 998, + "line_display": "955-998", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "không liên quan chat; điều khiển config panel + splitter self._split", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._refresh_min_width", + "kind": "method", + "line_start": 1000, + "line_end": 1005, + "line_display": "1000-1005", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "không liên quan chat", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._build_canvas_overlay", + "kind": "method", + "line_start": 1007, + "line_end": 1028, + "line_display": "1007-1028", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "overlay zoom cho canvas — không liên quan chat, thuộc nhóm canvas widget", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_canvas_widget.py` (dong 1041-1062) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.zoom_in_btn", + "kind": "attribute", + "line_start": 1020, + "line_end": 1020, + "line_display": "1020", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_canvas_widget.py` (dong 1054) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.zoom_out_btn", + "kind": "attribute", + "line_start": 1021, + "line_end": 1021, + "line_display": "1021", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_canvas_widget.py` (dong 1055) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.fit_btn", + "kind": "attribute", + "line_start": 1022, + "line_end": 1022, + "line_display": "1022", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_canvas_widget.py` (dong 1056) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._build_chat", + "kind": "method", + "line_start": 1030, + "line_end": 1093, + "line_display": "1030-1093", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "Khớp trực tiếp với mô tả target: dựng header 'Messages' (icon+tiêu đề+nút thu/mở), QStackedWidget chat_stack chứa ChatView theo flow, composer (usage_total label + _ChatInput + RoutingToggle + nút Gửi). NHƯNG method này CŨNG khởi tạo trạng thái chia sẻ không thuộc widget thuần: self._flow_logs (dict per-flow), self._vsplit_sizes, self._msgs_collapsed (dùng bởi _toggle_messages/_ensure_flow_log ở lại Co4ETab) — nên tách phần init state đó ra khỏi hàm dựng widget khi chuyển file. Cũng nối self.chat_input.submit và self.chat_send_btn.clicked trực tiếp tới self._chat_send (method ở lại Co4ETab) — cần thiết kế callback/signal khi tách.", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._chat_widget", + "kind": "attribute", + "line_start": 1032, + "line_end": 1032, + "line_display": "1032", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "trạng thái chia sẻ — self._chat_widget.setMaximumHeight() được gọi từ _toggle_messages (ở lại Co4ETab) — điểm nối giữa 2 file", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._mhdr", + "kind": "attribute", + "line_start": 1038, + "line_end": 1038, + "line_display": "1038", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "trạng thái chia sẻ — self._mhdr.sizeHint() đọc từ _toggle_messages (ở lại Co4ETab)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.msgs_icon", + "kind": "attribute", + "line_start": 1040, + "line_end": 1040, + "line_display": "1040", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.msgs_title", + "kind": "attribute", + "line_start": 1041, + "line_end": 1041, + "line_display": "1041", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.chat_toggle_btn", + "kind": "attribute", + "line_start": 1042, + "line_end": 1042, + "line_display": "1042", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "trạng thái chia sẻ — icon/tooltip của nút này bị _toggle_messages (ở lại Co4ETab) đổi qua lại icon 'chevron-up'/'chevron-down'", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.chat_stack", + "kind": "attribute", + "line_start": 1057, + "line_end": 1057, + "line_display": "1057", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "trạng thái chia sẻ quan trọng — self.chat_stack được _ensure_flow_log (addWidget) và _apply_workflow (setCurrentWidget) đọc/ghi, cả hai ở lại Co4ETab; điểm nối chính giữa chat_view.py và Co4ETab", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._flow_logs", + "kind": "attribute", + "line_start": 1058, + "line_end": 1058, + "line_display": "1058", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "trạng thái chia sẻ per-flow (dict wf_id -> ChatView) — theo mô tả target, business logic quản lý log stays ở Co4ETab (_ensure_flow_log/_active_log/chat_log), nên dict này nên ở lại ui/co4e_tab.py dù được khởi tạo trong _build_chat (widget-building method) — cần tách khởi tạo này ra khỏi _build_chat khi chuyển file", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1092) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.chat_input_row", + "kind": "attribute", + "line_start": 1060, + "line_end": 1060, + "line_display": "1060", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "trạng thái chia sẻ — show()/hide() gọi từ _toggle_messages (ở lại Co4ETab)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._usage_total_lbl", + "kind": "attribute", + "line_start": 1065, + "line_end": 1065, + "line_display": "1065", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "label usage-total của composer — có khả năng được cập nhật bởi _refresh_usage_total (không thuộc lát này, khả năng ở Co4ETab) — kiểm tra lại khi gộp", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.chat_input", + "kind": "attribute", + "line_start": 1071, + "line_end": 1071, + "line_display": "1071", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "_ChatInput — submit signal nối tới self._chat_send (method ở lại Co4ETab, không có trong lát này)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.chat_send_btn", + "kind": "attribute", + "line_start": 1074, + "line_end": 1074, + "line_display": "1074", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "clicked nối tới self._chat_send (ở lại Co4ETab)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.co4e_routing_toggle", + "kind": "attribute", + "line_start": 1079, + "line_end": 1079, + "line_display": "1079", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._co4e_routed_provider", + "kind": "attribute", + "line_start": 1080, + "line_end": 1080, + "line_display": "1080", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "biến trạng thái routing override cho lượt chat kế tiếp — là business state hơn là widget, được đọc/ghi ở _chat_send (không thuộc lát này); không rõ nó nên ở composer widget hay ở lại Co4ETab, cần người quyết -- QUYET DINH: bien trang thai routing override cho luot chat ke tiep la BUSINESS STATE, khong phai widget -- cung mot self._co4e_routed_provider duoc gan lai o dong 1819 (trong _apply_co4e_routing, o lai ui/co4e_tab.py theo yeu cau de bai); khoi tao lan dau nay (dong 1080, ben trong _build_chat) nen duoc TACH RA khoi ham dung widget khi chuyen file, giong cach xu ly _flow_logs (dong 1058) -- quyet dinh o day = ui/co4e_tab.py.", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1114; 1853) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._vsplit_sizes", + "kind": "attribute", + "line_start": 1087, + "line_end": 1087, + "line_display": "1087", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "trạng thái chia sẻ với _toggle_messages (ở lại Co4ETab theo mô tả target) — dùng self._vsplit", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1121) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._msgs_collapsed", + "kind": "attribute", + "line_start": 1088, + "line_end": 1088, + "line_display": "1088", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "trạng thái chia sẻ với _toggle_messages (ở lại Co4ETab theo mô tả target)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1122) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._toggle_messages", + "kind": "method", + "line_start": 1095, + "line_end": 1127, + "line_display": "1095-1127", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "loại trừ khỏi chat_view.py theo mô tả đề bài — dùng self._vsplit (splitter canvas/chat) để co giãn không gian, đây là logic của Co4ETab không phải của widget chat", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1129-1161) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._ensure_flow_log", + "kind": "method", + "line_start": 1130, + "line_end": 1139, + "line_display": "1130-1139", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "loại trừ khỏi chat_view.py theo mô tả đề bài — quản lý state per-flow (self._flow_logs, self.chat_stack)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1164-1173) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._active_log", + "kind": "method", + "line_start": 1141, + "line_end": 1143, + "line_display": "1141-1143", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "loại trừ khỏi chat_view.py theo mô tả đề bài", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1175-1177) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.chat_log", + "kind": "method", + "line_start": 1145, + "line_end": 1149, + "line_display": "1145-1149", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "property, loại trừ khỏi chat_view.py theo mô tả đề bài", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1180-1183) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._plan_bubble", + "kind": "method", + "line_start": 1151, + "line_end": 1157, + "line_display": "1151-1157", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "property với getter (1151-1153) và setter (1155-1157), loại trừ khỏi chat_view.py theo mô tả đề bài", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1186-1187) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._apply_workflow", + "kind": "method", + "line_start": 1160, + "line_end": 1173, + "line_display": "1160-1173", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc/ghi self._wf, self.chat_stack, self.canvas — trạng thái chia sẻ rộng, business logic đổi workflow đang hiển thị", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._new_workflow", + "kind": "method", + "line_start": 1175, + "line_end": 1183, + "line_display": "1175-1183", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._selected_wf", + "kind": "method", + "line_start": 1185, + "line_end": 1191, + "line_display": "1185-1191", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "co4e.get_workflow(ident) đọc từ repository lưu trữ workflow (đĩa)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._load_selected_workflow", + "kind": "method", + "line_start": 1193, + "line_end": 1196, + "line_display": "1193-1196", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "qua _selected_wf() chạm đĩa", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._edit_selected_workflow", + "kind": "method", + "line_start": 1198, + "line_end": 1203, + "line_display": "1198-1203", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "qua _selected_wf() chạm đĩa", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._duplicate_selected_workflow", + "kind": "method", + "line_start": 1205, + "line_end": 1212, + "line_display": "1205-1212", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "co4e.duplicate_workflow ghi đĩa", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1239-1246) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._wf_context_menu", + "kind": "method", + "line_start": 1214, + "line_end": 1237, + "line_display": "1214-1237", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "dựng QMenu và dispatch tới các method khác (một số chạm đĩa) — bản thân method này không chạm đĩa trực tiếp", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._rename_workflow", + "kind": "method", + "line_start": 1239, + "line_end": 1255, + "line_display": "1239-1255", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "QInputDialog modal + co4e.save_workflow ghi đĩa; cũng đồng bộ self._wf.name nếu đang mở đúng flow — trạng thái chia sẻ với name_edit/self._wf", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1273-1289) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._delete_selected_workflow", + "kind": "method", + "line_start": 1257, + "line_end": 1263, + "line_display": "1257-1263", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "co4e.delete_workflow ghi đĩa", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1291-1297) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._sync_wf_from_canvas", + "kind": "method", + "line_start": 1265, + "line_end": 1268, + "line_display": "1265-1268", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc self.canvas.nodes()/edges() và self.name_edit — trạng thái chia sẻ với canvas", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._save", + "kind": "method", + "line_start": 1270, + "line_end": 1275, + "line_display": "1270-1275", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "co4e.save_workflow ghi đĩa", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1304-1309) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._autosave", + "kind": "method", + "line_start": 1277, + "line_end": 1280, + "line_display": "1277-1280", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "co4e.save_workflow ghi đĩa (chỉ khi workflow đã tồn tại)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1311-1314) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._on_name_changed", + "kind": "method", + "line_start": 1282, + "line_end": 1284, + "line_display": "1282-1284", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "gọi self._sync_active_flow_tab_text() (không thuộc lát này) — cập nhật self._wf.name", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._add_blank_step", + "kind": "method", + "line_start": 1286, + "line_end": 1288, + "line_display": "1286-1288", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._on_node_selected", + "kind": "method", + "line_start": 1291, + "line_end": 1297, + "line_display": "1291-1297", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc self.canvas.nodes() và self.config — thuộc nhóm node-property, không phải chat", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 1325-1331) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._on_config_changed", + "kind": "method", + "line_start": 1299, + "line_end": 1302, + "line_display": "1299-1302", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "gọi self._autosave() (ghi đĩa gián tiếp)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 1333-1336) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._new_agent", + "kind": "method", + "line_start": 1305, + "line_end": 1306, + "line_display": "1305-1306", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 1339-1340) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._edit_agent", + "kind": "method", + "line_start": 1308, + "line_end": 1316, + "line_display": "1308-1316", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "co4e.list_custom_agents() khả năng đọc đĩa", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 1342-1350) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._edit_agent_dialog", + "kind": "method", + "line_start": 1318, + "line_end": 1324, + "line_display": "1318-1324", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "mở Co4EAgentDialog modal, co4e.save_custom_agent ghi đĩa", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 1352-1358) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._delete_agent", + "kind": "method", + "line_start": 1326, + "line_end": 1333, + "line_display": "1326-1333", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "co4e.delete_custom_agent ghi đĩa", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 1360-1367) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._manage_skills", + "kind": "method", + "line_start": 1335, + "line_end": 1339, + "line_display": "1335-1339", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "mở SkillsDialog modal", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/skills_list_panel.py` (dong 1369-1373) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._skill_map", + "kind": "method", + "line_start": 1342, + "line_end": 1348, + "line_display": "1342-1348", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "logic thuần Python, đọc skills_mod.skill_prefix_for(name) — có khả năng đọc file skill từ đĩa", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1376-1382) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._current_mode", + "kind": "method", + "line_start": 1350, + "line_end": 1351, + "line_display": "1350-1351", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc self.mode_combo.currentData()", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1384-1385) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._on_mode_changed", + "kind": "method", + "line_start": 1353, + "line_end": 1359, + "line_display": "1353-1359", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "reset self._manual_active/_manual_order/_manual_idx — trạng thái run-mode chia sẻ", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1387-1393) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._on_run_clicked", + "kind": "method", + "line_start": 1361, + "line_end": 1371, + "line_display": "1361-1371", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "gọi self.manager.stop/self._start_canvas_run — thuộc nhóm run control", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1395-1400) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._start_canvas_run", + "kind": "method", + "line_start": 1373, + "line_end": 1390, + "line_display": "1373-1390", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "khởi động self.manager.start(...) — sẽ trigger chạy step/agent (network/AI provider); ghi self._flow_runs, self._run_logs[run_id] = self.chat_log — điểm nối giữa run-control và chat log (self.chat_log là property loại trừ khỏi chat_view.py)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1407-1424) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._run_single", + "kind": "method", + "line_start": 1392, + "line_end": 1397, + "line_display": "1392-1397", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "gọi _start_canvas_run", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1426-1431) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._run_from", + "kind": "method", + "line_start": 1399, + "line_end": 1403, + "line_display": "1399-1403", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "[GOP 2 luot quet trung ky hieu, dong 1399] mot agent doc phan dau (1399-1400, chua thay than ham), agent kia doc phan duoi (1401-1403, tag tam 'unknown_method_fragment_before_1401') voi than ham la self._start_canvas_run(..., only=self._downstream(node_id), seed=dict(self._outputs_for(self._wf.id))) -- QUYET DINH: chay lai tu 1 node cu the tren canvas (logic thuc thi run), khong lien quan chat; giu o ui/co4e_tab.py cung nhom voi _run_single/_downstream.", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1433-1437) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._downstream", + "kind": "method", + "line_start": 1405, + "line_end": 1416, + "line_display": "1405-1416", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc self.canvas.edges() — thuần logic đồ thị, test được không cần Qt nếu canvas là fake", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1439-1450) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._manual_run_or_advance", + "kind": "method", + "line_start": 1419, + "line_end": 1432, + "line_display": "1419-1432", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc/ghi self._wf, self._manual_order, self._manual_idx, self._manual_active, self._outputs_for — trạng thái chia sẻ giữa manual-run và canvas; gọi self.canvas.reset_statuses()", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1453-1466) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._manual_step", + "kind": "method", + "line_start": 1434, + "line_end": 1450, + "line_display": "1434-1450", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "ghi self._flow_runs, self._run_logs (định tuyến log theo từng flow — trạng thái chia sẻ then chốt); self.manager.start có thể chạm đĩa/spawn agent; self.run_btn.setText cần widget sống", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1468-1484) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._topo_order", + "kind": "method", + "line_start": 1452, + "line_end": 1457, + "line_display": "1452-1457", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1486-1491) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._on_manager_event", + "kind": "method", + "line_start": 1460, + "line_end": 1516, + "line_display": "1460-1516", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "method dài (~57 dòng) gộp nhiều việc: định tuyến sự kiện theo run_id/flow, cập nhật canvas status, ghi self._outputs_for/self._run_logs/self._flow_runs (trạng thái chia sẻ nhiều flow song song), gọi self._append_chat/_append_diff/_append_plan, hiện popup thông báo — nên cân nhắc tách theo loại event", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1494-1550) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._notify_run_finished", + "kind": "method", + "line_start": 1518, + "line_end": 1539, + "line_display": "1518-1539", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "dựng QMessageBox không chặn — cần QApplication sống", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1552-1573) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._run_popups", + "kind": "attribute", + "line_start": 1526, + "line_end": 1527, + "line_display": "1526-1527", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "khởi tạo lười (hasattr guard) bên trong _notify_run_finished — không thấy gán trong __init__ ở lát này, agent đọc __init__ nên đối chiếu", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1560-1561) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._refresh_runs", + "kind": "method", + "line_start": 1541, + "line_end": 1582, + "line_display": "1541-1582", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "cập nhật self.runs_table, self.flow_bar, self._sections — chạm nhiều widget cùng lúc", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1575-1616) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._stop_selected_run", + "kind": "method", + "line_start": 1584, + "line_end": 1590, + "line_display": "1584-1590", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc self.runs_table.currentRow()", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1618-1624) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._delete_selected_run", + "kind": "method", + "line_start": 1592, + "line_end": 1605, + "line_display": "1592-1605", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "ghi self._flow_runs, self._run_logs — trạng thái chia sẻ per-flow", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1626-1639) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._runs_context_menu", + "kind": "method", + "line_start": 1607, + "line_end": 1621, + "line_display": "1607-1621", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "dựng QMenu tại vị trí chuột — cần widget sống", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1641-1655) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.set_project", + "kind": "method", + "line_start": 1624, + "line_end": 1640, + "line_display": "1624-1640", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "ghi self._project_id, self._project_dir (trạng thái workspace chia sẻ, ảnh hưởng _flow_output_root/_out_dir); load_project đọc dữ liệu project (đĩa); gọi self._refresh_ws_folder_btn nếu widget tồn tại", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._flow_output_root", + "kind": "method", + "line_start": 1642, + "line_end": 1652, + "line_display": "1642-1652", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc self._project_dir, self.ctx.config — logic thuần tính đường dẫn, không tự chạm đĩa (không mkdir/open)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._refresh_ws_folder_btn", + "kind": "method", + "line_start": 1654, + "line_end": 1659, + "line_display": "1654-1659", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "self.ws_folder_btn.setText/setToolTip", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._open_workspace_folder", + "kind": "method", + "line_start": 1661, + "line_end": 1668, + "line_display": "1661-1668", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "mkdir + open_location (mở file explorer hệ điều hành, spawn process)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._open_run_output_folder", + "kind": "method", + "line_start": 1670, + "line_end": 1681, + "line_display": "1670-1681", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "kiểm tra path.exists()/mkdir + open_location", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1704-1715) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._rename_selected_run", + "kind": "method", + "line_start": 1683, + "line_end": 1714, + "line_display": "1683-1714", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "dựng QInputDialog; ghi self._flows, self.flow_bar (tab text), self._wf, self.name_edit — trạng thái chia sẻ giữa danh sách flow và tab đang mở; co4e.save_workflow ghi đĩa", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1717-1748) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._run_selected_in_background", + "kind": "method", + "line_start": 1716, + "line_end": 1726, + "line_display": "1716-1726", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "self.manager.start khởi chạy agent nền (ghi output ra đĩa)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1750-1760) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._wf_by_id", + "kind": "method", + "line_start": 1728, + "line_end": 1736, + "line_display": "1728-1736", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "co4e.get_workflow đọc workflow đã lưu từ đĩa; đọc self._wf", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1762-1770) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._rerun_run_item", + "kind": "method", + "line_start": 1738, + "line_end": 1749, + "line_display": "1738-1749", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "item là QTableWidgetItem; manager.start khởi chạy agent nền", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1772-1783) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._open_run_from_table", + "kind": "method", + "line_start": 1751, + "line_end": 1770, + "line_display": "1751-1770", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "gọi self._open_flow(wf), self.canvas.update_node_status — chạm canvas widget và self._wf", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1785-1804) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab.showEvent", + "kind": "method", + "line_start": 1772, + "line_end": 1775, + "line_display": "1772-1775", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "override Qt event", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._out_dir", + "kind": "method", + "line_start": 1777, + "line_end": 1783, + "line_display": "1777-1783", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "mkdir(parents=True); đọc self._wf.name", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._chat_send", + "kind": "method", + "line_start": 1786, + "line_end": 1812, + "line_display": "1786-1812", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "theo yêu cầu, _chat_send KHÔNG thuộc co4e_chat_view.py dù đọc self.chat_input — ở lại Co4ETab; đọc/ghi self._chat_worker", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1820-1846) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._apply_co4e_routing", + "kind": "method", + "line_start": 1814, + "line_end": 1849, + "line_display": "1814-1849", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "ghi self._co4e_routed_provider (trạng thái đọc lại trong _run_chat_turn/job); nhánh manual gọi confirm_switch — mở dialog Qt (routing_toggle) nên cần widget sống ở nhánh đó", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1848-1883) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._co4e_routed_provider", + "kind": "attribute", + "line_start": 1819, + "line_end": 1819, + "line_display": "1819", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "gán lại mỗi lần gọi _apply_co4e_routing; được đọc bằng getattr(...,'None') ở _run_chat_turn/job — không chắc có init trong __init__ (nằm ngoài lát này)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1114; 1853) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._extract_agent_directive", + "kind": "method", + "line_start": 1851, + "line_end": 1857, + "line_display": "1851-1857", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "logic regex thuần, dễ test độc lập", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1885-1891) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._resolve_agent", + "kind": "method", + "line_start": 1859, + "line_end": 1867, + "line_display": "1859-1867", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "duyệt BUILTIN_AGENTS + co4e.list_custom_agents() (custom agents có thể đọc đĩa nhưng bản thân hàm chỉ gọi list)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1893-1901) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._run_chat_turn", + "kind": "method", + "line_start": 1869, + "line_end": 1940, + "line_display": "1869-1940", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "method dài (~72 dòng) gộp: build prompt, định nghĩa 4 closure lồng nhau (job/on_event/done/failed), khởi AgentWorker — nên tách; theo yêu cầu KHÔNG đưa job()/AgentWorker sang co4e_chat_view.py; đọc/ghi self.chat_log, self._wf, self._chat_worker (trạng thái chia sẻ)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1903-1974) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._run_chat_turn.job", + "kind": "function", + "line_start": 1883, + "line_end": 1912, + "line_display": "1883-1912", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "note": "closure lồng trong _run_chat_turn, chạy trong AgentWorker thread; gọi run_cowork → gọi provider AI qua mạng; theo yêu cầu ở lại Co4ETab cùng _chat_send", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1917-1946) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._run_chat_turn.job._emit", + "kind": "function", + "line_start": 1894, + "line_end": 1901, + "line_display": "1894-1901", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "helper lồng bên trong job(), chuyển tiếp event streaming sang worker.emit_event", + "merge_note": null, + "in_old_table": "chua", + "old_table_mismatch": "BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam)." + }, + { + "symbol": "Co4ETab._run_chat_turn.on_event", + "kind": "function", + "line_start": 1914, + "line_end": 1920, + "line_display": "1914-1920", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "closure cập nhật assistant.set_markdown/log.scroll_to_bottom — cần widget sống; gọi self._append_plan", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1948-1954) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._run_chat_turn.done", + "kind": "function", + "line_start": 1922, + "line_end": 1928, + "line_display": "1922-1928", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "ghi self._chat_worker=None, gọi self._apply_usage — chạm self._flow_usage", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1956-1962) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._run_chat_turn.failed", + "kind": "function", + "line_start": 1930, + "line_end": 1933, + "line_display": "1930-1933", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "ghi self._chat_worker=None, gọi self._append_chat", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1964-1967) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._append_chat", + "kind": "method", + "line_start": 1942, + "line_end": 1957, + "line_display": "1942-1957", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "theo yêu cầu, _append_chat KHÔNG thuộc co4e_chat_view.py — dùng self.chat_log mặc định, business logic per-flow ở lại Co4ETab", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1976-1991) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._fmt_usage", + "kind": "method", + "line_start": 1960, + "line_end": 1967, + "line_display": "1960-1967", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "logic thuần định dạng chuỗi + tra bảng giá từ self.ctx.config.data — test được không cần Qt", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1994-2001) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._apply_usage", + "kind": "method", + "line_start": 1969, + "line_end": 1986, + "line_display": "1969-1986", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "ghi self._flow_usage (tổng usage theo từng flow — trạng thái chia sẻ với composer label usage-total ở co4e_chat_view.py); gọi bub.add_usage cần widget bubble sống", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 2003-2020) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._refresh_usage_total", + "kind": "method", + "line_start": 1988, + "line_end": 2003, + "line_display": "1988-2003", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "đọc self._flow_usage, self._wf; ghi self._usage_total_lbl.setText — label này được dựng trong co4e_chat_view.py (composer) nên đây là điểm nối trạng thái chia sẻ giữa 2 file", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 2022-2037) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._append_diff", + "kind": "method", + "line_start": 2005, + "line_end": 2009, + "line_display": "2005-2009", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "theo yêu cầu KHÔNG thuộc co4e_chat_view.py — ở lại Co4ETab", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 2039-2043) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._append_plan", + "kind": "method", + "line_start": 2011, + "line_end": 2022, + "line_display": "2011-2022", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "theo yêu cầu KHÔNG thuộc co4e_chat_view.py — dùng log._co4e_plan_bubble (state gắn trên đối tượng ChatView, không phải self)", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 2045-2056) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "Co4ETab._retranslate", + "kind": "method", + "line_start": 2025, + "line_end": 2045, + "line_display": "2025-2045", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "duyệt self._sections (trạng thái chia sẻ toàn tab) và setText hàng loạt widget nhiều khu vực khác nhau (runs, sidebar, header) — cắt ngang nhiều nhóm chức năng khác nhau nên khó tách gọn", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_html_escape", + "kind": "function", + "line_start": 2048, + "line_end": 2049, + "line_display": "2048-2049", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "hàm module-level, tiện ích thuần chuỗi, không thuộc riêng chat_view", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 2082-2083) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + }, + { + "symbol": "_qcolor", + "kind": "function", + "line_start": 2052, + "line_end": 2054, + "line_display": "2052-2054", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "note": "QColor dùng như kiểu giá trị, không cần QApplication sống", + "merge_note": null, + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 2086-2088) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`." + } + ] +} \ No newline at end of file diff --git a/docs/architecture/co4e-split-map-chat-view.md b/docs/architecture/co4e-split-map-chat-view.md new file mode 100644 index 0000000..af9436f --- /dev/null +++ b/docs/architecture/co4e-split-map-chat-view.md @@ -0,0 +1,253 @@ +# Bản đồ tách file — Chat View (khung Messages / composer) + +Gộp 220 symbol thô từ 3 agent quét song song trên `ui/co4e_tab.py`, còn lại **218 dòng** sau khi gộp 2 nhóm trùng lặp thật do lát quét cắt ngang symbol (`Co4ETab._reload_sidebar` dòng 686, `Co4ETab._run_from` dòng 1399 — xem bảng bên dưới) và giải quyết 5 dòng có `target_file` ban đầu ghi `unsure`. + +- File đích của lane chat-view: `presentation/co4e/co4e_chat_view.py` — **21 symbol**. +- Phần còn lại của container: `ui/co4e_tab.py` — **197 symbol**. +- Thuộc lane/file khác (ngoài phạm vi hai đích trên): **0 symbol** — dữ liệu thô của lần quét này chỉ dùng đúng 2 target_file thật (`ui/co4e_tab.py`, `presentation/co4e/co4e_chat_view.py`) cộng `unsure`. +- Note bắt đầu bằng `khac tai lieu:` tìm thấy trong dữ liệu thô: **0**. + +## Các nhóm đã gộp (lát quét cắt ngang 1 symbol thành 2 mảnh) + +- Co4ETab._reload_sidebar (dong 686 va 701, 2 luot quet trung, gop thanh 686-719) +- Co4ETab._run_from (dong 1399 va unknown_method_fragment_before_1401 dong 1401, 2 luot quet trung, gop thanh 1399-1403) + +## Anomaly cố ý giữ tách riêng (không gộp) + +- `Co4ETab.showEvent` xuất hiện **2 lần** trong dữ liệu thô ở hai dòng khác nhau (939-941 và 1772-1775) — đây KHÔNG phải lỗi quét trùng mà là **2 định nghĩa method cùng tên thật sự tồn tại trong class** (định nghĩa thứ 2 đè lên định nghĩa đầu lúc runtime, hành vi Python bình thường). Khớp với `kept_separate_anomaly_symbols` đã ghi nhận ở cả bảng cũ (`co4e-split-map.json`) và bản đồ run-control — giữ tách riêng thành 2 dòng ở bảng dưới. + +## Phát hiện quan trọng nhất từ việc đối chiếu với bảng cũ (`docs/architecture/co4e-split-map.json`, 363 dòng) + +1. **Đường dẫn `presentation/co4e/co4e_tab.py` trong bảng cũ tương đương `ui/co4e_tab.py` hôm nay.** Bảng cũ dùng `target_file="presentation/co4e/co4e_tab.py"` cho phần thân lớp `Co4ETab` còn lại, nhưng file đó ở repo hiện tại chỉ là factory `build_co4e_tab()` mỏng (~53 dòng, bọc nguyên `Co4ETab` cũ 1:1) — KHÔNG phải nơi lớp `Co4ETab` thật sự sống (lớp đó vẫn ở `ui/co4e_tab.py`). Phát hiện này đã được xác nhận trước đó ở bản đồ run-control; bảng này tự quy đổi mọi so sánh trước khi kết luận lệch. +2. **Phạm vi `co4e_chat_view.py` bị thu hẹp mạnh so với bảng cũ.** Bảng cũ (50 dòng liên quan) coi 'chat view' là toàn bộ chuỗi: khung widget (header Messages, `chat_stack`, composer, `_ChatInput`, RoutingToggle) **LẪN** business logic điều phối lượt chat (`_chat_send`, `_apply_co4e_routing`, `_run_chat_turn` + 4 closure lồng bên trong, `_extract_agent_directive`, `_resolve_agent`, `_append_chat`/`_append_diff`/`_append_plan`, `_fmt_usage`/`_apply_usage`/`_refresh_usage_total`, `_toggle_messages`/`_ensure_flow_log`/`_active_log`/`chat_log`/`_plan_bubble`). Lần quét 3-agent hiện tại (lặp lại trong từng ghi chú riêng lẻ với cụm từ 'theo yêu cầu KHÔNG thuộc co4e_chat_view.py') thu hẹp `co4e_chat_view.py` chỉ còn là **khung widget thuần túy**: `_ChatInput` + `_directive_token` (ô nhập autocomplete) và phần dựng UI của `_build_chat` (header/composer/stack). Toàn bộ business logic điều phối chat, quản lý log per-flow, usage và routing ở lại `ui/co4e_tab.py`. Đây là khác biệt lớn nhất giữa hai bảng — ảnh hưởng tới hơn 20 dòng bên dưới (đánh dấu ở cột cuối). +3. **`_PLAN_GLYPH`/`_fmt_plan`/`_qcolor` bị bảng cũ xếp sai lane (không phải chat_view.py, cũng không phải ui/co4e_tab.py).** Cả ba đều phục vụ chat (glyph/format cho bong bóng 'plan', màu cột trạng thái) nhưng bảng cũ xếp chung vào `presentation/co4e/co4e_run_control_widget.py` — sai giống hệt phát hiện đã ghi nhận ở bản đồ run-control cho chính 3 symbol này. Thêm 2 symbol mới chưa từng được đối chiếu trước đó (`_skill_names`, `_agent_names`, cũng bị bảng cũ xếp thẳng vào `co4e_chat_view.py`) — quyết định ở đây là giữ cả 5 symbol tại `ui/co4e_tab.py` vì chúng dùng ở nhiều nơi ngoài phạm vi composer chat hoặc thuộc business logic thuần. +4. **Bảng cũ bỏ sót 7 symbol** không có dòng nào dù nằm trong phạm vi đã quét: `_ChatInput.submit` (dòng 143), `Co4ETab.status_message` (dòng 232), `Co4ETab._build_sidebar.._Col` (dòng 505-514), `Co4ETab._build_sidebar.._Col.__init__` (dòng 508-509), `Co4ETab._build_sidebar.._Col.addWidget` (dòng 511-513), `Co4ETab._agent_panel` (dòng 557), `Co4ETab._run_chat_turn.job._emit` (dòng 1894-1901). + +Tổng số dòng có lệch với bảng cũ (khác target_file sau khi quy đổi đường dẫn): **120/218**. + +## Bảng đầy đủ (sắp theo số dòng) + +| symbol | dòng | file đích | lý do | có trong bảng cũ chưa | chỗ nào thấy bảng cũ sai | +|---|---|---|---|---|---| +| `_PLAN_GLYPH` | 47-48 | `ui/co4e_tab.py` | hằng số module dùng bởi _fmt_plan cho việc hiển thị plan trong chat log — thuộc business logic của Co4ETab, không phải khung widget chat | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 45-46) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `_fmt_plan` | 51-60 | `ui/co4e_tab.py` | dùng bởi _append_plan (business logic per-flow, ở lại Co4ETab theo mô tả target) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 49-58) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `_skill_names` | 63-67 | `ui/co4e_tab.py` | đọc skills từ đĩa qua core.skills.list_skills/builtin_skills; dùng ở nhiều nơi trong file (dòng 164, 714, 1294, 1321, 1344) không chỉ trong chat composer nên không chuyển riêng vào co4e_chat_view.py | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 61-65) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `_agent_names` | 70-73 | `ui/co4e_tab.py` | đọc agents từ đĩa qua core.co4e.list_custom_agents; dùng ở nhiều nơi (dòng 168 và ngoài phạm vi đọc), giữ ở Co4ETab như _skill_names | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 68-71) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `_EqualTabBar` | 76-96 | `ui/co4e_tab.py` | không thấy chỗ nào khởi tạo _EqualTabBar trong toàn file (grep 'flow_bar =' cho thấy dùng QTabBar thường ở dòng 735) — có thể là code chết, cần người quyết có xoá hay giữ -- QUYET DINH: khong tim thay noi nao khoi tao _EqualTabBar trong toan file (flow_bar dung QTabBar thuong o dong 735) -- co the la code chet, nhung du con hay khong no la mot QTabBar tien ich cho sidebar icon-tabs, KHONG lien quan chat -- khop voi quyet dinh da chot cho cung symbol nay o lane run-control (ui/co4e_tab.py). | co | - | +| `_EqualTabBar.tabSizeHint` | 84-92 | `ui/co4e_tab.py` | thuộc _EqualTabBar — xem note ở class, có vẻ không còn dùng -- QUYET DINH: thuoc _EqualTabBar -- xem ly do o class, khong lien quan chat. | co | - | +| `_EqualTabBar.resizeEvent` | 94-96 | `ui/co4e_tab.py` | thuộc _EqualTabBar — xem note ở class -- QUYET DINH: thuoc _EqualTabBar -- xem ly do o class, khong lien quan chat. | co | - | +| `_PaletteList` | 99-121 | `ui/co4e_tab.py` | dùng cho wf_list ở sidebar (drag workflow lên canvas), không liên quan chat view | co | BANG CU KHAC: bang cu xep vao `unsure` (dong 97-119) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `_PaletteList.__init__` | 104-108 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `unsure` (dong 102-106) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `_PaletteList.startDrag` | 110-121 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `unsure` (dong 108-119) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `_directive_token` | 124-136 | `presentation/co4e/co4e_chat_view.py` | chỉ được gọi bởi _ChatInput (dòng 156, 194) — hàm thuần Python phục vụ autocomplete của ô nhập chat, nên đi cùng _ChatInput | co | - | +| `_ChatInput` | 139-228 | `presentation/co4e/co4e_chat_view.py` | ô nhập của composer — nằm trong phạm vi widget khung chat theo mô tả target | co | - | +| `_ChatInput.submit` | 143 | `presentation/co4e/co4e_chat_view.py` | Signal lớp, phát khi Enter được nhấn — Co4ETab._chat_send (nằm ngoài phạm vi đọc) sẽ nối vào signal này từ bên ngoài widget | chua | BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam). | +| `_ChatInput.__init__` | 145-153 | `presentation/co4e/co4e_chat_view.py` | - | co | - | +| `_ChatInput._maybe_popup` | 155-180 | `presentation/co4e/co4e_chat_view.py` | gọi _skill_names()/_agent_names() (đọc đĩa) để dựng popup gợi ý — phần Qt (định vị popup, resize) đòi QWidget sống | co | - | +| `_ChatInput._add_row` | 182-186 | `presentation/co4e/co4e_chat_view.py` | - | co | - | +| `_ChatInput._accept` | 188-201 | `presentation/co4e/co4e_chat_view.py` | - | co | - | +| `_ChatInput.focusOutEvent` | 203-206 | `presentation/co4e/co4e_chat_view.py` | - | co | - | +| `_ChatInput.keyPressEvent` | 208-228 | `presentation/co4e/co4e_chat_view.py` | phát submit khi Enter và popup không hiện — Co4ETab nối submit -> _chat_send ở ngoài widget | co | - | +| `Co4ETab` | 231-700 | `ui/co4e_tab.py` | cắt ngang lát — cần agent gộp đối chiếu (class tiếp tục sau dòng 700) | co | - | +| `Co4ETab.status_message` | 232 | `ui/co4e_tab.py` | Signal lớp | chua | BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam). | +| `Co4ETab.__init__` | 234-306 | `ui/co4e_tab.py` | dựng toàn bộ layout 3 cột (sidebar/center/config); chưa thấy lệnh dựng chat panel trong phạm vi 1-700 — có thể nằm trong _build_center() ở dòng > 700 | co | - | +| `Co4ETab.ctx` | 236 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._wf` | 237 | `ui/co4e_tab.py` | trạng thái chia sẻ rộng — flow đang hiển thị trên canvas; nhiều method (kể cả chat log lookup ngoài phạm vi đọc) phụ thuộc vào self._wf | co | - | +| `Co4ETab._chat_worker` | 238 | `ui/co4e_tab.py` | AgentWorker của chat — theo mô tả target, _chat_send/job()/AgentWorker KHÔNG chuyển vào co4e_chat_view.py, ở lại Co4ETab | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 236) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.manager` | 240 | `ui/co4e_tab.py` | Co4ERunManager — đã có RunsPagePanel/co4e_run_control_widget.py riêng, nhưng self.manager là thuộc tính của Co4ETab, ở lại | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 238) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._flow_runs` | 245 | `ui/co4e_tab.py` | trạng thái chia sẻ: wf_id -> run_id đang chạy trên canvas, dùng bởi nhiều method flow tab | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 243) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._run_logs` | 246 | `ui/co4e_tab.py` | map run_id -> ChatView; theo mô tả target đây là business logic per-flow, ở lại Co4ETab dù ChatView instance được hiển thị trong QStackedWidget của co4e_chat_view.py | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 244) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._flow_outputs` | 247 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 245) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._flow_usage` | 250 | `ui/co4e_tab.py` | usage per-flow (↓in ↑out ▤ctx $cost) — hiển thị ở label usage-total trong composer của co4e_chat_view.py, nhưng dữ liệu và logic tính toán ở lại Co4ETab (chỉ phần dựng label rỗng thuộc chat_view) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 248) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._project_id` | 251 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `unsure` (dong 249) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._project_dir` | 252 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `unsure` (dong 250) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._manual_active` | 254 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 252) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._manual_order` | 255 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 253) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._manual_idx` | 256 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 254) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._flows` | 259 | `ui/co4e_tab.py` | trạng thái chia sẻ — danh sách flow đang mở dạng tab kiểu trình duyệt, dùng bởi hầu hết method _*flow_tab* | co | - | +| `Co4ETab._active_flow_idx` | 260 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._split` | 263 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.config` | 270 | `ui/co4e_tab.py` | StepConfigPanel — đã tách sang presentation/co4e/node_property_panel.py ở làn khác; thuộc tính self.config trên Co4ETab ở lại đây | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 268) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._config_collapsed` | 276 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._config_expanded_w` | 277 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._narrow_guard` | 282 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._open_flow` | 309-340 | `ui/co4e_tab.py` | đọc/ghi self._flows, self.flow_bar — trạng thái chia sẻ giữa các flow tab | co | - | +| `Co4ETab._close_other_flows` | 342-357 | `ui/co4e_tab.py` | self._flows, self._active_flow_idx | co | - | +| `Co4ETab._show_runs` | 359-369 | `ui/co4e_tab.py` | self.flow_bar dùng chung với logic mở flow tab | co | - | +| `Co4ETab._on_flow_tab_changed` | 371-387 | `ui/co4e_tab.py` | đọc self.center_stack (được gán ở ngoài phạm vi đọc, có thể trong _build_center) — trạng thái chia sẻ quan trọng theo mô tả của team | co | - | +| `Co4ETab._sync_runs_toggle` | 389-396 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._add_tab_close_button` | 398-408 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._close_flow_tab_button` | 410-414 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._close_flow_tab` | 416-444 | `ui/co4e_tab.py` | self._flows, self._flow_runs, self._run_logs — trạng thái chia sẻ giữa flow tab và run log của chat | co | - | +| `Co4ETab._sync_active_flow_tab_text` | 446-449 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._reflect_active_run` | 451-459 | `ui/co4e_tab.py` | self._flow_runs, self.canvas — canvas là thuộc tính được gán ngoài phạm vi đọc | co | BANG CU KHAC: bang cu xep vao `unsure` (dong 449-457) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._cur_run_id` | 462-475 | `ui/co4e_tab.py` | self._wf, self._flow_runs — logic thuần, không đụng Qt trực tiếp (chỉ đọc self._wf là attribute) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 460-473) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._outputs_for` | 477-480 | `ui/co4e_tab.py` | self._flow_outputs — logic thuần | co | BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 475-478) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._update_run_btn` | 482-484 | `ui/co4e_tab.py` | self.run_btn được gán ngoài phạm vi đọc | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 480-482) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._build_sidebar` | 487-600 | `ui/co4e_tab.py` | method dài 113 dòng, gộp nhiều việc không liên quan: dựng section Workflows (list+CRUD+run-bg), section Agents (AgentListPanel), section Skills (SkillsListPanel), và section Runs (danh sách rút gọn) — nên tách thành các hàm _build_workflows_section/_build_agents_section/_build_skills_section/_build_runs_section riêng | co | - | +| `Co4ETab._sections` | 495 | `ui/co4e_tab.py` | trạng thái chia sẻ giữa _section/_fold_section/_sync_section_arrow — map key -> (header, body, stretch) | co | - | +| `Co4ETab.sidebar` | 496 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.side_split` | 500 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._build_sidebar.._Col` | 505-514 | `ui/co4e_tab.py` | lớp adapter cục bộ bên trong _build_sidebar, bọc QSplitter để các section builder gọi .addWidget(w, stretch) như trước | chua | BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam). | +| `Co4ETab._build_sidebar.._Col.__init__` | 508-509 | `ui/co4e_tab.py` | - | chua | BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam). | +| `Co4ETab._build_sidebar.._Col.addWidget` | 511-513 | `ui/co4e_tab.py` | - | chua | BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam). | +| `Co4ETab.wf_new_btn` | 518 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_list` | 529 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_edit_btn` | 536 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_dup_btn` | 537 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_del_btn` | 538 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_runbg_btn` | 545 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._agent_panel` | 557 | `ui/co4e_tab.py` | AgentListPanel — widget đã tách sẵn ở làn khác (presentation/co4e/agent_list_panel.py), Co4ETab chỉ giữ tham chiếu và nối signal | chua | BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam). | +| `Co4ETab.ag_new_btn` | 558 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 550) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.agent_list` | 560 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 558) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.ag_edit_btn` | 561 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 562) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.ag_del_btn` | 563 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 563) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._skills_panel` | 572 | `ui/co4e_tab.py` | SkillsListPanel — đã tách sẵn ở làn khác (presentation/co4e/skills_list_panel.py) | co | - | +| `Co4ETab.sk_manage_btn` | 573 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.skill_list` | 575 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.runs_more_btn` | 583 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 586) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.runs_side_list` | 591 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 594) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._SIDE_RUNS` | 602 | `ui/co4e_tab.py` | hằng số lớp | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 605) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._refresh_side_runs` | 604-616 | `ui/co4e_tab.py` | self.manager.runs() — trạng thái run manager | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 607-619) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._on_side_run_clicked` | 618-626 | `ui/co4e_tab.py` | self.runs_table được gán ngoài phạm vi đọc | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 621-629) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._section` | 628-660 | `ui/co4e_tab.py` | ghi vào self._sections — trạng thái chia sẻ | co | - | +| `Co4ETab._fold_section` | 662-674 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._sync_section_arrow` | 676-678 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._icon_btn` | 680-684 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._reload_sidebar` | 686-719 | `ui/co4e_tab.py` | [GOP 2 luot quet trung ky hieu, dong 686] mot agent doc than den 700 (cat ngang lat), agent kia doc tiep 701-719 (vong lap nap agent list + skill list vao palette qua co4e.list_custom_agents()/skills_mod.skill_prefix_for) -- QUYET DINH: nap lai toan bo sidebar (Workflows/Agents/Skills/Runs quick-list), khong lien quan chat -- khop voi quyet dinh da chot o lane run-control (dong 685-718 trong ban do do). | co | - | +| `Co4ETab._palette_item` | 721-725 | `ui/co4e_tab.py` | helper tĩnh dựng QListWidgetItem với icon() — không liên quan chat | co | BANG CU KHAC: bang cu xep vao `unsure` (dong 724-728) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._build_center` | 728-868 | `ui/co4e_tab.py` | method dài ~140 dòng, gộp nhiều việc không liên quan: (1) dựng flow tab bar + scroll ẩn (không hiển thị), (2) center_stack + trang Runs, (3) toolbar flow editor (name_edit/add/save/mode/run/runs_btn), (4) canvas + overlay zoom, (5) tích hợp splitter canvas/chat qua self._build_chat(). Nên tách nhỏ thêm. Đọc/ghi self.center_stack, self.canvas, self._vsplit — trạng thái chia sẻ rộng với nhiều nhóm chức năng khác (canvas widget, run control, chat view) | co | - | +| `Co4ETab.flow_bar` | 735 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.flow_add_btn` | 761 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.flow_scroll` | 778 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.center_stack` | 802 | `ui/co4e_tab.py` | trạng thái chia sẻ — self.center_stack được dùng bởi _build_runs_page, _show_runs và nhiều nơi khác ngoài lát này; chuyển trang giữa Runs table và flow editor | co | - | +| `Co4ETab.name_edit` | 811 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.add_step_btn` | 816 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.save_btn` | 819 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.save_tpl_btn` | 823-824 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.mode_combo` | 825 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 828) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.run_btn` | 830 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 833) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.runs_btn` | 837 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 840) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.canvas` | 853 | `ui/co4e_tab.py` | trạng thái chia sẻ rộng — self.canvas đọc/ghi bởi rất nhiều method trong và ngoài lát này (add_blank_step, _on_node_selected, _on_config_changed, _sync_wf_from_canvas, _apply_workflow, _start_canvas_run...) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_canvas_widget.py` (dong 856) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._vsplit` | 860 | `ui/co4e_tab.py` | trạng thái chia sẻ — self._vsplit dùng bởi _toggle_messages để co giãn giữa canvas và chat box; đúng như cảnh báo trong đề bài | co | - | +| `Co4ETab._build_runs_page` | 870-898 | `ui/co4e_tab.py` | chỉ wiring RunsPagePanel (đã tách ở co4e_run_control_widget.py, không thuộc lát này) vào handler của Co4ETab — ở lại ui/co4e_tab.py theo đúng mô tả docstring của method | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 873-932) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.runs_back_btn` | 881 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 882) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.runs_title` | 883 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 887) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.ws_folder_btn` | 884 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 892) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.run_stop_btn` | 887 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 900) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.run_rename_btn` | 889 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 905) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.run_del_btn` | 891 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 909) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.run_clear_btn` | 893 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 913) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.runs_table` | 895 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 921) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._wrap_config` | 900-930 | `ui/co4e_tab.py` | không liên quan chat; liên quan node-property config panel (đã tách riêng ở node_property_panel.py, không thuộc lát/target được giao cho agent này) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 934-964) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.config_toggle_btn` | 912 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 946) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.config_title` | 917 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 951) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._cfg_vlayout` | 923 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 957) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._cfg_top_spacer` | 927 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 961) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._cfg_bot_spacer` | 928 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 962) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.config_container` | 929 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 963) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._NARROW` | 937 | `ui/co4e_tab.py` | hằng số class-level (không phải self.) — ngưỡng bề rộng cửa sổ hẹp, không liên quan chat | co | - | +| `Co4ETab.showEvent` | 939-941 | `ui/co4e_tab.py` | Qt override, không liên quan chat | co | - | +| `Co4ETab._apply_narrow_layout` | 943-953 | `ui/co4e_tab.py` | không liên quan chat | co | - | +| `Co4ETab._toggle_config` | 955-998 | `ui/co4e_tab.py` | không liên quan chat; điều khiển config panel + splitter self._split | co | - | +| `Co4ETab._refresh_min_width` | 1000-1005 | `ui/co4e_tab.py` | không liên quan chat | co | - | +| `Co4ETab._build_canvas_overlay` | 1007-1028 | `ui/co4e_tab.py` | overlay zoom cho canvas — không liên quan chat, thuộc nhóm canvas widget | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_canvas_widget.py` (dong 1041-1062) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.zoom_in_btn` | 1020 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_canvas_widget.py` (dong 1054) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.zoom_out_btn` | 1021 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_canvas_widget.py` (dong 1055) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.fit_btn` | 1022 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_canvas_widget.py` (dong 1056) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._build_chat` | 1030-1093 | `presentation/co4e/co4e_chat_view.py` | Khớp trực tiếp với mô tả target: dựng header 'Messages' (icon+tiêu đề+nút thu/mở), QStackedWidget chat_stack chứa ChatView theo flow, composer (usage_total label + _ChatInput + RoutingToggle + nút Gửi). NHƯNG method này CŨNG khởi tạo trạng thái chia sẻ không thuộc widget thuần: self._flow_logs (dict per-flow), self._vsplit_sizes, self._msgs_collapsed (dùng bởi _toggle_messages/_ensure_flow_log ở lại Co4ETab) — nên tách phần init state đó ra khỏi hàm dựng widget khi chuyển file. Cũng nối self.chat_input.submit và self.chat_send_btn.clicked trực tiếp tới self._chat_send (method ở lại Co4ETab) — cần thiết kế callback/signal khi tách. | co | - | +| `Co4ETab._chat_widget` | 1032 | `presentation/co4e/co4e_chat_view.py` | trạng thái chia sẻ — self._chat_widget.setMaximumHeight() được gọi từ _toggle_messages (ở lại Co4ETab) — điểm nối giữa 2 file | co | - | +| `Co4ETab._mhdr` | 1038 | `presentation/co4e/co4e_chat_view.py` | trạng thái chia sẻ — self._mhdr.sizeHint() đọc từ _toggle_messages (ở lại Co4ETab) | co | - | +| `Co4ETab.msgs_icon` | 1040 | `presentation/co4e/co4e_chat_view.py` | - | co | - | +| `Co4ETab.msgs_title` | 1041 | `presentation/co4e/co4e_chat_view.py` | - | co | - | +| `Co4ETab.chat_toggle_btn` | 1042 | `presentation/co4e/co4e_chat_view.py` | trạng thái chia sẻ — icon/tooltip của nút này bị _toggle_messages (ở lại Co4ETab) đổi qua lại icon 'chevron-up'/'chevron-down' | co | - | +| `Co4ETab.chat_stack` | 1057 | `presentation/co4e/co4e_chat_view.py` | trạng thái chia sẻ quan trọng — self.chat_stack được _ensure_flow_log (addWidget) và _apply_workflow (setCurrentWidget) đọc/ghi, cả hai ở lại Co4ETab; điểm nối chính giữa chat_view.py và Co4ETab | co | - | +| `Co4ETab._flow_logs` | 1058 | `ui/co4e_tab.py` | trạng thái chia sẻ per-flow (dict wf_id -> ChatView) — theo mô tả target, business logic quản lý log stays ở Co4ETab (_ensure_flow_log/_active_log/chat_log), nên dict này nên ở lại ui/co4e_tab.py dù được khởi tạo trong _build_chat (widget-building method) — cần tách khởi tạo này ra khỏi _build_chat khi chuyển file | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1092) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.chat_input_row` | 1060 | `presentation/co4e/co4e_chat_view.py` | trạng thái chia sẻ — show()/hide() gọi từ _toggle_messages (ở lại Co4ETab) | co | - | +| `Co4ETab._usage_total_lbl` | 1065 | `presentation/co4e/co4e_chat_view.py` | label usage-total của composer — có khả năng được cập nhật bởi _refresh_usage_total (không thuộc lát này, khả năng ở Co4ETab) — kiểm tra lại khi gộp | co | - | +| `Co4ETab.chat_input` | 1071 | `presentation/co4e/co4e_chat_view.py` | _ChatInput — submit signal nối tới self._chat_send (method ở lại Co4ETab, không có trong lát này) | co | - | +| `Co4ETab.chat_send_btn` | 1074 | `presentation/co4e/co4e_chat_view.py` | clicked nối tới self._chat_send (ở lại Co4ETab) | co | - | +| `Co4ETab.co4e_routing_toggle` | 1079 | `presentation/co4e/co4e_chat_view.py` | - | co | - | +| `Co4ETab._co4e_routed_provider` | 1080 | `ui/co4e_tab.py` | biến trạng thái routing override cho lượt chat kế tiếp — là business state hơn là widget, được đọc/ghi ở _chat_send (không thuộc lát này); không rõ nó nên ở composer widget hay ở lại Co4ETab, cần người quyết -- QUYET DINH: bien trang thai routing override cho luot chat ke tiep la BUSINESS STATE, khong phai widget -- cung mot self._co4e_routed_provider duoc gan lai o dong 1819 (trong _apply_co4e_routing, o lai ui/co4e_tab.py theo yeu cau de bai); khoi tao lan dau nay (dong 1080, ben trong _build_chat) nen duoc TACH RA khoi ham dung widget khi chuyen file, giong cach xu ly _flow_logs (dong 1058) -- quyet dinh o day = ui/co4e_tab.py. | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1114; 1853) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._vsplit_sizes` | 1087 | `ui/co4e_tab.py` | trạng thái chia sẻ với _toggle_messages (ở lại Co4ETab theo mô tả target) — dùng self._vsplit | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1121) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._msgs_collapsed` | 1088 | `ui/co4e_tab.py` | trạng thái chia sẻ với _toggle_messages (ở lại Co4ETab theo mô tả target) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1122) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._toggle_messages` | 1095-1127 | `ui/co4e_tab.py` | loại trừ khỏi chat_view.py theo mô tả đề bài — dùng self._vsplit (splitter canvas/chat) để co giãn không gian, đây là logic của Co4ETab không phải của widget chat | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1129-1161) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._ensure_flow_log` | 1130-1139 | `ui/co4e_tab.py` | loại trừ khỏi chat_view.py theo mô tả đề bài — quản lý state per-flow (self._flow_logs, self.chat_stack) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1164-1173) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._active_log` | 1141-1143 | `ui/co4e_tab.py` | loại trừ khỏi chat_view.py theo mô tả đề bài | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1175-1177) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.chat_log` | 1145-1149 | `ui/co4e_tab.py` | property, loại trừ khỏi chat_view.py theo mô tả đề bài | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1180-1183) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._plan_bubble` | 1151-1157 | `ui/co4e_tab.py` | property với getter (1151-1153) và setter (1155-1157), loại trừ khỏi chat_view.py theo mô tả đề bài | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1186-1187) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._apply_workflow` | 1160-1173 | `ui/co4e_tab.py` | đọc/ghi self._wf, self.chat_stack, self.canvas — trạng thái chia sẻ rộng, business logic đổi workflow đang hiển thị | co | - | +| `Co4ETab._new_workflow` | 1175-1183 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._selected_wf` | 1185-1191 | `ui/co4e_tab.py` | co4e.get_workflow(ident) đọc từ repository lưu trữ workflow (đĩa) | co | - | +| `Co4ETab._load_selected_workflow` | 1193-1196 | `ui/co4e_tab.py` | qua _selected_wf() chạm đĩa | co | - | +| `Co4ETab._edit_selected_workflow` | 1198-1203 | `ui/co4e_tab.py` | qua _selected_wf() chạm đĩa | co | - | +| `Co4ETab._duplicate_selected_workflow` | 1205-1212 | `ui/co4e_tab.py` | co4e.duplicate_workflow ghi đĩa | co | BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1239-1246) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._wf_context_menu` | 1214-1237 | `ui/co4e_tab.py` | dựng QMenu và dispatch tới các method khác (một số chạm đĩa) — bản thân method này không chạm đĩa trực tiếp | co | - | +| `Co4ETab._rename_workflow` | 1239-1255 | `ui/co4e_tab.py` | QInputDialog modal + co4e.save_workflow ghi đĩa; cũng đồng bộ self._wf.name nếu đang mở đúng flow — trạng thái chia sẻ với name_edit/self._wf | co | BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1273-1289) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._delete_selected_workflow` | 1257-1263 | `ui/co4e_tab.py` | co4e.delete_workflow ghi đĩa | co | BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1291-1297) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._sync_wf_from_canvas` | 1265-1268 | `ui/co4e_tab.py` | đọc self.canvas.nodes()/edges() và self.name_edit — trạng thái chia sẻ với canvas | co | - | +| `Co4ETab._save` | 1270-1275 | `ui/co4e_tab.py` | co4e.save_workflow ghi đĩa | co | BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1304-1309) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._autosave` | 1277-1280 | `ui/co4e_tab.py` | co4e.save_workflow ghi đĩa (chỉ khi workflow đã tồn tại) | co | BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1311-1314) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._on_name_changed` | 1282-1284 | `ui/co4e_tab.py` | gọi self._sync_active_flow_tab_text() (không thuộc lát này) — cập nhật self._wf.name | co | - | +| `Co4ETab._add_blank_step` | 1286-1288 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._on_node_selected` | 1291-1297 | `ui/co4e_tab.py` | đọc self.canvas.nodes() và self.config — thuộc nhóm node-property, không phải chat | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 1325-1331) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._on_config_changed` | 1299-1302 | `ui/co4e_tab.py` | gọi self._autosave() (ghi đĩa gián tiếp) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/node_property_panel.py` (dong 1333-1336) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._new_agent` | 1305-1306 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 1339-1340) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._edit_agent` | 1308-1316 | `ui/co4e_tab.py` | co4e.list_custom_agents() khả năng đọc đĩa | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 1342-1350) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._edit_agent_dialog` | 1318-1324 | `ui/co4e_tab.py` | mở Co4EAgentDialog modal, co4e.save_custom_agent ghi đĩa | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 1352-1358) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._delete_agent` | 1326-1333 | `ui/co4e_tab.py` | co4e.delete_custom_agent ghi đĩa | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/agent_list_panel.py` (dong 1360-1367) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._manage_skills` | 1335-1339 | `ui/co4e_tab.py` | mở SkillsDialog modal | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/skills_list_panel.py` (dong 1369-1373) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._skill_map` | 1342-1348 | `ui/co4e_tab.py` | logic thuần Python, đọc skills_mod.skill_prefix_for(name) — có khả năng đọc file skill từ đĩa | co | BANG CU KHAC: bang cu xep vao `application/workflows/co4e_workflow_service.py` (dong 1376-1382) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._current_mode` | 1350-1351 | `ui/co4e_tab.py` | đọc self.mode_combo.currentData() | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1384-1385) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._on_mode_changed` | 1353-1359 | `ui/co4e_tab.py` | reset self._manual_active/_manual_order/_manual_idx — trạng thái run-mode chia sẻ | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1387-1393) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._on_run_clicked` | 1361-1371 | `ui/co4e_tab.py` | gọi self.manager.stop/self._start_canvas_run — thuộc nhóm run control | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1395-1400) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._start_canvas_run` | 1373-1390 | `ui/co4e_tab.py` | khởi động self.manager.start(...) — sẽ trigger chạy step/agent (network/AI provider); ghi self._flow_runs, self._run_logs[run_id] = self.chat_log — điểm nối giữa run-control và chat log (self.chat_log là property loại trừ khỏi chat_view.py) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1407-1424) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._run_single` | 1392-1397 | `ui/co4e_tab.py` | gọi _start_canvas_run | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1426-1431) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._run_from` | 1399-1403 | `ui/co4e_tab.py` | [GOP 2 luot quet trung ky hieu, dong 1399] mot agent doc phan dau (1399-1400, chua thay than ham), agent kia doc phan duoi (1401-1403, tag tam 'unknown_method_fragment_before_1401') voi than ham la self._start_canvas_run(..., only=self._downstream(node_id), seed=dict(self._outputs_for(self._wf.id))) -- QUYET DINH: chay lai tu 1 node cu the tren canvas (logic thuc thi run), khong lien quan chat; giu o ui/co4e_tab.py cung nhom voi _run_single/_downstream. | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1433-1437) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._downstream` | 1405-1416 | `ui/co4e_tab.py` | đọc self.canvas.edges() — thuần logic đồ thị, test được không cần Qt nếu canvas là fake | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1439-1450) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._manual_run_or_advance` | 1419-1432 | `ui/co4e_tab.py` | đọc/ghi self._wf, self._manual_order, self._manual_idx, self._manual_active, self._outputs_for — trạng thái chia sẻ giữa manual-run và canvas; gọi self.canvas.reset_statuses() | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1453-1466) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._manual_step` | 1434-1450 | `ui/co4e_tab.py` | ghi self._flow_runs, self._run_logs (định tuyến log theo từng flow — trạng thái chia sẻ then chốt); self.manager.start có thể chạm đĩa/spawn agent; self.run_btn.setText cần widget sống | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1468-1484) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._topo_order` | 1452-1457 | `ui/co4e_tab.py` | - | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1486-1491) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._on_manager_event` | 1460-1516 | `ui/co4e_tab.py` | method dài (~57 dòng) gộp nhiều việc: định tuyến sự kiện theo run_id/flow, cập nhật canvas status, ghi self._outputs_for/self._run_logs/self._flow_runs (trạng thái chia sẻ nhiều flow song song), gọi self._append_chat/_append_diff/_append_plan, hiện popup thông báo — nên cân nhắc tách theo loại event | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1494-1550) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._notify_run_finished` | 1518-1539 | `ui/co4e_tab.py` | dựng QMessageBox không chặn — cần QApplication sống | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1552-1573) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._run_popups` | 1526-1527 | `ui/co4e_tab.py` | khởi tạo lười (hasattr guard) bên trong _notify_run_finished — không thấy gán trong __init__ ở lát này, agent đọc __init__ nên đối chiếu | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1560-1561) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._refresh_runs` | 1541-1582 | `ui/co4e_tab.py` | cập nhật self.runs_table, self.flow_bar, self._sections — chạm nhiều widget cùng lúc | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1575-1616) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._stop_selected_run` | 1584-1590 | `ui/co4e_tab.py` | đọc self.runs_table.currentRow() | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1618-1624) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._delete_selected_run` | 1592-1605 | `ui/co4e_tab.py` | ghi self._flow_runs, self._run_logs — trạng thái chia sẻ per-flow | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1626-1639) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._runs_context_menu` | 1607-1621 | `ui/co4e_tab.py` | dựng QMenu tại vị trí chuột — cần widget sống | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1641-1655) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.set_project` | 1624-1640 | `ui/co4e_tab.py` | ghi self._project_id, self._project_dir (trạng thái workspace chia sẻ, ảnh hưởng _flow_output_root/_out_dir); load_project đọc dữ liệu project (đĩa); gọi self._refresh_ws_folder_btn nếu widget tồn tại | co | - | +| `Co4ETab._flow_output_root` | 1642-1652 | `ui/co4e_tab.py` | đọc self._project_dir, self.ctx.config — logic thuần tính đường dẫn, không tự chạm đĩa (không mkdir/open) | co | - | +| `Co4ETab._refresh_ws_folder_btn` | 1654-1659 | `ui/co4e_tab.py` | self.ws_folder_btn.setText/setToolTip | co | - | +| `Co4ETab._open_workspace_folder` | 1661-1668 | `ui/co4e_tab.py` | mkdir + open_location (mở file explorer hệ điều hành, spawn process) | co | - | +| `Co4ETab._open_run_output_folder` | 1670-1681 | `ui/co4e_tab.py` | kiểm tra path.exists()/mkdir + open_location | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1704-1715) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._rename_selected_run` | 1683-1714 | `ui/co4e_tab.py` | dựng QInputDialog; ghi self._flows, self.flow_bar (tab text), self._wf, self.name_edit — trạng thái chia sẻ giữa danh sách flow và tab đang mở; co4e.save_workflow ghi đĩa | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1717-1748) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._run_selected_in_background` | 1716-1726 | `ui/co4e_tab.py` | self.manager.start khởi chạy agent nền (ghi output ra đĩa) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1750-1760) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._wf_by_id` | 1728-1736 | `ui/co4e_tab.py` | co4e.get_workflow đọc workflow đã lưu từ đĩa; đọc self._wf | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1762-1770) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._rerun_run_item` | 1738-1749 | `ui/co4e_tab.py` | item là QTableWidgetItem; manager.start khởi chạy agent nền | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1772-1783) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._open_run_from_table` | 1751-1770 | `ui/co4e_tab.py` | gọi self._open_flow(wf), self.canvas.update_node_status — chạm canvas widget và self._wf | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 1785-1804) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab.showEvent` | 1772-1775 | `ui/co4e_tab.py` | override Qt event | co | - | +| `Co4ETab._out_dir` | 1777-1783 | `ui/co4e_tab.py` | mkdir(parents=True); đọc self._wf.name | co | - | +| `Co4ETab._chat_send` | 1786-1812 | `ui/co4e_tab.py` | theo yêu cầu, _chat_send KHÔNG thuộc co4e_chat_view.py dù đọc self.chat_input — ở lại Co4ETab; đọc/ghi self._chat_worker | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1820-1846) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._apply_co4e_routing` | 1814-1849 | `ui/co4e_tab.py` | ghi self._co4e_routed_provider (trạng thái đọc lại trong _run_chat_turn/job); nhánh manual gọi confirm_switch — mở dialog Qt (routing_toggle) nên cần widget sống ở nhánh đó | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1848-1883) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._co4e_routed_provider` | 1819 | `ui/co4e_tab.py` | gán lại mỗi lần gọi _apply_co4e_routing; được đọc bằng getattr(...,'None') ở _run_chat_turn/job — không chắc có init trong __init__ (nằm ngoài lát này) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1114; 1853) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._extract_agent_directive` | 1851-1857 | `ui/co4e_tab.py` | logic regex thuần, dễ test độc lập | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1885-1891) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._resolve_agent` | 1859-1867 | `ui/co4e_tab.py` | duyệt BUILTIN_AGENTS + co4e.list_custom_agents() (custom agents có thể đọc đĩa nhưng bản thân hàm chỉ gọi list) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1893-1901) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._run_chat_turn` | 1869-1940 | `ui/co4e_tab.py` | method dài (~72 dòng) gộp: build prompt, định nghĩa 4 closure lồng nhau (job/on_event/done/failed), khởi AgentWorker — nên tách; theo yêu cầu KHÔNG đưa job()/AgentWorker sang co4e_chat_view.py; đọc/ghi self.chat_log, self._wf, self._chat_worker (trạng thái chia sẻ) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1903-1974) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._run_chat_turn.job` | 1883-1912 | `ui/co4e_tab.py` | closure lồng trong _run_chat_turn, chạy trong AgentWorker thread; gọi run_cowork → gọi provider AI qua mạng; theo yêu cầu ở lại Co4ETab cùng _chat_send | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1917-1946) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._run_chat_turn.job._emit` | 1894-1901 | `ui/co4e_tab.py` | helper lồng bên trong job(), chuyển tiếp event streaming sang worker.emit_event | chua | BANG CU BO SOT: khong co dong nao cho symbol nay trong bang cu (363 dong) du no ro rang ton tai trong pham vi da quet -- co the do agent quet truoc bo lot, hoac day la ten sinh ra tu buoc gop lat cua ban do nay (vd ten method suy doan/tam). | +| `Co4ETab._run_chat_turn.on_event` | 1914-1920 | `ui/co4e_tab.py` | closure cập nhật assistant.set_markdown/log.scroll_to_bottom — cần widget sống; gọi self._append_plan | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1948-1954) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._run_chat_turn.done` | 1922-1928 | `ui/co4e_tab.py` | ghi self._chat_worker=None, gọi self._apply_usage — chạm self._flow_usage | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1956-1962) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._run_chat_turn.failed` | 1930-1933 | `ui/co4e_tab.py` | ghi self._chat_worker=None, gọi self._append_chat | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1964-1967) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._append_chat` | 1942-1957 | `ui/co4e_tab.py` | theo yêu cầu, _append_chat KHÔNG thuộc co4e_chat_view.py — dùng self.chat_log mặc định, business logic per-flow ở lại Co4ETab | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1976-1991) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._fmt_usage` | 1960-1967 | `ui/co4e_tab.py` | logic thuần định dạng chuỗi + tra bảng giá từ self.ctx.config.data — test được không cần Qt | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 1994-2001) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._apply_usage` | 1969-1986 | `ui/co4e_tab.py` | ghi self._flow_usage (tổng usage theo từng flow — trạng thái chia sẻ với composer label usage-total ở co4e_chat_view.py); gọi bub.add_usage cần widget bubble sống | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 2003-2020) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._refresh_usage_total` | 1988-2003 | `ui/co4e_tab.py` | đọc self._flow_usage, self._wf; ghi self._usage_total_lbl.setText — label này được dựng trong co4e_chat_view.py (composer) nên đây là điểm nối trạng thái chia sẻ giữa 2 file | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 2022-2037) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._append_diff` | 2005-2009 | `ui/co4e_tab.py` | theo yêu cầu KHÔNG thuộc co4e_chat_view.py — ở lại Co4ETab | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 2039-2043) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._append_plan` | 2011-2022 | `ui/co4e_tab.py` | theo yêu cầu KHÔNG thuộc co4e_chat_view.py — dùng log._co4e_plan_bubble (state gắn trên đối tượng ChatView, không phải self) | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 2045-2056) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `Co4ETab._retranslate` | 2025-2045 | `ui/co4e_tab.py` | duyệt self._sections (trạng thái chia sẻ toàn tab) và setText hàng loạt widget nhiều khu vực khác nhau (runs, sidebar, header) — cắt ngang nhiều nhóm chức năng khác nhau nên khó tách gọn | co | - | +| `_html_escape` | 2048-2049 | `ui/co4e_tab.py` | hàm module-level, tiện ích thuần chuỗi, không thuộc riêng chat_view | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_chat_view.py` (dong 2082-2083) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | +| `_qcolor` | 2052-2054 | `ui/co4e_tab.py` | QColor dùng như kiểu giá trị, không cần QApplication sống | co | BANG CU KHAC: bang cu xep vao `presentation/co4e/co4e_run_control_widget.py` (dong 2086-2088) nhung theo mo ta dich cua lan quet nay -> quyet dinh o day = `ui/co4e_tab.py`. | + +## Chỗ thấy khác tài liệu — cần người quyết + +Không có symbol nào trong 220 symbol thô có note bắt đầu bằng `khac tai lieu:` — mục này để trống theo đúng yêu cầu tự kiểm (không có gì cần liệt kê). diff --git a/docs/architecture/co4e-split-map-node-property.json b/docs/architecture/co4e-split-map-node-property.json new file mode 100644 index 0000000..43b6e27 --- /dev/null +++ b/docs/architecture/co4e-split-map-node-property.json @@ -0,0 +1,123 @@ +{ + "scope": "StepConfigPanel (ui/co4e_config_panel.py, dong 1-528)", + "source_file": "ui/co4e_config_panel.py", + "symbols": [ + { + "symbol": "_SECTION_ANIM_MS", + "source_lines": "27", + "target_file": "presentation/co4e/step_config_section.py", + "note": "hang so animation cho _add_section" + }, + { + "symbol": "_SectionHeader", + "source_lines": "30-52", + "target_file": "presentation/co4e/step_config_section.py", + "note": "QLabel clickable, khung UI dung chung, khong co hanh vi nghiep vu rieng" + }, + { + "symbol": "_add_section", + "source_lines": "55-130", + "target_file": "presentation/co4e/step_config_section.py", + "note": "khung section gap/mo dung chung cho 4 nhom truong cua StepConfigPanel" + }, + { + "symbol": "StepConfigPanel (Signal + __init__)", + "source_lines": "133-313", + "target_file": "presentation/co4e/node_property_panel.py", + "note": "4 Signal (changed/run_node/run_from/delete_node) + dung toan bo form" + }, + { + "symbol": "StepConfigPanel.load_step", + "source_lines": "316-354", + "target_file": "presentation/co4e/node_property_panel.py", + "note": "nap Step vao form" + }, + { + "symbol": "StepConfigPanel.clear_step", + "source_lines": "356-359", + "target_file": "presentation/co4e/node_property_panel.py", + "note": "xoa state, tat panel" + }, + { + "symbol": "StepConfigPanel._on_edit", + "source_lines": "362-378", + "target_file": "presentation/co4e/node_property_panel.py", + "note": "ghi field UI nguoc vao Step" + }, + { + "symbol": "StepConfigPanel._available_agent_names", + "source_lines": "380-390", + "target_file": "presentation/co4e/node_property_actions_mixin.py", + "note": "staticmethod, chuyen vao mixin _StepConfigActionsMixin" + }, + { + "symbol": "StepConfigPanel._add_subagent", + "source_lines": "392-408", + "target_file": "presentation/co4e/node_property_actions_mixin.py", + "note": "chuyen vao mixin _StepConfigActionsMixin" + }, + { + "symbol": "StepConfigPanel._edit_subagent", + "source_lines": "410-428", + "target_file": "presentation/co4e/node_property_actions_mixin.py", + "note": "chuyen vao mixin _StepConfigActionsMixin" + }, + { + "symbol": "StepConfigPanel._del_subagent", + "source_lines": "430-437", + "target_file": "presentation/co4e/node_property_actions_mixin.py", + "note": "chuyen vao mixin _StepConfigActionsMixin" + }, + { + "symbol": "StepConfigPanel._add_attachment", + "source_lines": "439-453", + "target_file": "presentation/co4e/node_property_actions_mixin.py", + "note": "chuyen vao mixin _StepConfigActionsMixin" + }, + { + "symbol": "StepConfigPanel._del_attachment", + "source_lines": "455-462", + "target_file": "presentation/co4e/node_property_actions_mixin.py", + "note": "chuyen vao mixin _StepConfigActionsMixin" + }, + { + "symbol": "StepConfigPanel._ai_draft", + "source_lines": "464-498", + "target_file": "presentation/co4e/node_property_actions_mixin.py", + "note": "chuyen vao mixin _StepConfigActionsMixin; dung AgentWorker that" + }, + { + "symbol": "StepConfigPanel._load_models", + "source_lines": "500-528", + "target_file": "presentation/co4e/node_property_actions_mixin.py", + "note": "chuyen vao mixin _StepConfigActionsMixin; dung AgentWorker that" + } + ], + "old_file_after_split": { + "file": "ui/co4e_config_panel.py", + "content": "module docstring (sua, van tieng Anh) + import lai StepConfigPanel tu presentation/co4e/node_property_panel.py + __all__", + "lines": 14 + }, + "new_files": [ + {"file": "presentation/co4e/step_config_section.py", "lines": 134}, + {"file": "presentation/co4e/node_property_actions_mixin.py", "lines": 202}, + {"file": "presentation/co4e/node_property_panel.py", "lines": 293} + ], + "inheritance": { + "class": "StepConfigPanel", + "bases": ["_StepConfigActionsMixin", "QScrollArea"], + "mandatory_order": false, + "reason": "khong co method nao cua _StepConfigActionsMixin trung ten voi QScrollArea (khac Co4ECanvas voi paintEvent/mousePressEvent), nen thu tu ke thua khong anh huong hanh vi; giu mixin-truoc chi de nhat quan quy uoc" + }, + "deliberate_unused_import_kept": { + "name": "PROVIDER_LABELS", + "source_line": 21, + "target_file": "presentation/co4e/node_property_panel.py", + "reason": "khong dung o dau trong ban goc (da xac minh bang grep); giu nguyen de dung pham vi chi doi cho, khong don dep import thua" + }, + "test_patch_adaptation": { + "file": "tests/characterization/test_node_property_panel.py", + "what_changed": "case CASE_ADD_SUBAGENT_EMPTY_NAMES_USES_GETTEXT_QUIRK_OK doi tu StepConfigPanel.__dict__[\"_available_agent_names\"] (luu roi gan lai) sang del StepConfigPanel._available_agent_names (xoa override de roi ve lai method ke thua tu mixin)", + "why": "sau khi _available_agent_names chuyen vao _StepConfigActionsMixin, no khong con nam truc tiep trong StepConfigPanel.__dict__ nen loi KeyError; day la thay doi CACH patch/restore trong test, KHONG doi assert/hanh vi nao duoc kiem tra" + } +} diff --git a/docs/architecture/co4e-split-map-node-property.md b/docs/architecture/co4e-split-map-node-property.md new file mode 100644 index 0000000..80c0ad5 --- /dev/null +++ b/docs/architecture/co4e-split-map-node-property.md @@ -0,0 +1,102 @@ +# Bản đồ tách `StepConfigPanel` (`ui/co4e_config_panel.py` → `presentation/co4e/`) + +- **Phạm vi lượt này:** chỉ `StepConfigPanel` (nguyên bản dòng 1-528 của + `ui/co4e_config_panel.py`). Không đụng file nào khác thuộc làn N1 + (`ui/co4e_tab.py`, `ui/co4e_canvas.py`, `docs/architecture/co4e-split-map.md`/`.json`). +- **Lý do phải tách thêm, dù chỉ 1 class:** `StepConfigPanel` một mình đã 396 + dòng (133-528); cộng thêm module docstring + khối import của một file riêng + sẽ vượt trần 400 dòng (CASAN Check 2). Giải pháp: cắt-dán (không viết lại + logic) thành 3 file theo trách nhiệm. + +## File đích + +| symbol | dòng gốc | file đích | ghi chú | +|---|---|---|---| +| `_SECTION_ANIM_MS` | 27 | `presentation/co4e/step_config_section.py` | hằng số dùng bởi `_add_section` | +| `_SectionHeader` | 30-52 | `presentation/co4e/step_config_section.py` | `QLabel` clickable, không có hành vi nghiệp vụ riêng | +| `_add_section` | 55-130 | `presentation/co4e/step_config_section.py` | khung ▶/▼ dùng chung cho 4 nhóm trường của `StepConfigPanel`; không đọc/ghi state của panel | +| `StepConfigPanel` (Signal + `__init__`) | 133-313 | `presentation/co4e/node_property_panel.py` | 4 Signal (`changed`/`run_node`/`run_from`/`delete_node`) + dựng toàn bộ form | +| `StepConfigPanel.load_step` | 316-354 | `presentation/co4e/node_property_panel.py` | nạp `Step` vào form | +| `StepConfigPanel.clear_step` | 356-359 | `presentation/co4e/node_property_panel.py` | xoá state, tắt panel | +| `StepConfigPanel._on_edit` | 362-378 | `presentation/co4e/node_property_panel.py` | ghi field UI ngược vào `Step` | +| `StepConfigPanel._available_agent_names` | 380-390 | `presentation/co4e/node_property_actions_mixin.py` (`_StepConfigActionsMixin`) | staticmethod, dùng bởi `_add_subagent`/`_edit_subagent` | +| `StepConfigPanel._add_subagent` | 392-408 | `presentation/co4e/node_property_actions_mixin.py` | | +| `StepConfigPanel._edit_subagent` | 410-428 | `presentation/co4e/node_property_actions_mixin.py` | | +| `StepConfigPanel._del_subagent` | 430-437 | `presentation/co4e/node_property_actions_mixin.py` | | +| `StepConfigPanel._add_attachment` | 439-453 | `presentation/co4e/node_property_actions_mixin.py` | | +| `StepConfigPanel._del_attachment` | 455-462 | `presentation/co4e/node_property_actions_mixin.py` | | +| `StepConfigPanel._ai_draft` | 464-498 | `presentation/co4e/node_property_actions_mixin.py` | dùng `AgentWorker` thật (không mock trong `__init__`) | +| `StepConfigPanel._load_models` | 500-528 | `presentation/co4e/node_property_actions_mixin.py` | dùng `AgentWorker` thật | + +## Cách ghép lại: mixin + đa kế thừa + +`node_property_panel.py`: +```python +class StepConfigPanel(_StepConfigActionsMixin, QScrollArea): + ... +``` + +`_StepConfigActionsMixin` là mixin THUẦN — không `__init__` riêng, chỉ đọc/ghi +state có sẵn trên `self` do `StepConfigPanel.__init__` định nghĩa +(`self._step`, `self._node_id`, `self.ctx`, `self.sub_list`, `self.attach_list`, +`self.instructions_edit`, `self.gen_btn`, `self.model_combo`, +`self.load_models_btn`). + +Khác với bước `co4e_canvas_widget.py` (Co4ECanvas override nhiều method Qt như +`paintEvent`/`mousePressEvent`, nên thứ tự mixin-trước-base là **bắt buộc** để +MRO ưu tiên override của mixin): ở đây **không có method nào của +`_StepConfigActionsMixin` trùng tên với `QScrollArea`**, nên thứ tự kế thừa +không ảnh hưởng hành vi. Giữ thứ tự mixin-trước chỉ để nhất quán quy ước, không +phải yêu cầu kỹ thuật bắt buộc. + +## Import thừa cố ý giữ nguyên + +`PROVIDER_LABELS` (nguyên bản dòng 21, `from ..config import PROVIDER_LABELS`) +không được dùng ở đâu trong toàn bộ `ui/co4e_config_panel.py` gốc (đã xác minh +bằng grep). Vẫn giữ nguyên import này trong `node_property_panel.py` (chỉ đổi +số cấp `..` → `...`), không xoá, để đúng phạm vi "chỉ dời chỗ" của lượt tách +này — xoá một import "thừa" là một quyết định dọn dẹp ngoài phạm vi được giao. + +## Thay đổi comment/test ngoài phạm vi "chỉ dời chỗ" (ghi riêng, không lẫn vào phần move) + +1. **Docstring module của 3 file mới** (`step_config_section.py`, + `node_property_actions_mixin.py`, `node_property_panel.py`) — viết MỚI hoàn + toàn bằng tiếng Việt theo quy ước CASAN cho file mới trong `presentation/` + (mẫu `infrastructure/persistence/json/atomic_json_file.py`). Đây không phải + sửa một comment cũ bị sai do dời chỗ — module docstring nguyên bản (dòng + 1-9 của `ui/co4e_config_panel.py`) mô tả cả file cũ (đã bị chia làm 3), nên + mỗi file mới cần một docstring kiến trúc riêng thay vì copy y hệt bản gốc. +2. **`ui/co4e_config_panel.py`** (file cũ) — docstring được viết lại (vẫn + tiếng Anh, khớp quy ước "sửa file cũ tiếng Anh thì giữ tiếng Anh") để nói rõ + `StepConfigPanel` đã dời đi đâu, thay vì mô tả hành vi như thể class còn + định nghĩa tại chỗ — comment cũ sẽ SAI (nói rằng lớp "ở đây" trong khi + không còn) nếu giữ nguyên. +3. **`tests/characterization/test_node_property_panel.py`** (dòng ~296-307 + nguyên bản) — SỬA kỹ thuật patch/restore của case + `CASE_ADD_SUBAGENT_EMPTY_NAMES_USES_GETTEXT_QUIRK_OK`, không đổi bất kỳ + assert/hành vi nào. Bản gốc dùng + `StepConfigPanel.__dict__["_available_agent_names"]` để lưu lại method gốc + trước khi monkey-patch, rồi gán lại y hệt lúc restore. Sau khi + `_available_agent_names` chuyển vào `_StepConfigActionsMixin` (mixin riêng), + nó không còn nằm trong `StepConfigPanel.__dict__` (chỉ được kế thừa qua + MRO) → `KeyError`. Thay bằng: gán đè trực tiếp lên `StepConfigPanel` (vẫn + shadow đúng như cũ), và khi xong dùng `del StepConfigPanel._available_agent_names` + để nó rơi trở lại đúng method kế thừa từ mixin — hành vi quan sát được của + test (các assert `sub_agents`) giữ nguyên 100%, chỉ đổi CÁCH lưu/khôi phục + attribute bị monkey-patch. Đây là hệ quả tất yếu của yêu cầu tách mixin + trong lượt này (test được viết khi class còn nguyên khối), không phải sửa + test để che một thay đổi hành vi. + +## Xác minh + +- `.venv/Scripts/python.exe tools/check_co4e.py` — chạy TRƯỚC và SAU khi sửa, + output giống hệt nhau cả 2 lần (`KET QUA: Co4E sap xep lai, khong mat control nao`). +- `.venv/Scripts/python.exe -m pytest tests/characterization/test_node_property_panel.py -q` + — `1 passed` cả trước (đo trên code gốc, class còn ở `ui/co4e_config_panel.py`) + lẫn sau khi tách. +- `.venv/Scripts/python.exe -m pytest tests -q --tb=short -rf --continue-on-collection-errors` + — `287 passed, 1 skipped` sau khi tách (không có test nào khác vỡ vì import + `StepConfigPanel` từ `ui/co4e_config_panel.py`). +- AST-scan `domain/`+`application/` cho import PySide6/PyQt: `KHONG CO`. +- Số dòng file mới: `node_property_panel.py` 293, `node_property_actions_mixin.py` + 202, `step_config_section.py` 134 — cả 3 đều ≤ 400. diff --git a/docs/architecture/co4e-split-map-run-control.json b/docs/architecture/co4e-split-map-run-control.json new file mode 100644 index 0000000..10f9485 --- /dev/null +++ b/docs/architecture/co4e-split-map-run-control.json @@ -0,0 +1,2807 @@ +{ + "lane": "run-control (Flow Status / trang Runs)", + "source_file_scanned": "ui/co4e_tab.py", + "generated_from_raw_symbol_count": 215, + "raw_scan_agents": 3, + "final_row_count": 214, + "run_control_widget_target": "presentation/co4e/co4e_run_control_widget.py", + "container_target": "ui/co4e_tab.py", + "run_control_widget_symbol_count": 18, + "container_symbol_count": 173, + "other_lane_symbol_count": 23, + "khac_tai_lieu_notes_found": 0, + "merged_duplicate_symbol_groups": [ + "Co4ETab._reload_sidebar (dong 685, 2 luot quet trung, gop thanh 685-718)" + ], + "kept_separate_anomaly_symbols": [ + "Co4ETab.showEvent (2 dinh nghia cung ten trong 1 class -- anomaly co that trong source, ban thu 2 de len ban dau luc runtime; khop voi 'kept_separate_anomaly_symbols' cua bang cu)" + ], + "old_table_reference": "docs/architecture/co4e-split-map.json", + "systemic_old_table_finding": "Bang cu dung target_file='presentation/co4e/co4e_tab.py' cho phan than class Co4ETab con lai, nhung file that o repo hien tai la ui/co4e_tab.py (2084+ dong) -- presentation/co4e/co4e_tab.py chi la factory build_co4e_tab() 53 dong (xem docstring file do), khong phai noi class Co4ETab song. Moi so sanh trong bang nay da tu quy doi 'presentation/co4e/co4e_tab.py' -> 'ui/co4e_tab.py' truoc khi ket luan mismatch.", + "scope_narrowing_finding": "Bang cu (o thoi diem no duoc quet) coi co4e_run_control_widget.py la ca 'run control' theo nghia rong: gom ca bang Runs (runs_table) LAN logic thuc thi run (start/stop/manual-mode/mode-toolbar/event routing/popup) va ca sidebar quick-list cac run gan day. Mo ta dich cua lan quet 3-agent lan nay (an trong ghi chu tung dong) thu hep pham vi: co4e_run_control_widget.py CHI con la TRANG Runs/Flow Status (bang + nut hanh dong tren tung dong + nut mo thu muc workspace); logic thuc thi run, toolbar mode/run, va sidebar quick-list deu o lai ui/co4e_tab.py. Day la khac biet lon nhat giua bang cu va bang nay -- xem cot 'cho nao thay bang cu sai' cho tung dong lien quan.", + "khac_tai_lieu_rows": [], + "rows": [ + { + "symbol": "_PLAN_GLYPH", + "kind": "attribute", + "line_start": 46, + "line_end": 47, + "line_display": "46-47", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "module-level dict constant, không phải self. -- QUYET DINH: glyph dùng bởi _fmt_plan cho bong bóng 'plan' trong CHAT, không phải bảng Runs; bảng cũ xếp nhầm vào co4e_run_control_widget.py", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 45-46) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "_fmt_plan", + "kind": "function", + "line_start": 50, + "line_end": 59, + "line_display": "50-59", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "helper format cho _append_plan (chat), không đụng runs_table; bảng cũ xếp nhầm vào co4e_run_control_widget.py", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 49-58) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "_skill_names", + "kind": "function", + "line_start": 62, + "line_end": 66, + "line_display": "62-66", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "gọi skills_mod.list_skills()/builtin_skills() — có thể chạm đĩa qua core.skills -- QUYET DINH: helper autocomplete cho _ChatInput — thuộc lane co4e_chat_view.py (chưa tồn tại), ngoài phạm vi lane run-control nên giữ nguyên vị trí hiện tại", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_agent_names", + "kind": "function", + "line_start": 69, + "line_end": 72, + "line_display": "69-72", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "gọi co4e.list_custom_agents() — chạm đĩa qua core.co4e -- QUYET DINH: cùng lý do với _skill_names — autocomplete /agent trong chat", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_EqualTabBar", + "kind": "class", + "line_start": 75, + "line_end": 95, + "line_display": "75-95", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "helper QTabBar cho sidebar icon-tabs — không liên quan Flow Status -- QUYET DINH: QTabBar tiện ích cho sidebar icon-tabs, không liên quan Runs", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_EqualTabBar._GAP", + "kind": "attribute", + "line_start": 81, + "line_end": 81, + "line_display": "81", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "hằng số nội bộ của _EqualTabBar", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_EqualTabBar.tabSizeHint", + "kind": "method", + "line_start": 83, + "line_end": 91, + "line_display": "83-91", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_EqualTabBar.resizeEvent", + "kind": "method", + "line_start": 93, + "line_end": 95, + "line_display": "93-95", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_PaletteList", + "kind": "class", + "line_start": 98, + "line_end": 120, + "line_display": "98-120", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "list kéo-thả vào canvas cho Workflows/Agents/Skills palette — không phải Runs -- QUYET DINH: list kéo-thả cho palette Workflows/Agents/Skills, không phải Runs", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_PaletteList.__init__", + "kind": "method", + "line_start": 103, + "line_end": 107, + "line_display": "103-107", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_PaletteList._payload_role", + "kind": "attribute", + "line_start": 105, + "line_end": 105, + "line_display": "105", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_PaletteList.startDrag", + "kind": "method", + "line_start": 109, + "line_end": 120, + "line_display": "109-120", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_directive_token", + "kind": "function", + "line_start": 123, + "line_end": 135, + "line_display": "123-135", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "logic thuần regex cho autocomplete /skill /agent trong chat — test được không cần Qt -- QUYET DINH: regex thuần cho autocomplete /skill /agent — lane co4e_chat_view.py (chưa tồn tại), giữ nguyên", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput", + "kind": "class", + "line_start": 138, + "line_end": 227, + "line_display": "138-227", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "ô chat với popup autocomplete — không liên quan Flow Status -- QUYET DINH: ô nhập chat với popup autocomplete — lane co4e_chat_view.py (chưa tồn tại), giữ nguyên", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput.submit", + "kind": "attribute", + "line_start": 142, + "line_end": 142, + "line_display": "142", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "Signal khai báo ở cấp lớp -- QUYET DINH: Signal của _ChatInput — đi cùng class", + "in_old_table": "chua", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput.__init__", + "kind": "method", + "line_start": 144, + "line_end": 152, + "line_display": "144-152", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput._popup", + "kind": "attribute", + "line_start": 146, + "line_end": 146, + "line_display": "146", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput._maybe_popup", + "kind": "method", + "line_start": 154, + "line_end": 179, + "line_display": "154-179", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "gọi _skill_names/_agent_names (chạm đĩa gián tiếp) và định vị popup bằng tọa độ màn hình", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput._add_row", + "kind": "method", + "line_start": 181, + "line_end": 185, + "line_display": "181-185", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput._accept", + "kind": "method", + "line_start": 187, + "line_end": 200, + "line_display": "187-200", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput.focusOutEvent", + "kind": "method", + "line_start": 202, + "line_end": 205, + "line_display": "202-205", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_ChatInput.keyPressEvent", + "kind": "method", + "line_start": 207, + "line_end": 227, + "line_display": "207-227", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab", + "kind": "class", + "line_start": 230, + "line_end": 700, + "line_display": "230-700", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "cắt ngang lát — cần agent gộp đối chiếu (thân lớp trải dài quá dòng 700, đây chỉ là phần đầu) -- QUYET DINH: lớp container chính — phần còn lại sau khi các widget con (canvas/node-property/agent/skills/run-control/chat) đã tách", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.status_message", + "kind": "attribute", + "line_start": 231, + "line_end": 231, + "line_display": "231", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "Signal khai báo ở cấp lớp -- QUYET DINH: Signal cấp lớp của chính Co4ETab; KHÔNG có trong bảng cũ (thiếu sót ở đó)", + "in_old_table": "chua", + "old_table_mismatch": "BANG CU BO SOT: khong co dong nao cho symbol nay du no ro rang ton tai trong pham vi da quet (367 symbol tho cua bang cu) -- co the do agent quet truoc bo lot." + }, + { + "symbol": "Co4ETab.__init__", + "kind": "method", + "line_start": 233, + "line_end": 305, + "line_display": "233-305", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "gộp nhiều việc: khởi state run-per-flow, dựng splitter 3 cột, wiring StepConfigPanel, narrow-guard, rồi mở flow đầu tiên — biên độ rủi ro cao khi tách vì đụng gần hết thuộc tính self chia sẻ toàn tab -- QUYET DINH: constructor container — sẽ đổi để dựng Co4ERunControlWidget thay vì tự vẽ bảng Runs", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.ctx", + "kind": "attribute", + "line_start": 235, + "line_end": 235, + "line_display": "235", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._wf", + "kind": "attribute", + "line_start": 236, + "line_end": 236, + "line_display": "236", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "trạng thái chia sẻ toàn tab — workflow đang hiển thị trên canvas, đọc/ghi bởi rất nhiều method (flow tabs, run, sidebar, config) -- QUYET DINH: trạng thái trung tâm toàn tab, container giữ", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._chat_worker", + "kind": "attribute", + "line_start": 237, + "line_end": 237, + "line_display": "237", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "AgentWorker của chat — lane co4e_chat_view.py chưa tồn tại, giữ nguyên", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.manager", + "kind": "attribute", + "line_start": 239, + "line_end": 239, + "line_display": "239", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "Co4ERunManager dùng chung giữa canvas (mirror trạng thái node) và trang Runs (self.runs_table — định nghĩa ngoài dòng 700, có thể ở co4e_run_control_widget) — điểm nối quan trọng giữa hai lát -- QUYET DINH: Co4ERunManager dùng chung giữa canvas, chat VÀ bảng Runs — quyết định: container SỞ HỮU, co4e_run_control_widget.py nhận qua constructor/callback (dependency injection) thay vì tự tạo. Bảng cũ xếp thẳng vào co4e_run_control_widget.py dù chính ghi chú của nó gọi đây là 'điểm nối' — coi là quá vội", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 238) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._flow_runs", + "kind": "attribute", + "line_start": 244, + "line_end": 244, + "line_display": "244", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "trạng thái chia sẻ wf_id -> active run id, đọc/ghi bởi _open_flow, _close_flow_tab, _cur_run_id, _reflect_active_run -- QUYET DINH: dict wf_id->run id, ghi bởi _open_flow/_close_flow_tab/_start_canvas_run (đều ở co4e_tab.py) — container giữ, run-control đọc/ghi qua callback. Bảng cũ xếp vào co4e_run_control_widget.py — không khớp nơi ghi chính", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 243) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._run_logs", + "kind": "attribute", + "line_start": 245, + "line_end": 245, + "line_display": "245", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "map run_id->ChatView (thuộc lane chat), ghi bởi _manual_step/_start_canvas_run ở co4e_tab.py — container giữ", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 244) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._flow_outputs", + "kind": "attribute", + "line_start": 246, + "line_end": 246, + "line_display": "246", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "application/workflows/co4e_workflow_service.py", + "reason": "đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi lane run-control. Hiện tại vật lý vẫn còn ở ui/co4e_tab.py dòng 246 chờ lane đó dọn", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._flow_usage", + "kind": "attribute", + "line_start": 249, + "line_end": 249, + "line_display": "249", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "usage token/cost hiển thị ở header CHAT (Messages), không phải bảng Runs — bảng cũ xếp nhầm vào co4e_run_control_widget.py", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 248) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._project_id", + "kind": "attribute", + "line_start": 250, + "line_end": 250, + "line_display": "250", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "workspace hiện chọn — dùng chung bởi chat (_out_dir) và nút mở-thư-mục của Runs; container giữ, expose qua callback", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._project_dir", + "kind": "attribute", + "line_start": 251, + "line_end": 251, + "line_display": "251", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "cùng lý do với _project_id", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._manual_active", + "kind": "attribute", + "line_start": 253, + "line_end": 253, + "line_display": "253", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "trạng thái MODE THỦ CÔNG — thuộc nhóm run-execution, mô tả đích lane này loại trừ mode/run toolbar khỏi co4e_run_control_widget.py. Bảng cũ xếp vào co4e_run_control_widget.py — mâu thuẫn trực tiếp với phạm vi hiện tại", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 252) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._manual_order", + "kind": "attribute", + "line_start": 254, + "line_end": 254, + "line_display": "254", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "cùng nhóm với _manual_active — xem lý do ở đó", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 253) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._manual_idx", + "kind": "attribute", + "line_start": 255, + "line_end": 255, + "line_display": "255", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "cùng nhóm với _manual_active — xem lý do ở đó", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 254) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._flows", + "kind": "attribute", + "line_start": 258, + "line_end": 258, + "line_display": "258", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "trạng thái chia sẻ danh sách flow đang mở (browser-style tabs) — đọc/ghi bởi toàn bộ nhóm _open_flow/_close_flow_tab/_on_flow_tab_changed -- QUYET DINH: danh sách flow-tab kiểu browser, không phải Runs", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._active_flow_idx", + "kind": "attribute", + "line_start": 259, + "line_end": 259, + "line_display": "259", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "cùng nhóm trạng thái chia sẻ với _flows -- QUYET DINH: cùng nhóm với _flows", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._split", + "kind": "attribute", + "line_start": 262, + "line_end": 262, + "line_display": "262", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "splitter 3 cột của cả tab", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.config", + "kind": "attribute", + "line_start": 269, + "line_end": 269, + "line_display": "269", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "container giữ tham chiếu StepConfigPanel (đã tách ở node_property_panel.py, file cấm sửa của lane khác) — cùng khuôn mẫu với _agent_panel/_skills_panel: instance do container tạo/giữ, nội dung panel ở file riêng. Bảng cũ xếp thẳng dòng này vào node_property_panel.py — không nhất quán với cách nó xử lý _agent_panel", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._config_collapsed", + "kind": "attribute", + "line_start": 275, + "line_end": 275, + "line_display": "275", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "trạng thái thu/phóng của KHUNG bọc quanh panel (co4e_tab.py), không phải nội dung panel", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._config_expanded_w", + "kind": "attribute", + "line_start": 276, + "line_end": 276, + "line_display": "276", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "cùng lý do với _config_collapsed", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._narrow_guard", + "kind": "attribute", + "line_start": 281, + "line_end": 281, + "line_display": "281", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "guard bố cục hẹp của cả tab", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._open_flow", + "kind": "method", + "line_start": 308, + "line_end": 339, + "line_display": "308-339", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc/ghi self._flows, self._active_flow_idx, self.flow_bar — quản lý flow tab kiểu browser, không phải trang Runs -- QUYET DINH: quản lý flow-tab kiểu browser", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._close_other_flows", + "kind": "method", + "line_start": 341, + "line_end": 356, + "line_display": "341-356", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc/ghi self._flows, self._active_flow_idx, self.flow_bar", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._show_runs", + "kind": "method", + "line_start": 358, + "line_end": 368, + "line_display": "358-368", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "chuyển center_stack giữa flow editor và trang Runs; gọi bởi self.runs_btn (định nghĩa ngoài dòng 700, thuộc toolbar) và runs_more_btn (sidebar) — không thao tác trực tiếp runs_table nên không chắc thuộc co4e_run_control_widget hay ở lại co4e_tab.py làm điều phối trang -- QUYET DINH: điều phối chuyển trang center_stack giữa flow editor và trang Runs — container sở hữu center_stack; sẽ gọi API show()/hide() hoặc setCurrentWidget trên Co4ERunControlWidget thay vì tự vẽ", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._on_flow_tab_changed", + "kind": "method", + "line_start": 370, + "line_end": 386, + "line_display": "370-386", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc/ghi self._active_flow_idx, self.center_stack (self.center_stack định nghĩa ngoài dòng 700)", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._sync_runs_toggle", + "kind": "method", + "line_start": 388, + "line_end": 395, + "line_display": "388-395", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "dùng getattr(self, 'runs_btn', None) vì runs_btn (toolbar, ngoài dòng 700) có thể chưa tồn tại — đồng bộ trạng thái toggle của trang Runs -- QUYET DINH: đồng bộ nút toggle runs_btn ở toolbar (thuộc co4e_tab.py, KHÔNG phải trang Runs)", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._add_tab_close_button", + "kind": "method", + "line_start": 397, + "line_end": 407, + "line_display": "397-407", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._close_flow_tab_button", + "kind": "method", + "line_start": 409, + "line_end": 413, + "line_display": "409-413", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._close_flow_tab", + "kind": "method", + "line_start": 415, + "line_end": 443, + "line_display": "415-443", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc/ghi self._flow_runs, self._run_logs, self._flows, self._active_flow_idx, self.run_btn (định nghĩa ngoài dòng 700) — nhiều trạng thái chia sẻ chạm cùng lúc", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._sync_active_flow_tab_text", + "kind": "method", + "line_start": 445, + "line_end": 448, + "line_display": "445-448", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._reflect_active_run", + "kind": "method", + "line_start": 450, + "line_end": 458, + "line_display": "450-458", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc self.manager.all_runs(), ghi self._flow_runs, gọi self.canvas.update_node_status — cầu nối giữa run manager (chia sẻ với trang Runs) và canvas -- QUYET DINH: cầu nối manager -> canvas (update_node_status trên canvas thuộc co4e_tab.py) — đi cùng nhóm thực thi run, không phải bảng Runs", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._cur_run_id", + "kind": "method", + "line_start": 461, + "line_end": 474, + "line_display": "461-474", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "logic thuần: đọc self._wf, self._flow_runs, self.manager.get() — test được không cần Qt -- QUYET DINH: tra cứu run đang chạy CỦA FLOW HIỆN TẠI, dùng bởi _reflect_active_run (canvas mirror, co4e_tab.py) — không đụng runs_table. Bảng cũ xếp vào co4e_run_control_widget.py — không khớp nơi dùng chính", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 460-473) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._outputs_for", + "kind": "method", + "line_start": 476, + "line_end": 479, + "line_display": "476-479", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "application/workflows/co4e_workflow_service.py", + "reason": "logic thuần dict, test được không cần Qt -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ) cho cặp _flow_outputs/_outputs_for; ngoài phạm vi lane run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._update_run_btn", + "kind": "method", + "line_start": 481, + "line_end": 483, + "line_display": "481-483", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "thuộc nhóm run toolbar (self.run_btn) — theo mô tả target, co4e_run_control_widget KHÔNG bao gồm mode/run toolbar nên method này không nên vào đó -- QUYET DINH: nút Run của toolbar mode/run — mô tả đích loại trừ nhóm này khỏi co4e_run_control_widget.py; bảng cũ xếp vào đó — mâu thuẫn với phạm vi hiện tại", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 480-482) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._build_sidebar", + "kind": "method", + "line_start": 486, + "line_end": 599, + "line_display": "486-599", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "method dài >80 dòng, gộp nhiều việc không liên quan nhau: dựng section Workflows (list + edit/dup/del/run-bg), section Agents (AgentListPanel wiring), section Skills (SkillsListPanel wiring), section Runs sidebar quick-list, và lắp splitter dọc side_split — nên tách nhỏ thêm theo từng section -- QUYET DINH: dựng toàn bộ sidebar (Workflows/Agents/Skills/Runs quick-list)", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._sections", + "kind": "attribute", + "line_start": 494, + "line_end": 494, + "line_display": "494", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "dict trạng thái chia sẻ cho các section sidebar (fold/unfold) — đọc/ghi bởi _section, _fold_section, _sync_section_arrow", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.sidebar", + "kind": "attribute", + "line_start": 495, + "line_end": 495, + "line_display": "495", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.side_split", + "kind": "attribute", + "line_start": 499, + "line_end": 499, + "line_display": "499", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_build_sidebar._Col", + "kind": "class", + "line_start": 504, + "line_end": 512, + "line_display": "504-512", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "class cục bộ (locals) bên trong _build_sidebar — adapter cho side_split, không phải class module-level -- QUYET DINH: class cục bộ, adapter cho side_split", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_Col.__init__", + "kind": "method", + "line_start": 507, + "line_end": 508, + "line_display": "507-508", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_Col.addWidget", + "kind": "method", + "line_start": 510, + "line_end": 512, + "line_display": "510-512", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_new_btn", + "kind": "attribute", + "line_start": 517, + "line_end": 517, + "line_display": "517", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_list", + "kind": "attribute", + "line_start": 528, + "line_end": 528, + "line_display": "528", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_edit_btn", + "kind": "attribute", + "line_start": 535, + "line_end": 535, + "line_display": "535", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_dup_btn", + "kind": "attribute", + "line_start": 536, + "line_end": 536, + "line_display": "536", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_del_btn", + "kind": "attribute", + "line_start": 537, + "line_end": 537, + "line_display": "537", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.wf_runbg_btn", + "kind": "attribute", + "line_start": 544, + "line_end": 544, + "line_display": "544", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._agent_panel", + "kind": "attribute", + "line_start": 556, + "line_end": 556, + "line_display": "556", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "AgentListPanel — panel đã tách sẵn ở presentation/co4e/agent_list_panel.py (ngoài phạm vi lát này) -- QUYET DINH: container giữ instance AgentListPanel (đã tách sẵn) — KHÔNG có trong bảng cũ (thiếu sót ở đó, ag_new_btn/agent_list/ag_edit_btn/ag_del_btn có dòng nhưng _agent_panel thì không)", + "in_old_table": "chua", + "old_table_mismatch": "BANG CU BO SOT: khong co dong nao cho symbol nay du no ro rang ton tai trong pham vi da quet (367 symbol tho cua bang cu) -- co the do agent quet truoc bo lot." + }, + { + "symbol": "Co4ETab.ag_new_btn", + "kind": "attribute", + "line_start": 557, + "line_end": 557, + "line_display": "557", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "reason": "alias trỏ tới self._agent_panel.new_btn — widget thật nằm ở agent_list_panel.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.agent_list", + "kind": "attribute", + "line_start": 559, + "line_end": 559, + "line_display": "559", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "reason": "alias trỏ tới self._agent_panel.list_widget", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.ag_edit_btn", + "kind": "attribute", + "line_start": 560, + "line_end": 560, + "line_display": "560", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "reason": "alias trỏ tới self._agent_panel.edit_btn", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.ag_del_btn", + "kind": "attribute", + "line_start": 562, + "line_end": 562, + "line_display": "562", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "reason": "alias trỏ tới self._agent_panel.del_btn", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._skills_panel", + "kind": "attribute", + "line_start": 571, + "line_end": 571, + "line_display": "571", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "SkillsListPanel — panel đã tách sẵn ở presentation/co4e/skills_list_panel.py (ngoài phạm vi lát này) -- QUYET DINH: container giữ instance SkillsListPanel (đã tách sẵn) — khớp bảng cũ", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.sk_manage_btn", + "kind": "attribute", + "line_start": 572, + "line_end": 572, + "line_display": "572", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/skills_list_panel.py", + "reason": "alias trỏ tới self._skills_panel.manage_btn — cùng bản chất với ag_new_btn ở trên. Bảng cũ xếp dòng này (và skill_list) vào co4e_tab.py trong khi ag_* tương ứng lại xếp vào agent_list_panel.py — KHÔNG NHẤT QUÁN giữa 2 cặp alias giống hệt nhau trong cùng bảng cũ; ở đây chọn xử lý đồng nhất với ag_*", + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHONG NHAT QUAN: xep Co4ETab.sk_manage_btn vao ui/co4e_tab.py trong khi alias tuong duong ben Agent (ag_new_btn/agent_list/...) lai xep vao agent_list_panel.py; o day chon dong nhat -> presentation/co4e/skills_list_panel.py." + }, + { + "symbol": "Co4ETab.skill_list", + "kind": "attribute", + "line_start": 574, + "line_end": 574, + "line_display": "574", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/skills_list_panel.py", + "reason": "alias trỏ tới self._skills_panel.list_widget — xem ghi chú ở sk_manage_btn", + "in_old_table": "co", + "old_table_mismatch": "BANG CU KHONG NHAT QUAN: xep Co4ETab.skill_list vao ui/co4e_tab.py trong khi alias tuong duong ben Agent (ag_new_btn/agent_list/...) lai xep vao agent_list_panel.py; o day chon dong nhat -> presentation/co4e/skills_list_panel.py." + }, + { + "symbol": "Co4ETab.runs_more_btn", + "kind": "attribute", + "line_start": 582, + "line_end": 582, + "line_display": "582", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "nút icon trong sidebar mở trang Runs (gọi self._show_runs(True)) — điểm vào trang Flow Status nhưng không phải một phần của bảng runs_table -- QUYET DINH: nút icon nằm trong sidebar (dựng bởi _build_sidebar, ở co4e_tab.py) mở trang Runs — không phải một phần của runs_table. Bảng cũ xếp vào co4e_run_control_widget.py vì cùng 'chủ đề Runs', nhưng nơi nó được XÂY lại là sidebar", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 586) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab.runs_side_list", + "kind": "attribute", + "line_start": 590, + "line_end": 590, + "line_display": "590", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "danh sách rút gọn các run trong sidebar — KHÁC với self.runs_table của trang Flow Status (định nghĩa ngoài dòng 700, có thể ở co4e_run_control_widget); dễ nhầm là cùng một bảng nên tách agent gộp cần đối chiếu -- QUYET DINH: danh sách rút gọn run trong sidebar, KHÁC self.runs_table của trang Flow Status — dựng trong _build_sidebar (co4e_tab.py). Mô tả đích của _build_runs_page nói rõ co4e_run_control_widget.py = bảng runs_table + nút hành động, không bao gồm sidebar quick-list", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 594) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._SIDE_RUNS", + "kind": "attribute", + "line_start": 601, + "line_end": 601, + "line_display": "601", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "hằng số class — số run hiển thị trong sidebar quick-list, không phải trang runs_table chính -- QUYET DINH: hằng số cho sidebar quick-list — cùng nhóm runs_side_list", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 605) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._refresh_side_runs", + "kind": "method", + "line_start": 603, + "line_end": 615, + "line_display": "603-615", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc self.manager.runs(), ghi self.runs_side_list — sidebar quick-list, khác trang Flow Status runs_table -- QUYET DINH: cùng nhóm runs_side_list", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 607-619) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._on_side_run_clicked", + "kind": "method", + "line_start": 617, + "line_end": 625, + "line_display": "617-625", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "gọi self._show_runs(True) rồi đọc self.runs_table (định nghĩa ngoài dòng 1-700, khả năng ở co4e_run_control_widget) để chọn dòng tương ứng — điểm nối giữa sidebar quick-list và trang Runs, cần agent gộp đối chiếu với file định nghĩa runs_table -- QUYET DINH: handler click của sidebar quick-list; có đọc self.runs_table nên cần API cầu nối sang co4e_run_control_widget.py khi tách, nhưng bản thân handler thuộc sidebar nên ở co4e_tab.py", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 621-629) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._section", + "kind": "method", + "line_start": 627, + "line_end": 659, + "line_display": "627-659", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "helper dựng UI section chung cho sidebar, ghi vào self._sections[key]", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._fold_section", + "kind": "method", + "line_start": 661, + "line_end": 673, + "line_display": "661-673", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc self._sections", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._sync_section_arrow", + "kind": "method", + "line_start": 675, + "line_end": 678, + "line_display": "675-678", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc self._sections", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._icon_btn", + "kind": "method", + "line_start": 679, + "line_end": 683, + "line_display": "679-683", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._reload_sidebar", + "kind": "method", + "line_start": 685, + "line_end": 718, + "line_display": "685-718", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "[GOP 2 luot quet trung ky hieu dong 685] cắt ngang lát — cần agent gộp đối chiếu (thân method tiếp tục ngoài dòng 700); gọi co4e.list_workflows() nên chạm đĩa || cắt ngang lát — cần agent gộp đối chiếu (bắt đầu ở dòng 685, trước khoảng được giao 701-1400; phần thấy được chỉ là vòng lặp nạp custom agents + skills vào agent_list/skill_list) -- QUYET DINH: [GỘP 2 lượt quét trùng ký hiệu ở dòng 685] một agent đọc thân đến 700 (cắt ngang lát), agent kia đọc tới 718 (vòng lặp nạp agent/skill) — gộp thành 1 dòng 685-718; nạp lại toàn bộ sidebar, không phải trang Runs", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._palette_item", + "kind": "method", + "line_start": 720, + "line_end": 724, + "line_display": "720-724", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "staticmethod tạo QListWidgetItem cho palette — không liên quan trang Runs -- QUYET DINH: factory QListWidgetItem cho palette — sidebar, không phải Runs", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._build_center", + "kind": "method", + "line_start": 727, + "line_end": 867, + "line_display": "727-867", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "method dài >80 dòng, gộp nhiều việc không liên quan: dựng flow tab bar (QTabBar ẩn), gọi _build_runs_page() để nhét vào center_stack, dựng toolbar flow (name/add/save/mode/run/runs toggle), dựng canvas + overlay + splitter dọc với chat. Nên tách nhỏ. Gán self.center_stack — trạng thái chia sẻ dùng ở nhiều nơi (switch giữa trang Runs và flow editor, cả _show_runs ngoài lát này). -- QUYET DINH: dựng flow tab bar + toolbar + canvas/chat splitter; GỌI self._build_runs_page() để nhét vào center_stack — khi tách, chỗ gọi này đổi thành khởi tạo Co4ERunControlWidget(...) rồi add vào center_stack", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.flow_bar", + "kind": "attribute", + "line_start": 734, + "line_end": 734, + "line_display": "734", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "QTabBar ẩn dùng làm index ánh xạ flow<->canvas, không phải trang Runs", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.flow_add_btn", + "kind": "attribute", + "line_start": 760, + "line_end": 760, + "line_display": "760", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.flow_scroll", + "kind": "attribute", + "line_start": 777, + "line_end": 777, + "line_display": "777", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.center_stack", + "kind": "attribute", + "line_start": 801, + "line_end": 801, + "line_display": "801", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "trạng thái chia sẻ giữa trang Runs (stack 0) và flow editor (stack 1) — dùng bởi _show_runs (ngoài lát này) để chuyển trang -- QUYET DINH: container sở hữu QStackedWidget chứa [trang Runs, flow editor]; trang Runs (index 0) sẽ LÀ instance Co4ERunControlWidget được add vào đây", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._build_runs_page", + "kind": "method", + "line_start": 869, + "line_end": 928, + "line_display": "869-928", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "khớp đúng mô tả đích: dựng bảng runs_table + nút back/stop/rename/delete/clear/mở-thư-mục-workspace", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.runs_back_btn", + "kind": "attribute", + "line_start": 878, + "line_end": 878, + "line_display": "878", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.runs_title", + "kind": "attribute", + "line_start": 883, + "line_end": 883, + "line_display": "883", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.ws_folder_btn", + "kind": "attribute", + "line_start": 888, + "line_end": 888, + "line_display": "888", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "nút mở thư mục workspace — click gọi self._open_workspace_folder (định nghĩa ngoài lát này, có khả năng touches_disk_or_network=true)", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.run_stop_btn", + "kind": "attribute", + "line_start": 896, + "line_end": 896, + "line_display": "896", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.run_rename_btn", + "kind": "attribute", + "line_start": 901, + "line_end": 901, + "line_display": "901", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.run_del_btn", + "kind": "attribute", + "line_start": 905, + "line_end": 905, + "line_display": "905", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.run_clear_btn", + "kind": "attribute", + "line_start": 909, + "line_end": 909, + "line_display": "909", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "click gọi self.manager.clear_finished() — self.manager là trạng thái chia sẻ (run manager) không định nghĩa trong lát này", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.runs_table", + "kind": "attribute", + "line_start": 917, + "line_end": 917, + "line_display": "917", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "bảng chính của trang Runs; double-click gọi self._open_run_from_table, context menu gọi self._runs_context_menu (cả hai định nghĩa ngoài lát này)", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._wrap_config", + "kind": "method", + "line_start": 930, + "line_end": 960, + "line_display": "930-960", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "wrap panel cấu hình step, không thuộc trang Runs -- QUYET DINH: khung bọc/thu-phóng quanh StepConfigPanel — thuộc bố cục của co4e_tab.py, không phải nội dung panel. Bảng cũ xếp cả cụm này vào node_property_panel.py (file cấm sửa của lane khác) — không đúng vai trò 'khung bọc' vs 'nội dung panel'", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.config_toggle_btn", + "kind": "attribute", + "line_start": 942, + "line_end": 942, + "line_display": "942", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "thuộc khung bọc _wrap_config", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.config_title", + "kind": "attribute", + "line_start": 947, + "line_end": 947, + "line_display": "947", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "thuộc khung bọc _wrap_config", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._cfg_vlayout", + "kind": "attribute", + "line_start": 953, + "line_end": 953, + "line_display": "953", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "thuộc khung bọc _wrap_config", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._cfg_top_spacer", + "kind": "attribute", + "line_start": 957, + "line_end": 957, + "line_display": "957", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "thuộc khung bọc _wrap_config", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._cfg_bot_spacer", + "kind": "attribute", + "line_start": 958, + "line_end": 958, + "line_display": "958", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "thuộc khung bọc _wrap_config", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.config_container", + "kind": "attribute", + "line_start": 959, + "line_end": 959, + "line_display": "959", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "thuộc khung bọc _wrap_config", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._NARROW", + "kind": "attribute", + "line_start": 967, + "line_end": 967, + "line_display": "967", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "hằng số class-level, không liên quan trang Runs -- QUYET DINH: hằng số bố cục hẹp của cả tab", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.showEvent", + "kind": "method", + "line_start": 969, + "line_end": 971, + "line_display": "969-971", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "Qt override, gắn narrow_guard -- QUYET DINH: [ANOMALY — 2 định nghĩa showEvent cùng tên trong 1 class, bảng cũ đã ghi nhận 'kept_separate_anomaly_symbols'] bản đầu (969-971) chỉ gắn narrow_guard, bị bản thứ 2 (1802) ghi đè lúc runtime; giữ TÁCH RIÊNG như bảng cũ", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._apply_narrow_layout", + "kind": "method", + "line_start": 973, + "line_end": 983, + "line_display": "973-983", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._toggle_config", + "kind": "method", + "line_start": 985, + "line_end": 1028, + "line_display": "985-1028", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "không thuộc trang Runs; đọc/ghi self._split (splitter 3 cột chia sẻ với _build_center/_wrap_config)", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._refresh_min_width", + "kind": "method", + "line_start": 1030, + "line_end": 1035, + "line_display": "1030-1035", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._build_canvas_overlay", + "kind": "method", + "line_start": 1037, + "line_end": 1058, + "line_display": "1037-1058", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "overlay zoom cho canvas — không thuộc trang Runs -- QUYET DINH: overlay zoom/fit gắn LÊN canvas qua self.canvas.add_overlay(); chấp nhận quyết định của bảng cũ — thuộc lane canvas, ngoài phạm vi run-control. Hiện tại canvas vẫn ở ui/co4e_canvas.py (chưa đổi tên), việc dời file này KHÔNG thuộc lane này", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.zoom_in_btn", + "kind": "attribute", + "line_start": 1050, + "line_end": 1050, + "line_display": "1050", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "nút overlay canvas — ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.zoom_out_btn", + "kind": "attribute", + "line_start": 1051, + "line_end": 1051, + "line_display": "1051", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "nút overlay canvas — ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.fit_btn", + "kind": "attribute", + "line_start": 1052, + "line_end": 1052, + "line_display": "1052", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "reason": "nút overlay canvas — ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._build_chat", + "kind": "method", + "line_start": 1060, + "line_end": 1123, + "line_display": "1060-1123", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "method dài >60 dòng, dựng toàn bộ khung chat (header, stack theo flow, composer, routing toggle, usage total) — không thuộc trang Runs -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._chat_widget", + "kind": "attribute", + "line_start": 1062, + "line_end": 1062, + "line_display": "1062", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._mhdr", + "kind": "attribute", + "line_start": 1068, + "line_end": 1068, + "line_display": "1068", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.msgs_icon", + "kind": "attribute", + "line_start": 1070, + "line_end": 1070, + "line_display": "1070", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.msgs_title", + "kind": "attribute", + "line_start": 1071, + "line_end": 1071, + "line_display": "1071", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.chat_toggle_btn", + "kind": "attribute", + "line_start": 1072, + "line_end": 1072, + "line_display": "1072", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.chat_stack", + "kind": "attribute", + "line_start": 1087, + "line_end": 1087, + "line_display": "1087", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "một ChatView mỗi flow — trạng thái chia sẻ đọc bởi _apply_workflow, _ensure_flow_log, _active_log -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._flow_logs", + "kind": "attribute", + "line_start": 1088, + "line_end": 1088, + "line_display": "1088", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "Dict[str, ChatView] theo wf.id — trạng thái chia sẻ giữa các tab flow -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.chat_input_row", + "kind": "attribute", + "line_start": 1090, + "line_end": 1090, + "line_display": "1090", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._usage_total_lbl", + "kind": "attribute", + "line_start": 1095, + "line_end": 1095, + "line_display": "1095", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.chat_input", + "kind": "attribute", + "line_start": 1101, + "line_end": 1101, + "line_display": "1101", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.chat_send_btn", + "kind": "attribute", + "line_start": 1104, + "line_end": 1104, + "line_display": "1104", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.co4e_routing_toggle", + "kind": "attribute", + "line_start": 1109, + "line_end": 1109, + "line_display": "1109", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._co4e_routed_provider", + "kind": "attribute", + "line_start": 1110, + "line_end": 1110, + "line_display": "1110", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "override provider định tuyến cho lượt kế tiếp — trạng thái đọc/ghi ở nhiều nơi ngoài lát này (dòng 1849, 1871, 1878) -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._vsplit_sizes", + "kind": "attribute", + "line_start": 1117, + "line_end": 1117, + "line_display": "1117", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._msgs_collapsed", + "kind": "attribute", + "line_start": 1118, + "line_end": 1118, + "line_display": "1118", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._toggle_messages", + "kind": "method", + "line_start": 1125, + "line_end": 1157, + "line_display": "1125-1157", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "expand/collapse khung chat, đọc/ghi self._vsplit — không thuộc trang Runs -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._ensure_flow_log", + "kind": "method", + "line_start": 1160, + "line_end": 1169, + "line_display": "1160-1169", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._active_log", + "kind": "method", + "line_start": 1171, + "line_end": 1173, + "line_display": "1171-1173", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.chat_log", + "kind": "attribute", + "line_start": 1175, + "line_end": 1179, + "line_display": "1175-1179", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "property, không phải attribute gán trực tiếp — liệt kê vì là symbol công khai -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._plan_bubble", + "kind": "attribute", + "line_start": 1181, + "line_end": 1187, + "line_display": "1181-1187", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "property getter/setter, ủy quyền sang self._active_log()._co4e_plan_bubble -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._apply_workflow", + "kind": "method", + "line_start": 1190, + "line_end": 1204, + "line_display": "1190-1204", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "gán self._wf — trạng thái chia sẻ trung tâm của cả tab (đọc/ghi khắp nơi); gọi self.canvas.load/relayout/fit_view và self._update_run_btn/_refresh_usage_total (ngoài lát này) -- QUYET DINH: gán self._wf trung tâm — container", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._new_workflow", + "kind": "method", + "line_start": 1205, + "line_end": 1213, + "line_display": "1205-1213", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "gọi self._open_flow (ngoài lát này)", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._selected_wf", + "kind": "method", + "line_start": 1215, + "line_end": 1221, + "line_display": "1215-1221", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "co4e.get_workflow đọc storage — thuần logic sidebar, không thuộc trang Runs", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._load_selected_workflow", + "kind": "method", + "line_start": 1223, + "line_end": 1226, + "line_display": "1223-1226", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._edit_selected_workflow", + "kind": "method", + "line_start": 1228, + "line_end": 1233, + "line_display": "1228-1233", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._duplicate_selected_workflow", + "kind": "method", + "line_start": 1235, + "line_end": 1242, + "line_display": "1235-1242", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "reason": "co4e.duplicate_workflow ghi storage -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._wf_context_menu", + "kind": "method", + "line_start": 1244, + "line_end": 1267, + "line_display": "1244-1267", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "menu chuột phải cho danh sách flow đã lưu, không phải trang Runs -- QUYET DINH: menu chuột phải cho danh sách flow đã lưu (sidebar)", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._rename_workflow", + "kind": "method", + "line_start": 1269, + "line_end": 1285, + "line_display": "1269-1285", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "reason": "co4e.save_workflow ghi storage; đọc/ghi self._wf.name và self.name_edit -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._delete_selected_workflow", + "kind": "method", + "line_start": 1287, + "line_end": 1293, + "line_display": "1287-1293", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "reason": "co4e.delete_workflow ghi storage -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._sync_wf_from_canvas", + "kind": "method", + "line_start": 1295, + "line_end": 1298, + "line_display": "1295-1298", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc self.canvas.nodes()/edges() và self.name_edit, ghi vào self._wf — trạng thái chia sẻ -- QUYET DINH: khớp bảng cũ", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._save", + "kind": "method", + "line_start": 1300, + "line_end": 1305, + "line_display": "1300-1305", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "reason": "co4e.save_workflow ghi storage -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._autosave", + "kind": "method", + "line_start": 1307, + "line_end": 1310, + "line_display": "1307-1310", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "reason": "co4e.save_workflow ghi storage -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._on_name_changed", + "kind": "method", + "line_start": 1312, + "line_end": 1314, + "line_display": "1312-1314", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "gọi self._sync_active_flow_tab_text (ngoài lát này)", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._add_blank_step", + "kind": "method", + "line_start": 1316, + "line_end": 1318, + "line_display": "1316-1318", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._on_node_selected", + "kind": "method", + "line_start": 1321, + "line_end": 1327, + "line_display": "1321-1327", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc self.canvas.nodes(), self.config, self._config_collapsed -- QUYET DINH: đọc canvas selection rồi TOGGLE khung bọc _wrap_config (self._config_collapsed) — thuộc container, không phải nội dung StepConfigPanel. Bảng cũ xếp vào node_property_panel.py — không đúng vai trò khung bọc vs nội dung panel", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._on_config_changed", + "kind": "method", + "line_start": 1329, + "line_end": 1332, + "line_display": "1329-1332", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "cùng lý do với _on_node_selected", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._new_agent", + "kind": "method", + "line_start": 1335, + "line_end": 1336, + "line_display": "1335-1336", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "reason": "khớp bảng cũ, ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._edit_agent", + "kind": "method", + "line_start": 1338, + "line_end": 1346, + "line_display": "1338-1346", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "reason": "khớp bảng cũ, ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._edit_agent_dialog", + "kind": "method", + "line_start": 1348, + "line_end": 1354, + "line_display": "1348-1354", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/agent_list_panel.py", + "reason": "co4e.save_custom_agent ghi storage; mở dialog Qt -- QUYET DINH: khớp bảng cũ, ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._delete_agent", + "kind": "method", + "line_start": 1356, + "line_end": 1363, + "line_display": "1356-1363", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/agent_list_panel.py", + "reason": "co4e.delete_custom_agent ghi storage -- QUYET DINH: khớp bảng cũ, ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._manage_skills", + "kind": "method", + "line_start": 1365, + "line_end": 1369, + "line_display": "1365-1369", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/skills_list_panel.py", + "reason": "mở SkillsDialog (Qt) -- QUYET DINH: khớp bảng cũ, ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._skill_map", + "kind": "method", + "line_start": 1372, + "line_end": 1378, + "line_display": "1372-1378", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "application/workflows/co4e_workflow_service.py", + "reason": "logic thuần, không phải trang Runs — thuộc nhóm run/mode bị loại trừ khỏi run_control_widget theo mô tả đích -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._current_mode", + "kind": "method", + "line_start": 1380, + "line_end": 1381, + "line_display": "1380-1381", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "thuộc mode/run toolbar — loại trừ khỏi run_control_widget theo mô tả đích -- QUYET DINH: đọc mode_combo của toolbar mode/run — mô tả đích loại trừ nhóm mode/run khỏi co4e_run_control_widget.py; bảng cũ xếp vào đó — mâu thuẫn với phạm vi hiện tại", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1384-1385) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._on_mode_changed", + "kind": "method", + "line_start": 1383, + "line_end": 1389, + "line_display": "1383-1389", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "reset self._manual_active/_manual_order/_manual_idx — thuộc mode/run toolbar, loại trừ khỏi run_control_widget theo mô tả đích -- QUYET DINH: cùng nhóm mode/run toolbar — xem lý do ở _current_mode", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1387-1393) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._on_run_clicked", + "kind": "method", + "line_start": 1391, + "line_end": 1400, + "line_display": "1391-1400", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "cắt ngang lát — cần agent gộp đối chiếu (thân method tiếp tục sau dòng 1400). Đây là logic thực thi run — loại trừ khỏi run_control_widget theo mô tả đích; gọi self.manager.stop (trạng thái chia sẻ run manager) -- QUYET DINH: logic bấm nút Run (thực thi) — cùng nhóm bị loại trừ, xem lý do ở _current_mode", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1395-1400) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._start_canvas_run", + "kind": "method", + "line_start": 1403, + "line_end": 1420, + "line_display": "1403-1420", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "logic khởi chạy run trên canvas (không phải bảng Flow Status); đọc/ghi self._wf, self._flows tiles, self._flow_runs, self._run_logs — trạng thái chia sẻ với _on_manager_event và _manual_step", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1407-1424) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._plan_bubble", + "kind": "attribute", + "line_start": 1413, + "line_end": 1413, + "line_display": "1413", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "gán lại None khi bắt đầu run mới; cũng gán ở _manual_run_or_advance (1457) và đọc/ghi trong _append_plan qua log._co4e_plan_bubble — có thể đã khởi tạo lần đầu ở __init__ ngoài phạm vi đọc", + "in_old_table": "co (nhung o dong khac: 1186-1187)", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._run_single", + "kind": "method", + "line_start": 1422, + "line_end": 1427, + "line_display": "1422-1427", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1426-1431) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._run_from", + "kind": "method", + "line_start": 1429, + "line_end": 1433, + "line_display": "1429-1433", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1433-1437) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._downstream", + "kind": "method", + "line_start": 1435, + "line_end": 1446, + "line_display": "1435-1446", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc self.canvas.edges() — chỉ cần canvas object tồn tại, không cần app hiển thị; logic đồ thị thuần", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1439-1450) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._manual_run_or_advance", + "kind": "method", + "line_start": 1449, + "line_end": 1462, + "line_display": "1449-1462", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "khởi tạo self._manual_order/_manual_idx/_manual_active — trạng thái mode thủ công, không liên quan bảng Flow Status", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1453-1466) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._manual_order", + "kind": "attribute", + "line_start": 1458, + "line_end": 1458, + "line_display": "1458", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "trạng thái mode thủ công, dùng bởi _manual_step; có thể đã khởi tạo ở __init__ ngoài phạm vi đọc", + "in_old_table": "co (nhung o dong khac: 253)", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 253) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._manual_idx", + "kind": "attribute", + "line_start": 1459, + "line_end": 1459, + "line_display": "1459", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "trạng thái mode thủ công, dùng bởi _manual_step/_on_manager_event", + "in_old_table": "co (nhung o dong khac: 254)", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 254) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._manual_active", + "kind": "attribute", + "line_start": 1460, + "line_end": 1460, + "line_display": "1460", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "trạng thái mode thủ công, đọc bởi _on_manager_event", + "in_old_table": "co (nhung o dong khac: 252)", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 252) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._manual_step", + "kind": "method", + "line_start": 1464, + "line_end": 1480, + "line_display": "1464-1480", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "ghi self._flow_runs[wf.id] và self._run_logs[run_id] — dict chia sẻ với _start_canvas_run/_on_manager_event", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1468-1484) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._topo_order", + "kind": "method", + "line_start": 1482, + "line_end": 1487, + "line_display": "1482-1487", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc self.canvas.nodes()/edges() — thuần logic sắp xếp topo", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1486-1491) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._on_manager_event", + "kind": "method", + "line_start": 1490, + "line_end": 1546, + "line_display": "1490-1546", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "method gộp nhiều việc không liên quan: routing event theo loại (node_status/node_output/node_diff/node_plan/node_tool/run_done|error), cập nhật canvas, ghi self._outputs_for, dọn self._flow_runs/self._run_logs, gọi popup thông báo — nên tách nhỏ thêm dù chưa vượt 80 dòng. KHÔNG thuộc bảng Flow Status (không đụng runs_table trực tiếp), là logic thực thi run nên ở lại co4e_tab.py theo _doc", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1494-1550) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._notify_run_finished", + "kind": "method", + "line_start": 1548, + "line_end": 1569, + "line_display": "1548-1569", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "tạo QMessageBox không chặn, ghi self._run_popups — popup thông báo chung, không phải phần bảng Flow Status", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1552-1573) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._run_popups", + "kind": "attribute", + "line_start": 1557, + "line_end": 1557, + "line_display": "1557", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "danh sách giữ tham chiếu QMessageBox không-chặn để tránh bị GC — khởi tạo có điều kiện (hasattr) ngay trong _notify_run_finished thay vì __init__", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1560-1561) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._refresh_runs", + "kind": "method", + "line_start": 1571, + "line_end": 1612, + "line_display": "1571-1612", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "dựng lại bảng self.runs_table từ manager — đúng lõi 'Flow Status'; cũng đụng self._sections và self.flow_bar (tab text 'RUNS N') và gọi self._refresh_side_runs() — trạng thái chia sẻ với sidebar/tab strip ngoài phạm vi widget này, cần API cầu nối khi tách", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._stop_selected_run", + "kind": "method", + "line_start": 1614, + "line_end": 1620, + "line_display": "1614-1620", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "nút Stop của bảng Flow Status", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._delete_selected_run", + "kind": "method", + "line_start": 1622, + "line_end": 1635, + "line_display": "1622-1635", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "nút Delete; ghi self._flow_runs.pop/self._run_logs.pop — dict chia sẻ với logic thực thi run ở co4e_tab.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._runs_context_menu", + "kind": "method", + "line_start": 1637, + "line_end": 1651, + "line_display": "1637-1651", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "context menu của runs_table (open run/output/rename/delete); action 'open_run' gọi self._open_run_from_table vốn cần self._open_flow + self.canvas (ở co4e_tab.py) — cần callback cầu nối khi tách", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab.set_project", + "kind": "method", + "line_start": 1654, + "line_end": 1670, + "line_display": "1654-1670", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "đọc/ghi self._project_id, self._project_dir; gọi load_project (đọc đĩa) và manager.set_output_root/set_current_project; gọi self._refresh_ws_folder_btn() thuộc widget Flow Status — cần API cầu nối khi tách ra co4e_run_control_widget.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._project_id", + "kind": "attribute", + "line_start": 1659, + "line_end": 1659, + "line_display": "1659", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "trạng thái workspace hiện tại, dùng bởi manager.set_current_project và các hàm mở thư mục — chia sẻ giữa co4e_tab.py và co4e_run_control_widget.py", + "in_old_table": "co (nhung o dong khac: 249)", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._project_dir", + "kind": "attribute", + "line_start": 1660, + "line_end": 1660, + "line_display": "1660", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "dùng bởi _flow_output_root — ảnh hưởng trực tiếp tới nút 'mở thư mục workspace' của Flow Status", + "in_old_table": "co (nhung o dong khac: 250)", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._flow_output_root", + "kind": "method", + "line_start": 1672, + "line_end": 1682, + "line_display": "1672-1682", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "helper Path dùng chung bởi cả chat (_out_dir) và nút 'mở thư mục workspace' của Flow Status (_open_workspace_folder/_refresh_ws_folder_btn) — widget Flow Status cần được truyền hàm này qua callback/property thay vì tự tính", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._refresh_ws_folder_btn", + "kind": "method", + "line_start": 1684, + "line_end": 1689, + "line_display": "1684-1689", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "cập nhật self.ws_folder_btn (nút mở thư mục workspace) — phụ thuộc self._flow_output_root() ở co4e_tab.py", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._open_workspace_folder", + "kind": "method", + "line_start": 1691, + "line_end": 1698, + "line_display": "1691-1698", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "hành động của nút 'mở thư mục workspace'; mkdir + open_location (spawn process)", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._open_run_output_folder", + "kind": "method", + "line_start": 1700, + "line_end": 1711, + "line_display": "1700-1711", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "mở thư mục output của 1 run cụ thể — dùng trong context menu bảng Flow Status; mkdir + open_location", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._rename_selected_run", + "kind": "method", + "line_start": 1713, + "line_end": 1744, + "line_display": "1713-1744", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "nút Rename của bảng Flow Status; nhưng đồng bộ qua self._flows, self.flow_bar.setTabText, self.name_edit — trạng thái tab/canvas chia sẻ với co4e_tab.py, cần callback cầu nối; co4e.save_workflow ghi đĩa", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._run_selected_in_background", + "kind": "method", + "line_start": 1746, + "line_end": 1756, + "line_display": "1746-1756", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "chạy 1 flow được chọn (self._selected_wf(), không rõ nguồn — có thể là danh sách sidebar chứ không phải runs_table); gọi self._refresh_side_runs() — không khớp mô tả 'CHỈ bảng Flow Status' nên giữ ở co4e_tab.py", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1750-1760) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._wf_by_id", + "kind": "method", + "line_start": 1758, + "line_end": 1766, + "line_display": "1758-1766", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "co4e.get_workflow đọc file workflow đã lưu trên đĩa; helper dùng chung nhiều nơi (rerun, open-from-table)", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1762-1770) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._rerun_run_item", + "kind": "method", + "line_start": 1768, + "line_end": 1779, + "line_display": "1768-1779", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "docstring nói 'double-click a run in the history' nhưng item.data(Qt.UserRole) trực tiếp gợi ý đây là list sidebar 'side runs', KHÔNG phải bảng Flow Status (khác cách _open_run_from_table truy cập runs_table qua item.row()) — cần người quyết đây thuộc trang nào -- QUYET DINH: gọi self.manager.start(...) tức THỰC THI run (network/AI) — cùng nhóm run-execution bị loại trừ khỏi co4e_run_control_widget.py; bảng cũ xếp vào đó. Nghi vấn về nguồn item (sidebar hay bảng) không đổi kết luận vì lý do loại trừ là do HÀNH VI thực thi chứ không phải nơi click", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1772-1783) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab._open_run_from_table", + "kind": "method", + "line_start": 1781, + "line_end": 1800, + "line_display": "1781-1800", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "double-click bảng Flow Status nhưng gọi self._open_flow (chuyển tab) và self.canvas.update_node_status trực tiếp — vượt ra ngoài phạm vi 'chỉ bảng runs_table' nên giữ ở co4e_tab.py, cần callback nếu tách runs_table riêng", + "in_old_table": "co", + "old_table_mismatch": "BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1785-1804) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py." + }, + { + "symbol": "Co4ETab.showEvent", + "kind": "method", + "line_start": 1802, + "line_end": 1805, + "line_display": "1802-1805", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "override Qt lifecycle của chính Co4ETab, gọi self._refresh_runs() — phải ở lại widget chính", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._out_dir", + "kind": "method", + "line_start": 1807, + "line_end": 1813, + "line_display": "1807-1813", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "mkdir; dùng cho chat/flow deliverables, không liên quan bảng Flow Status", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._chat_send", + "kind": "method", + "line_start": 1816, + "line_end": 1842, + "line_display": "1816-1842", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._apply_co4e_routing", + "kind": "method", + "line_start": 1844, + "line_end": 1879, + "line_display": "1844-1879", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "ghi self._co4e_routed_provider; nhánh 'manual' dựng dialog confirm_switch(self,...) nên cần widget sống", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._co4e_routed_provider", + "kind": "attribute", + "line_start": 1849, + "line_end": 1849, + "line_display": "1849", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "dùng bởi _run_chat_turn để chọn provider — reset mỗi lần _apply_co4e_routing chạy", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._extract_agent_directive", + "kind": "method", + "line_start": 1881, + "line_end": 1887, + "line_display": "1881-1887", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "thuần regex, test được không cần Qt", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._resolve_agent", + "kind": "method", + "line_start": 1889, + "line_end": 1897, + "line_display": "1889-1897", + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "co4e.list_custom_agents() đọc dữ liệu agent tuỳ biến đã lưu", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._run_chat_turn", + "kind": "method", + "line_start": 1899, + "line_end": 1970, + "line_display": "1899-1970", + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "ui/co4e_tab.py", + "reason": "method dài, gộp: dựng prompt, chạy AgentWorker nền gọi provider AI (network), stream sự kiện vào bubble Qt, cập nhật usage — nên tách nhỏ thêm dù chỉ 72 dòng vì nhiều trách nhiệm khác nhau (build prompt / worker job / event routing / usage). Không liên quan bảng Flow Status", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._chat_worker", + "kind": "attribute", + "line_start": 1953, + "line_end": 1953, + "line_display": "1953", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "vị trí xuất hiện đầu tiên theo văn bản là trong hàm lồng 'done'; gán thật sự lúc chạy là dòng 1969 (w = AgentWorker...); có thể đã khởi tạo None ở __init__ ngoài phạm vi đọc", + "in_old_table": "co (nhung o dong khac: 236)", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._append_chat", + "kind": "method", + "line_start": 1972, + "line_end": 1987, + "line_display": "1972-1987", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._fmt_usage", + "kind": "method", + "line_start": 1990, + "line_end": 1997, + "line_display": "1990-1997", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "thuần formatting, không cần Qt", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._apply_usage", + "kind": "method", + "line_start": 1999, + "line_end": 2016, + "line_display": "1999-2016", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "ghi self._flow_usage[wf_id] — tổng usage theo flow, chia sẻ với _refresh_usage_total", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._refresh_usage_total", + "kind": "method", + "line_start": 2018, + "line_end": 2033, + "line_display": "2018-2033", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "đọc self._flow_usage và self._wf — trạng thái chia sẻ với _apply_usage", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._append_diff", + "kind": "method", + "line_start": 2035, + "line_end": 2039, + "line_display": "2035-2039", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._append_plan", + "kind": "method", + "line_start": 2041, + "line_end": 2052, + "line_display": "2041-2052", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "ghi log._co4e_plan_bubble — thuộc tính gắn động lên ChatView, chia sẻ với _run_chat_turn", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "Co4ETab._retranslate", + "kind": "method", + "line_start": 2055, + "line_end": 2075, + "line_display": "2055-2075", + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "gộp retranslate cho CẢ widget chung (wf_new_btn, self._sections) LẪN các nút riêng của Flow Status (runs_back_btn, run_stop_btn, run_rename_btn, run_del_btn, run_clear_btn, runs_table headers, ws_folder_btn) — khi tách co4e_run_control_widget.py cần chia method này làm hai, phần Flow Status nên có retranslate riêng gọi từ đây", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_html_escape", + "kind": "function", + "line_start": 2078, + "line_end": 2079, + "line_display": "2078-2079", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "ui/co4e_tab.py", + "reason": "hàm module-level thuần string escape; không thấy nơi gọi trong phạm vi 1401-2084 nên chưa rõ nó phục vụ phần nào — có thể dùng ở phần chat render ngoài phạm vi đọc -- QUYET DINH: escape string thuần cho phần render CHAT — lane co4e_chat_view.py (chưa tồn tại); bảng cũ đã xếp sẵn vào đó, ngoài phạm vi run-control nên giữ nguyên vị trí vật lý hiện tại", + "in_old_table": "co", + "old_table_mismatch": "-" + }, + { + "symbol": "_qcolor", + "kind": "function", + "line_start": 2082, + "line_end": 2084, + "line_display": "2082-2084", + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "reason": "QColor là kiểu giá trị (như QPointF/QRectF), không cần QApplication sống; chỉ thấy dùng trong _refresh_runs (tô màu cột status của bảng Flow Status) trong phạm vi đọc", + "in_old_table": "co", + "old_table_mismatch": "-" + } + ] +} \ No newline at end of file diff --git a/docs/architecture/co4e-split-map-run-control.md b/docs/architecture/co4e-split-map-run-control.md new file mode 100644 index 0000000..7a6af56 --- /dev/null +++ b/docs/architecture/co4e-split-map-run-control.md @@ -0,0 +1,238 @@ +# Bản đồ tách file — Run Control (trang Runs / Flow Status) + +Gộp 215 symbol thô từ 3 agent quét song song trên `ui/co4e_tab.py`, còn lại **214 dòng** sau khi gộp 1 trùng lặp thật (`Co4ETab._reload_sidebar` dòng 685, xem bên dưới). + +- File đích của lane run-control: `presentation/co4e/co4e_run_control_widget.py` — **18 symbol**. +- Phần còn lại của container: `ui/co4e_tab.py` — **173 symbol**. +- Thuộc lane/file khác (ngoài phạm vi run-control, chỉ ghi lại để tham khảo): **23 symbol** (application/workflows/co4e_workflow_service.py, presentation/co4e/agent_list_panel.py, presentation/co4e/skills_list_panel.py, presentation/co4e/co4e_canvas_widget.py). +- Note bắt đầu bằng `khac tai lieu:` tìm thấy trong dữ liệu thô: **0**. + +## Phát hiện quan trọng nhất từ việc đối chiếu với bảng cũ + +1. **Đường dẫn `co4e_tab.py` trong bảng cũ sai.** Bảng cũ (`docs/architecture/co4e-split-map.json`) dùng `target_file="presentation/co4e/co4e_tab.py"` cho phần thân lớp `Co4ETab` còn lại, nhưng file đó ở repo hiện tại chỉ là factory `build_co4e_tab()` dài 53 dòng (bọc nguyên `Co4ETab` cũ 1:1, xem docstring của nó) — KHÔNG phải nơi lớp `Co4ETab` thật sự sống. Lớp đó vẫn đang ở `ui/co4e_tab.py`. Bảng này đã tự quy đổi mọi so sánh trước khi kết luận lệch. +2. **Phạm vi `co4e_run_control_widget.py` đã bị thu hẹp so với bảng cũ.** Bảng cũ coi 'run control' là toàn bộ chuỗi: bảng Runs + logic thực thi run (start/stop/manual-mode/mode toolbar/event routing/popup) + sidebar quick-list các run gần đây. Lần quét 3-agent hiện tại (theo mô tả đích lặp lại trong nhiều ghi chú riêng lẻ) chỉ còn coi `co4e_run_control_widget.py` là **trang Runs/Flow Status**: bảng `runs_table` + các nút hành động trên từng dòng (stop/rename/delete/clear/mở thư mục) + nút quay lại + tiêu đề. Logic thực thi run, toolbar mode/run, và sidebar quick-list quay lại ở lại `ui/co4e_tab.py`. Đây là khác biệt lớn nhất — ảnh hưởng tới 34 dòng bên dưới (đánh dấu ở cột cuối). +3. **Bảng cũ không nhất quán giữa alias của Agent panel và Skills panel.** `ag_new_btn`/`agent_list`/`ag_edit_btn`/`ag_del_btn` (alias trỏ vào `AgentListPanel` đã tách) được bảng cũ xếp vào `presentation/co4e/agent_list_panel.py`, nhưng `sk_manage_btn`/`skill_list` (alias trỏ vào `SkillsListPanel`, cùng bản chất) lại bị xếp vào `co4e_tab.py`. Bảng này chọn xử lý đồng nhất — coi cả hai cặp alias đều thuộc file panel tương ứng. +4. **Bảng cũ bỏ sót 2 symbol:** `Co4ETab.status_message` (Signal cấp lớp) và `Co4ETab._agent_panel` (instance `AgentListPanel` do container giữ) không có dòng nào trong bảng cũ dù nằm trong phạm vi đã quét. + +## Bảng đầy đủ (sắp theo số dòng) + +| symbol | dòng | file đích | lý do | có trong bảng cũ chưa | chỗ nào thấy bảng cũ sai | +|---|---|---|---|---|---| +| `_PLAN_GLYPH` | 46-47 | `ui/co4e_tab.py` | module-level dict constant, không phải self. -- QUYET DINH: glyph dùng bởi _fmt_plan cho bong bóng 'plan' trong CHAT, không phải bảng Runs; bảng cũ xếp nhầm vào co4e_run_control_widget.py | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 45-46) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `_fmt_plan` | 50-59 | `ui/co4e_tab.py` | helper format cho _append_plan (chat), không đụng runs_table; bảng cũ xếp nhầm vào co4e_run_control_widget.py | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 49-58) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `_skill_names` | 62-66 | `ui/co4e_tab.py` | gọi skills_mod.list_skills()/builtin_skills() — có thể chạm đĩa qua core.skills -- QUYET DINH: helper autocomplete cho _ChatInput — thuộc lane co4e_chat_view.py (chưa tồn tại), ngoài phạm vi lane run-control nên giữ nguyên vị trí hiện tại | co | - | +| `_agent_names` | 69-72 | `ui/co4e_tab.py` | gọi co4e.list_custom_agents() — chạm đĩa qua core.co4e -- QUYET DINH: cùng lý do với _skill_names — autocomplete /agent trong chat | co | - | +| `_EqualTabBar` | 75-95 | `ui/co4e_tab.py` | helper QTabBar cho sidebar icon-tabs — không liên quan Flow Status -- QUYET DINH: QTabBar tiện ích cho sidebar icon-tabs, không liên quan Runs | co | - | +| `_EqualTabBar._GAP` | 81 | `ui/co4e_tab.py` | hằng số nội bộ của _EqualTabBar | co | - | +| `_EqualTabBar.tabSizeHint` | 83-91 | `ui/co4e_tab.py` | - | co | - | +| `_EqualTabBar.resizeEvent` | 93-95 | `ui/co4e_tab.py` | - | co | - | +| `_PaletteList` | 98-120 | `ui/co4e_tab.py` | list kéo-thả vào canvas cho Workflows/Agents/Skills palette — không phải Runs -- QUYET DINH: list kéo-thả cho palette Workflows/Agents/Skills, không phải Runs | co | - | +| `_PaletteList.__init__` | 103-107 | `ui/co4e_tab.py` | - | co | - | +| `_PaletteList._payload_role` | 105 | `ui/co4e_tab.py` | - | co | - | +| `_PaletteList.startDrag` | 109-120 | `ui/co4e_tab.py` | - | co | - | +| `_directive_token` | 123-135 | `ui/co4e_tab.py` | logic thuần regex cho autocomplete /skill /agent trong chat — test được không cần Qt -- QUYET DINH: regex thuần cho autocomplete /skill /agent — lane co4e_chat_view.py (chưa tồn tại), giữ nguyên | co | - | +| `_ChatInput` | 138-227 | `ui/co4e_tab.py` | ô chat với popup autocomplete — không liên quan Flow Status -- QUYET DINH: ô nhập chat với popup autocomplete — lane co4e_chat_view.py (chưa tồn tại), giữ nguyên | co | - | +| `_ChatInput.submit` | 142 | `ui/co4e_tab.py` | Signal khai báo ở cấp lớp -- QUYET DINH: Signal của _ChatInput — đi cùng class | chua | - | +| `_ChatInput.__init__` | 144-152 | `ui/co4e_tab.py` | - | co | - | +| `_ChatInput._popup` | 146 | `ui/co4e_tab.py` | - | co | - | +| `_ChatInput._maybe_popup` | 154-179 | `ui/co4e_tab.py` | gọi _skill_names/_agent_names (chạm đĩa gián tiếp) và định vị popup bằng tọa độ màn hình | co | - | +| `_ChatInput._add_row` | 181-185 | `ui/co4e_tab.py` | - | co | - | +| `_ChatInput._accept` | 187-200 | `ui/co4e_tab.py` | - | co | - | +| `_ChatInput.focusOutEvent` | 202-205 | `ui/co4e_tab.py` | - | co | - | +| `_ChatInput.keyPressEvent` | 207-227 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab` | 230-700 | `ui/co4e_tab.py` | cắt ngang lát — cần agent gộp đối chiếu (thân lớp trải dài quá dòng 700, đây chỉ là phần đầu) -- QUYET DINH: lớp container chính — phần còn lại sau khi các widget con (canvas/node-property/agent/skills/run-control/chat) đã tách | co | - | +| `Co4ETab.status_message` | 231 | `ui/co4e_tab.py` | Signal khai báo ở cấp lớp -- QUYET DINH: Signal cấp lớp của chính Co4ETab; KHÔNG có trong bảng cũ (thiếu sót ở đó) | chua | BANG CU BO SOT: khong co dong nao cho symbol nay du no ro rang ton tai trong pham vi da quet (367 symbol tho cua bang cu) -- co the do agent quet truoc bo lot. | +| `Co4ETab.__init__` | 233-305 | `ui/co4e_tab.py` | gộp nhiều việc: khởi state run-per-flow, dựng splitter 3 cột, wiring StepConfigPanel, narrow-guard, rồi mở flow đầu tiên — biên độ rủi ro cao khi tách vì đụng gần hết thuộc tính self chia sẻ toàn tab -- QUYET DINH: constructor container — sẽ đổi để dựng Co4ERunControlWidget thay vì tự vẽ bảng Runs | co | - | +| `Co4ETab.ctx` | 235 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._wf` | 236 | `ui/co4e_tab.py` | trạng thái chia sẻ toàn tab — workflow đang hiển thị trên canvas, đọc/ghi bởi rất nhiều method (flow tabs, run, sidebar, config) -- QUYET DINH: trạng thái trung tâm toàn tab, container giữ | co | - | +| `Co4ETab._chat_worker` | 237 | `ui/co4e_tab.py` | AgentWorker của chat — lane co4e_chat_view.py chưa tồn tại, giữ nguyên | co | - | +| `Co4ETab.manager` | 239 | `ui/co4e_tab.py` | Co4ERunManager dùng chung giữa canvas (mirror trạng thái node) và trang Runs (self.runs_table — định nghĩa ngoài dòng 700, có thể ở co4e_run_control_widget) — điểm nối quan trọng giữa hai lát -- QUYET DINH: Co4ERunManager dùng chung giữa canvas, chat VÀ bảng Runs — quyết định: container SỞ HỮU, co4e_run_control_widget.py nhận qua constructor/callback (dependency injection) thay vì tự tạo. Bảng cũ xếp thẳng vào co4e_run_control_widget.py dù chính ghi chú của nó gọi đây là 'điểm nối' — coi là quá vội | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 238) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._flow_runs` | 244 | `ui/co4e_tab.py` | trạng thái chia sẻ wf_id -> active run id, đọc/ghi bởi _open_flow, _close_flow_tab, _cur_run_id, _reflect_active_run -- QUYET DINH: dict wf_id->run id, ghi bởi _open_flow/_close_flow_tab/_start_canvas_run (đều ở co4e_tab.py) — container giữ, run-control đọc/ghi qua callback. Bảng cũ xếp vào co4e_run_control_widget.py — không khớp nơi ghi chính | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 243) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._run_logs` | 245 | `ui/co4e_tab.py` | map run_id->ChatView (thuộc lane chat), ghi bởi _manual_step/_start_canvas_run ở co4e_tab.py — container giữ | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 244) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._flow_outputs` | 246 | `application/workflows/co4e_workflow_service.py` | đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi lane run-control. Hiện tại vật lý vẫn còn ở ui/co4e_tab.py dòng 246 chờ lane đó dọn | co | - | +| `Co4ETab._flow_usage` | 249 | `ui/co4e_tab.py` | usage token/cost hiển thị ở header CHAT (Messages), không phải bảng Runs — bảng cũ xếp nhầm vào co4e_run_control_widget.py | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 248) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._project_id` | 250 | `ui/co4e_tab.py` | workspace hiện chọn — dùng chung bởi chat (_out_dir) và nút mở-thư-mục của Runs; container giữ, expose qua callback | co | - | +| `Co4ETab._project_dir` | 251 | `ui/co4e_tab.py` | cùng lý do với _project_id | co | - | +| `Co4ETab._manual_active` | 253 | `ui/co4e_tab.py` | trạng thái MODE THỦ CÔNG — thuộc nhóm run-execution, mô tả đích lane này loại trừ mode/run toolbar khỏi co4e_run_control_widget.py. Bảng cũ xếp vào co4e_run_control_widget.py — mâu thuẫn trực tiếp với phạm vi hiện tại | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 252) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._manual_order` | 254 | `ui/co4e_tab.py` | cùng nhóm với _manual_active — xem lý do ở đó | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 253) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._manual_idx` | 255 | `ui/co4e_tab.py` | cùng nhóm với _manual_active — xem lý do ở đó | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 254) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._flows` | 258 | `ui/co4e_tab.py` | trạng thái chia sẻ danh sách flow đang mở (browser-style tabs) — đọc/ghi bởi toàn bộ nhóm _open_flow/_close_flow_tab/_on_flow_tab_changed -- QUYET DINH: danh sách flow-tab kiểu browser, không phải Runs | co | - | +| `Co4ETab._active_flow_idx` | 259 | `ui/co4e_tab.py` | cùng nhóm trạng thái chia sẻ với _flows -- QUYET DINH: cùng nhóm với _flows | co | - | +| `Co4ETab._split` | 262 | `ui/co4e_tab.py` | splitter 3 cột của cả tab | co | - | +| `Co4ETab.config` | 269 | `ui/co4e_tab.py` | container giữ tham chiếu StepConfigPanel (đã tách ở node_property_panel.py, file cấm sửa của lane khác) — cùng khuôn mẫu với _agent_panel/_skills_panel: instance do container tạo/giữ, nội dung panel ở file riêng. Bảng cũ xếp thẳng dòng này vào node_property_panel.py — không nhất quán với cách nó xử lý _agent_panel | co | - | +| `Co4ETab._config_collapsed` | 275 | `ui/co4e_tab.py` | trạng thái thu/phóng của KHUNG bọc quanh panel (co4e_tab.py), không phải nội dung panel | co | - | +| `Co4ETab._config_expanded_w` | 276 | `ui/co4e_tab.py` | cùng lý do với _config_collapsed | co | - | +| `Co4ETab._narrow_guard` | 281 | `ui/co4e_tab.py` | guard bố cục hẹp của cả tab | co | - | +| `Co4ETab._open_flow` | 308-339 | `ui/co4e_tab.py` | đọc/ghi self._flows, self._active_flow_idx, self.flow_bar — quản lý flow tab kiểu browser, không phải trang Runs -- QUYET DINH: quản lý flow-tab kiểu browser | co | - | +| `Co4ETab._close_other_flows` | 341-356 | `ui/co4e_tab.py` | đọc/ghi self._flows, self._active_flow_idx, self.flow_bar | co | - | +| `Co4ETab._show_runs` | 358-368 | `ui/co4e_tab.py` | chuyển center_stack giữa flow editor và trang Runs; gọi bởi self.runs_btn (định nghĩa ngoài dòng 700, thuộc toolbar) và runs_more_btn (sidebar) — không thao tác trực tiếp runs_table nên không chắc thuộc co4e_run_control_widget hay ở lại co4e_tab.py làm điều phối trang -- QUYET DINH: điều phối chuyển trang center_stack giữa flow editor và trang Runs — container sở hữu center_stack; sẽ gọi API show()/hide() hoặc setCurrentWidget trên Co4ERunControlWidget thay vì tự vẽ | co | - | +| `Co4ETab._on_flow_tab_changed` | 370-386 | `ui/co4e_tab.py` | đọc/ghi self._active_flow_idx, self.center_stack (self.center_stack định nghĩa ngoài dòng 700) | co | - | +| `Co4ETab._sync_runs_toggle` | 388-395 | `ui/co4e_tab.py` | dùng getattr(self, 'runs_btn', None) vì runs_btn (toolbar, ngoài dòng 700) có thể chưa tồn tại — đồng bộ trạng thái toggle của trang Runs -- QUYET DINH: đồng bộ nút toggle runs_btn ở toolbar (thuộc co4e_tab.py, KHÔNG phải trang Runs) | co | - | +| `Co4ETab._add_tab_close_button` | 397-407 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._close_flow_tab_button` | 409-413 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._close_flow_tab` | 415-443 | `ui/co4e_tab.py` | đọc/ghi self._flow_runs, self._run_logs, self._flows, self._active_flow_idx, self.run_btn (định nghĩa ngoài dòng 700) — nhiều trạng thái chia sẻ chạm cùng lúc | co | - | +| `Co4ETab._sync_active_flow_tab_text` | 445-448 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._reflect_active_run` | 450-458 | `ui/co4e_tab.py` | đọc self.manager.all_runs(), ghi self._flow_runs, gọi self.canvas.update_node_status — cầu nối giữa run manager (chia sẻ với trang Runs) và canvas -- QUYET DINH: cầu nối manager -> canvas (update_node_status trên canvas thuộc co4e_tab.py) — đi cùng nhóm thực thi run, không phải bảng Runs | co | - | +| `Co4ETab._cur_run_id` | 461-474 | `ui/co4e_tab.py` | logic thuần: đọc self._wf, self._flow_runs, self.manager.get() — test được không cần Qt -- QUYET DINH: tra cứu run đang chạy CỦA FLOW HIỆN TẠI, dùng bởi _reflect_active_run (canvas mirror, co4e_tab.py) — không đụng runs_table. Bảng cũ xếp vào co4e_run_control_widget.py — không khớp nơi dùng chính | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 460-473) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._outputs_for` | 476-479 | `application/workflows/co4e_workflow_service.py` | logic thuần dict, test được không cần Qt -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ) cho cặp _flow_outputs/_outputs_for; ngoài phạm vi lane run-control | co | - | +| `Co4ETab._update_run_btn` | 481-483 | `ui/co4e_tab.py` | thuộc nhóm run toolbar (self.run_btn) — theo mô tả target, co4e_run_control_widget KHÔNG bao gồm mode/run toolbar nên method này không nên vào đó -- QUYET DINH: nút Run của toolbar mode/run — mô tả đích loại trừ nhóm này khỏi co4e_run_control_widget.py; bảng cũ xếp vào đó — mâu thuẫn với phạm vi hiện tại | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 480-482) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._build_sidebar` | 486-599 | `ui/co4e_tab.py` | method dài >80 dòng, gộp nhiều việc không liên quan nhau: dựng section Workflows (list + edit/dup/del/run-bg), section Agents (AgentListPanel wiring), section Skills (SkillsListPanel wiring), section Runs sidebar quick-list, và lắp splitter dọc side_split — nên tách nhỏ thêm theo từng section -- QUYET DINH: dựng toàn bộ sidebar (Workflows/Agents/Skills/Runs quick-list) | co | - | +| `Co4ETab._sections` | 494 | `ui/co4e_tab.py` | dict trạng thái chia sẻ cho các section sidebar (fold/unfold) — đọc/ghi bởi _section, _fold_section, _sync_section_arrow | co | - | +| `Co4ETab.sidebar` | 495 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.side_split` | 499 | `ui/co4e_tab.py` | - | co | - | +| `_build_sidebar._Col` | 504-512 | `ui/co4e_tab.py` | class cục bộ (locals) bên trong _build_sidebar — adapter cho side_split, không phải class module-level -- QUYET DINH: class cục bộ, adapter cho side_split | co | - | +| `_Col.__init__` | 507-508 | `ui/co4e_tab.py` | - | co | - | +| `_Col.addWidget` | 510-512 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_new_btn` | 517 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_list` | 528 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_edit_btn` | 535 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_dup_btn` | 536 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_del_btn` | 537 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.wf_runbg_btn` | 544 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._agent_panel` | 556 | `ui/co4e_tab.py` | AgentListPanel — panel đã tách sẵn ở presentation/co4e/agent_list_panel.py (ngoài phạm vi lát này) -- QUYET DINH: container giữ instance AgentListPanel (đã tách sẵn) — KHÔNG có trong bảng cũ (thiếu sót ở đó, ag_new_btn/agent_list/ag_edit_btn/ag_del_btn có dòng nhưng _agent_panel thì không) | chua | BANG CU BO SOT: khong co dong nao cho symbol nay du no ro rang ton tai trong pham vi da quet (367 symbol tho cua bang cu) -- co the do agent quet truoc bo lot. | +| `Co4ETab.ag_new_btn` | 557 | `presentation/co4e/agent_list_panel.py` | alias trỏ tới self._agent_panel.new_btn — widget thật nằm ở agent_list_panel.py | co | - | +| `Co4ETab.agent_list` | 559 | `presentation/co4e/agent_list_panel.py` | alias trỏ tới self._agent_panel.list_widget | co | - | +| `Co4ETab.ag_edit_btn` | 560 | `presentation/co4e/agent_list_panel.py` | alias trỏ tới self._agent_panel.edit_btn | co | - | +| `Co4ETab.ag_del_btn` | 562 | `presentation/co4e/agent_list_panel.py` | alias trỏ tới self._agent_panel.del_btn | co | - | +| `Co4ETab._skills_panel` | 571 | `ui/co4e_tab.py` | SkillsListPanel — panel đã tách sẵn ở presentation/co4e/skills_list_panel.py (ngoài phạm vi lát này) -- QUYET DINH: container giữ instance SkillsListPanel (đã tách sẵn) — khớp bảng cũ | co | - | +| `Co4ETab.sk_manage_btn` | 572 | `presentation/co4e/skills_list_panel.py` | alias trỏ tới self._skills_panel.manage_btn — cùng bản chất với ag_new_btn ở trên. Bảng cũ xếp dòng này (và skill_list) vào co4e_tab.py trong khi ag_* tương ứng lại xếp vào agent_list_panel.py — KHÔNG NHẤT QUÁN giữa 2 cặp alias giống hệt nhau trong cùng bảng cũ; ở đây chọn xử lý đồng nhất với ag_* | co | BANG CU KHONG NHAT QUAN: xep Co4ETab.sk_manage_btn vao ui/co4e_tab.py trong khi alias tuong duong ben Agent (ag_new_btn/agent_list/...) lai xep vao agent_list_panel.py; o day chon dong nhat -> presentation/co4e/skills_list_panel.py. | +| `Co4ETab.skill_list` | 574 | `presentation/co4e/skills_list_panel.py` | alias trỏ tới self._skills_panel.list_widget — xem ghi chú ở sk_manage_btn | co | BANG CU KHONG NHAT QUAN: xep Co4ETab.skill_list vao ui/co4e_tab.py trong khi alias tuong duong ben Agent (ag_new_btn/agent_list/...) lai xep vao agent_list_panel.py; o day chon dong nhat -> presentation/co4e/skills_list_panel.py. | +| `Co4ETab.runs_more_btn` | 582 | `ui/co4e_tab.py` | nút icon trong sidebar mở trang Runs (gọi self._show_runs(True)) — điểm vào trang Flow Status nhưng không phải một phần của bảng runs_table -- QUYET DINH: nút icon nằm trong sidebar (dựng bởi _build_sidebar, ở co4e_tab.py) mở trang Runs — không phải một phần của runs_table. Bảng cũ xếp vào co4e_run_control_widget.py vì cùng 'chủ đề Runs', nhưng nơi nó được XÂY lại là sidebar | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 586) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab.runs_side_list` | 590 | `ui/co4e_tab.py` | danh sách rút gọn các run trong sidebar — KHÁC với self.runs_table của trang Flow Status (định nghĩa ngoài dòng 700, có thể ở co4e_run_control_widget); dễ nhầm là cùng một bảng nên tách agent gộp cần đối chiếu -- QUYET DINH: danh sách rút gọn run trong sidebar, KHÁC self.runs_table của trang Flow Status — dựng trong _build_sidebar (co4e_tab.py). Mô tả đích của _build_runs_page nói rõ co4e_run_control_widget.py = bảng runs_table + nút hành động, không bao gồm sidebar quick-list | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 594) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._SIDE_RUNS` | 601 | `ui/co4e_tab.py` | hằng số class — số run hiển thị trong sidebar quick-list, không phải trang runs_table chính -- QUYET DINH: hằng số cho sidebar quick-list — cùng nhóm runs_side_list | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 605) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._refresh_side_runs` | 603-615 | `ui/co4e_tab.py` | đọc self.manager.runs(), ghi self.runs_side_list — sidebar quick-list, khác trang Flow Status runs_table -- QUYET DINH: cùng nhóm runs_side_list | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 607-619) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._on_side_run_clicked` | 617-625 | `ui/co4e_tab.py` | gọi self._show_runs(True) rồi đọc self.runs_table (định nghĩa ngoài dòng 1-700, khả năng ở co4e_run_control_widget) để chọn dòng tương ứng — điểm nối giữa sidebar quick-list và trang Runs, cần agent gộp đối chiếu với file định nghĩa runs_table -- QUYET DINH: handler click của sidebar quick-list; có đọc self.runs_table nên cần API cầu nối sang co4e_run_control_widget.py khi tách, nhưng bản thân handler thuộc sidebar nên ở co4e_tab.py | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 621-629) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._section` | 627-659 | `ui/co4e_tab.py` | helper dựng UI section chung cho sidebar, ghi vào self._sections[key] | co | - | +| `Co4ETab._fold_section` | 661-673 | `ui/co4e_tab.py` | đọc self._sections | co | - | +| `Co4ETab._sync_section_arrow` | 675-678 | `ui/co4e_tab.py` | đọc self._sections | co | - | +| `Co4ETab._icon_btn` | 679-683 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._reload_sidebar` | 685-718 | `ui/co4e_tab.py` | [GOP 2 luot quet trung ky hieu dong 685] cắt ngang lát — cần agent gộp đối chiếu (thân method tiếp tục ngoài dòng 700); gọi co4e.list_workflows() nên chạm đĩa // cắt ngang lát — cần agent gộp đối chiếu (bắt đầu ở dòng 685, trước khoảng được giao 701-1400; phần thấy được chỉ là vòng lặp nạp custom agents + skills vào agent_list/skill_list) -- QUYET DINH: [GỘP 2 lượt quét trùng ký hiệu ở dòng 685] một agent đọc thân đến 700 (cắt ngang lát), agent kia đọc tới 718 (vòng lặp nạp agent/skill) — gộp thành 1 dòng 685-718; nạp lại toàn bộ sidebar, không phải trang Runs | co | - | +| `Co4ETab._palette_item` | 720-724 | `ui/co4e_tab.py` | staticmethod tạo QListWidgetItem cho palette — không liên quan trang Runs -- QUYET DINH: factory QListWidgetItem cho palette — sidebar, không phải Runs | co | - | +| `Co4ETab._build_center` | 727-867 | `ui/co4e_tab.py` | method dài >80 dòng, gộp nhiều việc không liên quan: dựng flow tab bar (QTabBar ẩn), gọi _build_runs_page() để nhét vào center_stack, dựng toolbar flow (name/add/save/mode/run/runs toggle), dựng canvas + overlay + splitter dọc với chat. Nên tách nhỏ. Gán self.center_stack — trạng thái chia sẻ dùng ở nhiều nơi (switch giữa trang Runs và flow editor, cả _show_runs ngoài lát này). -- QUYET DINH: dựng flow tab bar + toolbar + canvas/chat splitter; GỌI self._build_runs_page() để nhét vào center_stack — khi tách, chỗ gọi này đổi thành khởi tạo Co4ERunControlWidget(...) rồi add vào center_stack | co | - | +| `Co4ETab.flow_bar` | 734 | `ui/co4e_tab.py` | QTabBar ẩn dùng làm index ánh xạ flow<->canvas, không phải trang Runs | co | - | +| `Co4ETab.flow_add_btn` | 760 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.flow_scroll` | 777 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab.center_stack` | 801 | `ui/co4e_tab.py` | trạng thái chia sẻ giữa trang Runs (stack 0) và flow editor (stack 1) — dùng bởi _show_runs (ngoài lát này) để chuyển trang -- QUYET DINH: container sở hữu QStackedWidget chứa [trang Runs, flow editor]; trang Runs (index 0) sẽ LÀ instance Co4ERunControlWidget được add vào đây | co | - | +| `Co4ETab._build_runs_page` | 869-928 | `presentation/co4e/co4e_run_control_widget.py` | khớp đúng mô tả đích: dựng bảng runs_table + nút back/stop/rename/delete/clear/mở-thư-mục-workspace | co | - | +| `Co4ETab.runs_back_btn` | 878 | `presentation/co4e/co4e_run_control_widget.py` | - | co | - | +| `Co4ETab.runs_title` | 883 | `presentation/co4e/co4e_run_control_widget.py` | - | co | - | +| `Co4ETab.ws_folder_btn` | 888 | `presentation/co4e/co4e_run_control_widget.py` | nút mở thư mục workspace — click gọi self._open_workspace_folder (định nghĩa ngoài lát này, có khả năng touches_disk_or_network=true) | co | - | +| `Co4ETab.run_stop_btn` | 896 | `presentation/co4e/co4e_run_control_widget.py` | - | co | - | +| `Co4ETab.run_rename_btn` | 901 | `presentation/co4e/co4e_run_control_widget.py` | - | co | - | +| `Co4ETab.run_del_btn` | 905 | `presentation/co4e/co4e_run_control_widget.py` | - | co | - | +| `Co4ETab.run_clear_btn` | 909 | `presentation/co4e/co4e_run_control_widget.py` | click gọi self.manager.clear_finished() — self.manager là trạng thái chia sẻ (run manager) không định nghĩa trong lát này | co | - | +| `Co4ETab.runs_table` | 917 | `presentation/co4e/co4e_run_control_widget.py` | bảng chính của trang Runs; double-click gọi self._open_run_from_table, context menu gọi self._runs_context_menu (cả hai định nghĩa ngoài lát này) | co | - | +| `Co4ETab._wrap_config` | 930-960 | `ui/co4e_tab.py` | wrap panel cấu hình step, không thuộc trang Runs -- QUYET DINH: khung bọc/thu-phóng quanh StepConfigPanel — thuộc bố cục của co4e_tab.py, không phải nội dung panel. Bảng cũ xếp cả cụm này vào node_property_panel.py (file cấm sửa của lane khác) — không đúng vai trò 'khung bọc' vs 'nội dung panel' | co | - | +| `Co4ETab.config_toggle_btn` | 942 | `ui/co4e_tab.py` | thuộc khung bọc _wrap_config | co | - | +| `Co4ETab.config_title` | 947 | `ui/co4e_tab.py` | thuộc khung bọc _wrap_config | co | - | +| `Co4ETab._cfg_vlayout` | 953 | `ui/co4e_tab.py` | thuộc khung bọc _wrap_config | co | - | +| `Co4ETab._cfg_top_spacer` | 957 | `ui/co4e_tab.py` | thuộc khung bọc _wrap_config | co | - | +| `Co4ETab._cfg_bot_spacer` | 958 | `ui/co4e_tab.py` | thuộc khung bọc _wrap_config | co | - | +| `Co4ETab.config_container` | 959 | `ui/co4e_tab.py` | thuộc khung bọc _wrap_config | co | - | +| `Co4ETab._NARROW` | 967 | `ui/co4e_tab.py` | hằng số class-level, không liên quan trang Runs -- QUYET DINH: hằng số bố cục hẹp của cả tab | co | - | +| `Co4ETab.showEvent` | 969-971 | `ui/co4e_tab.py` | Qt override, gắn narrow_guard -- QUYET DINH: [ANOMALY — 2 định nghĩa showEvent cùng tên trong 1 class, bảng cũ đã ghi nhận 'kept_separate_anomaly_symbols'] bản đầu (969-971) chỉ gắn narrow_guard, bị bản thứ 2 (1802) ghi đè lúc runtime; giữ TÁCH RIÊNG như bảng cũ | co | - | +| `Co4ETab._apply_narrow_layout` | 973-983 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._toggle_config` | 985-1028 | `ui/co4e_tab.py` | không thuộc trang Runs; đọc/ghi self._split (splitter 3 cột chia sẻ với _build_center/_wrap_config) | co | - | +| `Co4ETab._refresh_min_width` | 1030-1035 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._build_canvas_overlay` | 1037-1058 | `presentation/co4e/co4e_canvas_widget.py` | overlay zoom cho canvas — không thuộc trang Runs -- QUYET DINH: overlay zoom/fit gắn LÊN canvas qua self.canvas.add_overlay(); chấp nhận quyết định của bảng cũ — thuộc lane canvas, ngoài phạm vi run-control. Hiện tại canvas vẫn ở ui/co4e_canvas.py (chưa đổi tên), việc dời file này KHÔNG thuộc lane này | co | - | +| `Co4ETab.zoom_in_btn` | 1050 | `presentation/co4e/co4e_canvas_widget.py` | nút overlay canvas — ngoài phạm vi run-control | co | - | +| `Co4ETab.zoom_out_btn` | 1051 | `presentation/co4e/co4e_canvas_widget.py` | nút overlay canvas — ngoài phạm vi run-control | co | - | +| `Co4ETab.fit_btn` | 1052 | `presentation/co4e/co4e_canvas_widget.py` | nút overlay canvas — ngoài phạm vi run-control | co | - | +| `Co4ETab._build_chat` | 1060-1123 | `ui/co4e_tab.py` | method dài >60 dòng, dựng toàn bộ khung chat (header, stack theo flow, composer, routing toggle, usage total) — không thuộc trang Runs -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._chat_widget` | 1062 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._mhdr` | 1068 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab.msgs_icon` | 1070 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab.msgs_title` | 1071 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab.chat_toggle_btn` | 1072 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab.chat_stack` | 1087 | `ui/co4e_tab.py` | một ChatView mỗi flow — trạng thái chia sẻ đọc bởi _apply_workflow, _ensure_flow_log, _active_log -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._flow_logs` | 1088 | `ui/co4e_tab.py` | Dict[str, ChatView] theo wf.id — trạng thái chia sẻ giữa các tab flow -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab.chat_input_row` | 1090 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._usage_total_lbl` | 1095 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab.chat_input` | 1101 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab.chat_send_btn` | 1104 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab.co4e_routing_toggle` | 1109 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._co4e_routed_provider` | 1110 | `ui/co4e_tab.py` | override provider định tuyến cho lượt kế tiếp — trạng thái đọc/ghi ở nhiều nơi ngoài lát này (dòng 1849, 1871, 1878) -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._vsplit_sizes` | 1117 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._msgs_collapsed` | 1118 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._toggle_messages` | 1125-1157 | `ui/co4e_tab.py` | expand/collapse khung chat, đọc/ghi self._vsplit — không thuộc trang Runs -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._ensure_flow_log` | 1160-1169 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._active_log` | 1171-1173 | `ui/co4e_tab.py` | khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab.chat_log` | 1175-1179 | `ui/co4e_tab.py` | property, không phải attribute gán trực tiếp — liệt kê vì là symbol công khai -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._plan_bubble` | 1181-1187 | `ui/co4e_tab.py` | property getter/setter, ủy quyền sang self._active_log()._co4e_plan_bubble -- QUYET DINH: khung CHAT — thuộc lane co4e_chat_view.py (chưa tồn tại); giữ nguyên ui/co4e_tab.py cho tới khi lane đó tách, ngoài phạm vi lane run-control. Bảng cũ đã xếp sẵn vào presentation/co4e/co4e_chat_view.py | co | - | +| `Co4ETab._apply_workflow` | 1190-1204 | `ui/co4e_tab.py` | gán self._wf — trạng thái chia sẻ trung tâm của cả tab (đọc/ghi khắp nơi); gọi self.canvas.load/relayout/fit_view và self._update_run_btn/_refresh_usage_total (ngoài lát này) -- QUYET DINH: gán self._wf trung tâm — container | co | - | +| `Co4ETab._new_workflow` | 1205-1213 | `ui/co4e_tab.py` | gọi self._open_flow (ngoài lát này) | co | - | +| `Co4ETab._selected_wf` | 1215-1221 | `ui/co4e_tab.py` | co4e.get_workflow đọc storage — thuần logic sidebar, không thuộc trang Runs | co | - | +| `Co4ETab._load_selected_workflow` | 1223-1226 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._edit_selected_workflow` | 1228-1233 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._duplicate_selected_workflow` | 1235-1242 | `application/workflows/co4e_workflow_service.py` | co4e.duplicate_workflow ghi storage -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control | co | - | +| `Co4ETab._wf_context_menu` | 1244-1267 | `ui/co4e_tab.py` | menu chuột phải cho danh sách flow đã lưu, không phải trang Runs -- QUYET DINH: menu chuột phải cho danh sách flow đã lưu (sidebar) | co | - | +| `Co4ETab._rename_workflow` | 1269-1285 | `application/workflows/co4e_workflow_service.py` | co4e.save_workflow ghi storage; đọc/ghi self._wf.name và self.name_edit -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control | co | - | +| `Co4ETab._delete_selected_workflow` | 1287-1293 | `application/workflows/co4e_workflow_service.py` | co4e.delete_workflow ghi storage -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control | co | - | +| `Co4ETab._sync_wf_from_canvas` | 1295-1298 | `ui/co4e_tab.py` | đọc self.canvas.nodes()/edges() và self.name_edit, ghi vào self._wf — trạng thái chia sẻ -- QUYET DINH: khớp bảng cũ | co | - | +| `Co4ETab._save` | 1300-1305 | `application/workflows/co4e_workflow_service.py` | co4e.save_workflow ghi storage -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control | co | - | +| `Co4ETab._autosave` | 1307-1310 | `application/workflows/co4e_workflow_service.py` | co4e.save_workflow ghi storage -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control | co | - | +| `Co4ETab._on_name_changed` | 1312-1314 | `ui/co4e_tab.py` | gọi self._sync_active_flow_tab_text (ngoài lát này) | co | - | +| `Co4ETab._add_blank_step` | 1316-1318 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._on_node_selected` | 1321-1327 | `ui/co4e_tab.py` | đọc self.canvas.nodes(), self.config, self._config_collapsed -- QUYET DINH: đọc canvas selection rồi TOGGLE khung bọc _wrap_config (self._config_collapsed) — thuộc container, không phải nội dung StepConfigPanel. Bảng cũ xếp vào node_property_panel.py — không đúng vai trò khung bọc vs nội dung panel | co | - | +| `Co4ETab._on_config_changed` | 1329-1332 | `ui/co4e_tab.py` | cùng lý do với _on_node_selected | co | - | +| `Co4ETab._new_agent` | 1335-1336 | `presentation/co4e/agent_list_panel.py` | khớp bảng cũ, ngoài phạm vi run-control | co | - | +| `Co4ETab._edit_agent` | 1338-1346 | `presentation/co4e/agent_list_panel.py` | khớp bảng cũ, ngoài phạm vi run-control | co | - | +| `Co4ETab._edit_agent_dialog` | 1348-1354 | `presentation/co4e/agent_list_panel.py` | co4e.save_custom_agent ghi storage; mở dialog Qt -- QUYET DINH: khớp bảng cũ, ngoài phạm vi run-control | co | - | +| `Co4ETab._delete_agent` | 1356-1363 | `presentation/co4e/agent_list_panel.py` | co4e.delete_custom_agent ghi storage -- QUYET DINH: khớp bảng cũ, ngoài phạm vi run-control | co | - | +| `Co4ETab._manage_skills` | 1365-1369 | `presentation/co4e/skills_list_panel.py` | mở SkillsDialog (Qt) -- QUYET DINH: khớp bảng cũ, ngoài phạm vi run-control | co | - | +| `Co4ETab._skill_map` | 1372-1378 | `application/workflows/co4e_workflow_service.py` | logic thuần, không phải trang Runs — thuộc nhóm run/mode bị loại trừ khỏi run_control_widget theo mô tả đích -- QUYET DINH: đã có quyết định của lane workflow-service (bảng cũ); ngoài phạm vi run-control | co | - | +| `Co4ETab._current_mode` | 1380-1381 | `ui/co4e_tab.py` | thuộc mode/run toolbar — loại trừ khỏi run_control_widget theo mô tả đích -- QUYET DINH: đọc mode_combo của toolbar mode/run — mô tả đích loại trừ nhóm mode/run khỏi co4e_run_control_widget.py; bảng cũ xếp vào đó — mâu thuẫn với phạm vi hiện tại | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1384-1385) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._on_mode_changed` | 1383-1389 | `ui/co4e_tab.py` | reset self._manual_active/_manual_order/_manual_idx — thuộc mode/run toolbar, loại trừ khỏi run_control_widget theo mô tả đích -- QUYET DINH: cùng nhóm mode/run toolbar — xem lý do ở _current_mode | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1387-1393) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._on_run_clicked` | 1391-1400 | `ui/co4e_tab.py` | cắt ngang lát — cần agent gộp đối chiếu (thân method tiếp tục sau dòng 1400). Đây là logic thực thi run — loại trừ khỏi run_control_widget theo mô tả đích; gọi self.manager.stop (trạng thái chia sẻ run manager) -- QUYET DINH: logic bấm nút Run (thực thi) — cùng nhóm bị loại trừ, xem lý do ở _current_mode | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1395-1400) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._start_canvas_run` | 1403-1420 | `ui/co4e_tab.py` | logic khởi chạy run trên canvas (không phải bảng Flow Status); đọc/ghi self._wf, self._flows tiles, self._flow_runs, self._run_logs — trạng thái chia sẻ với _on_manager_event và _manual_step | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1407-1424) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._plan_bubble` | 1413 | `ui/co4e_tab.py` | gán lại None khi bắt đầu run mới; cũng gán ở _manual_run_or_advance (1457) và đọc/ghi trong _append_plan qua log._co4e_plan_bubble — có thể đã khởi tạo lần đầu ở __init__ ngoài phạm vi đọc | co (nhung o dong khac: 1186-1187) | - | +| `Co4ETab._run_single` | 1422-1427 | `ui/co4e_tab.py` | - | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1426-1431) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._run_from` | 1429-1433 | `ui/co4e_tab.py` | - | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1433-1437) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._downstream` | 1435-1446 | `ui/co4e_tab.py` | đọc self.canvas.edges() — chỉ cần canvas object tồn tại, không cần app hiển thị; logic đồ thị thuần | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1439-1450) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._manual_run_or_advance` | 1449-1462 | `ui/co4e_tab.py` | khởi tạo self._manual_order/_manual_idx/_manual_active — trạng thái mode thủ công, không liên quan bảng Flow Status | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1453-1466) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._manual_order` | 1458 | `ui/co4e_tab.py` | trạng thái mode thủ công, dùng bởi _manual_step; có thể đã khởi tạo ở __init__ ngoài phạm vi đọc | co (nhung o dong khac: 253) | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 253) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._manual_idx` | 1459 | `ui/co4e_tab.py` | trạng thái mode thủ công, dùng bởi _manual_step/_on_manager_event | co (nhung o dong khac: 254) | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 254) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._manual_active` | 1460 | `ui/co4e_tab.py` | trạng thái mode thủ công, đọc bởi _on_manager_event | co (nhung o dong khac: 252) | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 252) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._manual_step` | 1464-1480 | `ui/co4e_tab.py` | ghi self._flow_runs[wf.id] và self._run_logs[run_id] — dict chia sẻ với _start_canvas_run/_on_manager_event | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1468-1484) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._topo_order` | 1482-1487 | `ui/co4e_tab.py` | đọc self.canvas.nodes()/edges() — thuần logic sắp xếp topo | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1486-1491) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._on_manager_event` | 1490-1546 | `ui/co4e_tab.py` | method gộp nhiều việc không liên quan: routing event theo loại (node_status/node_output/node_diff/node_plan/node_tool/run_done/error), cập nhật canvas, ghi self._outputs_for, dọn self._flow_runs/self._run_logs, gọi popup thông báo — nên tách nhỏ thêm dù chưa vượt 80 dòng. KHÔNG thuộc bảng Flow Status (không đụng runs_table trực tiếp), là logic thực thi run nên ở lại co4e_tab.py theo _doc | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1494-1550) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._notify_run_finished` | 1548-1569 | `ui/co4e_tab.py` | tạo QMessageBox không chặn, ghi self._run_popups — popup thông báo chung, không phải phần bảng Flow Status | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1552-1573) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._run_popups` | 1557 | `ui/co4e_tab.py` | danh sách giữ tham chiếu QMessageBox không-chặn để tránh bị GC — khởi tạo có điều kiện (hasattr) ngay trong _notify_run_finished thay vì __init__ | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1560-1561) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._refresh_runs` | 1571-1612 | `presentation/co4e/co4e_run_control_widget.py` | dựng lại bảng self.runs_table từ manager — đúng lõi 'Flow Status'; cũng đụng self._sections và self.flow_bar (tab text 'RUNS N') và gọi self._refresh_side_runs() — trạng thái chia sẻ với sidebar/tab strip ngoài phạm vi widget này, cần API cầu nối khi tách | co | - | +| `Co4ETab._stop_selected_run` | 1614-1620 | `presentation/co4e/co4e_run_control_widget.py` | nút Stop của bảng Flow Status | co | - | +| `Co4ETab._delete_selected_run` | 1622-1635 | `presentation/co4e/co4e_run_control_widget.py` | nút Delete; ghi self._flow_runs.pop/self._run_logs.pop — dict chia sẻ với logic thực thi run ở co4e_tab.py | co | - | +| `Co4ETab._runs_context_menu` | 1637-1651 | `presentation/co4e/co4e_run_control_widget.py` | context menu của runs_table (open run/output/rename/delete); action 'open_run' gọi self._open_run_from_table vốn cần self._open_flow + self.canvas (ở co4e_tab.py) — cần callback cầu nối khi tách | co | - | +| `Co4ETab.set_project` | 1654-1670 | `ui/co4e_tab.py` | đọc/ghi self._project_id, self._project_dir; gọi load_project (đọc đĩa) và manager.set_output_root/set_current_project; gọi self._refresh_ws_folder_btn() thuộc widget Flow Status — cần API cầu nối khi tách ra co4e_run_control_widget.py | co | - | +| `Co4ETab._project_id` | 1659 | `ui/co4e_tab.py` | trạng thái workspace hiện tại, dùng bởi manager.set_current_project và các hàm mở thư mục — chia sẻ giữa co4e_tab.py và co4e_run_control_widget.py | co (nhung o dong khac: 249) | - | +| `Co4ETab._project_dir` | 1660 | `ui/co4e_tab.py` | dùng bởi _flow_output_root — ảnh hưởng trực tiếp tới nút 'mở thư mục workspace' của Flow Status | co (nhung o dong khac: 250) | - | +| `Co4ETab._flow_output_root` | 1672-1682 | `ui/co4e_tab.py` | helper Path dùng chung bởi cả chat (_out_dir) và nút 'mở thư mục workspace' của Flow Status (_open_workspace_folder/_refresh_ws_folder_btn) — widget Flow Status cần được truyền hàm này qua callback/property thay vì tự tính | co | - | +| `Co4ETab._refresh_ws_folder_btn` | 1684-1689 | `presentation/co4e/co4e_run_control_widget.py` | cập nhật self.ws_folder_btn (nút mở thư mục workspace) — phụ thuộc self._flow_output_root() ở co4e_tab.py | co | - | +| `Co4ETab._open_workspace_folder` | 1691-1698 | `presentation/co4e/co4e_run_control_widget.py` | hành động của nút 'mở thư mục workspace'; mkdir + open_location (spawn process) | co | - | +| `Co4ETab._open_run_output_folder` | 1700-1711 | `presentation/co4e/co4e_run_control_widget.py` | mở thư mục output của 1 run cụ thể — dùng trong context menu bảng Flow Status; mkdir + open_location | co | - | +| `Co4ETab._rename_selected_run` | 1713-1744 | `presentation/co4e/co4e_run_control_widget.py` | nút Rename của bảng Flow Status; nhưng đồng bộ qua self._flows, self.flow_bar.setTabText, self.name_edit — trạng thái tab/canvas chia sẻ với co4e_tab.py, cần callback cầu nối; co4e.save_workflow ghi đĩa | co | - | +| `Co4ETab._run_selected_in_background` | 1746-1756 | `ui/co4e_tab.py` | chạy 1 flow được chọn (self._selected_wf(), không rõ nguồn — có thể là danh sách sidebar chứ không phải runs_table); gọi self._refresh_side_runs() — không khớp mô tả 'CHỈ bảng Flow Status' nên giữ ở co4e_tab.py | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1750-1760) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._wf_by_id` | 1758-1766 | `ui/co4e_tab.py` | co4e.get_workflow đọc file workflow đã lưu trên đĩa; helper dùng chung nhiều nơi (rerun, open-from-table) | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1762-1770) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._rerun_run_item` | 1768-1779 | `ui/co4e_tab.py` | docstring nói 'double-click a run in the history' nhưng item.data(Qt.UserRole) trực tiếp gợi ý đây là list sidebar 'side runs', KHÔNG phải bảng Flow Status (khác cách _open_run_from_table truy cập runs_table qua item.row()) — cần người quyết đây thuộc trang nào -- QUYET DINH: gọi self.manager.start(...) tức THỰC THI run (network/AI) — cùng nhóm run-execution bị loại trừ khỏi co4e_run_control_widget.py; bảng cũ xếp vào đó. Nghi vấn về nguồn item (sidebar hay bảng) không đổi kết luận vì lý do loại trừ là do HÀNH VI thực thi chứ không phải nơi click | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1772-1783) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab._open_run_from_table` | 1781-1800 | `ui/co4e_tab.py` | double-click bảng Flow Status nhưng gọi self._open_flow (chuyển tab) và self.canvas.update_node_status trực tiếp — vượt ra ngoài phạm vi 'chỉ bảng runs_table' nên giữ ở co4e_tab.py, cần callback nếu tách runs_table riêng | co | BANG CU SAI/QUA RONG: xep vao presentation/co4e/co4e_run_control_widget.py (dong 1785-1804) nhung pham vi run-control hien tai (mo ta dich cua 3 agent quet) loai tru nhom nay -> quyet dinh o day = ui/co4e_tab.py. | +| `Co4ETab.showEvent` | 1802-1805 | `ui/co4e_tab.py` | override Qt lifecycle của chính Co4ETab, gọi self._refresh_runs() — phải ở lại widget chính | co | - | +| `Co4ETab._out_dir` | 1807-1813 | `ui/co4e_tab.py` | mkdir; dùng cho chat/flow deliverables, không liên quan bảng Flow Status | co | - | +| `Co4ETab._chat_send` | 1816-1842 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._apply_co4e_routing` | 1844-1879 | `ui/co4e_tab.py` | ghi self._co4e_routed_provider; nhánh 'manual' dựng dialog confirm_switch(self,...) nên cần widget sống | co | - | +| `Co4ETab._co4e_routed_provider` | 1849 | `ui/co4e_tab.py` | dùng bởi _run_chat_turn để chọn provider — reset mỗi lần _apply_co4e_routing chạy | co | - | +| `Co4ETab._extract_agent_directive` | 1881-1887 | `ui/co4e_tab.py` | thuần regex, test được không cần Qt | co | - | +| `Co4ETab._resolve_agent` | 1889-1897 | `ui/co4e_tab.py` | co4e.list_custom_agents() đọc dữ liệu agent tuỳ biến đã lưu | co | - | +| `Co4ETab._run_chat_turn` | 1899-1970 | `ui/co4e_tab.py` | method dài, gộp: dựng prompt, chạy AgentWorker nền gọi provider AI (network), stream sự kiện vào bubble Qt, cập nhật usage — nên tách nhỏ thêm dù chỉ 72 dòng vì nhiều trách nhiệm khác nhau (build prompt / worker job / event routing / usage). Không liên quan bảng Flow Status | co | - | +| `Co4ETab._chat_worker` | 1953 | `ui/co4e_tab.py` | vị trí xuất hiện đầu tiên theo văn bản là trong hàm lồng 'done'; gán thật sự lúc chạy là dòng 1969 (w = AgentWorker...); có thể đã khởi tạo None ở __init__ ngoài phạm vi đọc | co (nhung o dong khac: 236) | - | +| `Co4ETab._append_chat` | 1972-1987 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._fmt_usage` | 1990-1997 | `ui/co4e_tab.py` | thuần formatting, không cần Qt | co | - | +| `Co4ETab._apply_usage` | 1999-2016 | `ui/co4e_tab.py` | ghi self._flow_usage[wf_id] — tổng usage theo flow, chia sẻ với _refresh_usage_total | co | - | +| `Co4ETab._refresh_usage_total` | 2018-2033 | `ui/co4e_tab.py` | đọc self._flow_usage và self._wf — trạng thái chia sẻ với _apply_usage | co | - | +| `Co4ETab._append_diff` | 2035-2039 | `ui/co4e_tab.py` | - | co | - | +| `Co4ETab._append_plan` | 2041-2052 | `ui/co4e_tab.py` | ghi log._co4e_plan_bubble — thuộc tính gắn động lên ChatView, chia sẻ với _run_chat_turn | co | - | +| `Co4ETab._retranslate` | 2055-2075 | `ui/co4e_tab.py` | gộp retranslate cho CẢ widget chung (wf_new_btn, self._sections) LẪN các nút riêng của Flow Status (runs_back_btn, run_stop_btn, run_rename_btn, run_del_btn, run_clear_btn, runs_table headers, ws_folder_btn) — khi tách co4e_run_control_widget.py cần chia method này làm hai, phần Flow Status nên có retranslate riêng gọi từ đây | co | - | +| `_html_escape` | 2078-2079 | `ui/co4e_tab.py` | hàm module-level thuần string escape; không thấy nơi gọi trong phạm vi 1401-2084 nên chưa rõ nó phục vụ phần nào — có thể dùng ở phần chat render ngoài phạm vi đọc -- QUYET DINH: escape string thuần cho phần render CHAT — lane co4e_chat_view.py (chưa tồn tại); bảng cũ đã xếp sẵn vào đó, ngoài phạm vi run-control nên giữ nguyên vị trí vật lý hiện tại | co | - | +| `_qcolor` | 2082-2084 | `presentation/co4e/co4e_run_control_widget.py` | QColor là kiểu giá trị (như QPointF/QRectF), không cần QApplication sống; chỉ thấy dùng trong _refresh_runs (tô màu cột status của bảng Flow Status) trong phạm vi đọc | co | - | + +## Chỗ thấy khác tài liệu — cần người quyết + +Không có symbol nào trong 215 symbol thô có note bắt đầu bằng `khac tai lieu:` — mục này để trống theo đúng yêu cầu tự kiểm (không có gì cần liệt kê). diff --git a/docs/architecture/co4e-split-map.json b/docs/architecture/co4e-split-map.json new file mode 100644 index 0000000..7969360 --- /dev/null +++ b/docs/architecture/co4e-split-map.json @@ -0,0 +1,5858 @@ +{ + "generated_from_raw_symbol_count": 367, + "final_row_count": 363, + "expected_controls_checked": [ + "wf_list", + "wf_edit_btn", + "wf_dup_btn", + "wf_del_btn", + "wf_runbg_btn", + "agent_list", + "ag_new_btn", + "ag_edit_btn", + "ag_del_btn", + "skill_list", + "sk_manage_btn", + "runs_btn", + "runs_back_btn", + "runs_table", + "runs_side_list", + "runs_more_btn", + "name_edit", + "add_step_btn", + "save_btn", + "save_tpl_btn", + "mode_combo", + "run_btn", + "run_stop_btn", + "run_rename_btn", + "run_del_btn", + "run_clear_btn", + "ws_folder_btn" + ], + "expected_controls_ok": true, + "khac_tai_lieu_notes_found": 0, + "merged_duplicate_symbol_groups": [ + "Co4ECanvas.dropEvent", + "Co4ETab._co4e_routed_provider", + "Co4ETab._config_expanded_w", + "Co4ETab._reload_sidebar" + ], + "kept_separate_anomaly_symbols": [ + "Co4ETab.showEvent" + ], + "rows": [ + { + "symbol": "Co4ETab._flow_outputs", + "kind": "attribute", + "line_display": "245", + "line_start": 245, + "line_end": 245, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "application/workflows/co4e_workflow_service.py", + "note": "state per-flow outputs — ứng viên chuyển vào state machine thuần Python", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 29 + ] + }, + { + "symbol": "Co4ETab._outputs_for", + "kind": "method", + "line_display": "475-478", + "line_start": 475, + "line_end": 478, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "application/workflows/co4e_workflow_service.py", + "note": "truy cập dict state per-flow outputs, thuần Python", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 54 + ] + }, + { + "symbol": "Co4ETab._duplicate_selected_workflow", + "kind": "method", + "line_display": "1239-1246", + "line_start": 1239, + "line_end": 1246, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "note": "tương ứng _duplicate_flow() trong bảng plan.md dòng 616, nhưng tên hàm thực tế khác (_duplicate_selected_workflow). Gộp gọi service (co4e.duplicate_workflow, đĩa) với cập nhật UI (self._reload_sidebar(), self.status_message.emit) — cần tách; phần UI nên ở lại co4e_tab.py.", + "in_old_table": "co", + "old_table_mismatch": "ate_flow() trong bảng plan.md dòng 616, nhưng tên hàm thực tế khác (_duplicate_selected_workflow). Gộp gọi service (co4e.duplicate_workflow, đĩa)", + "merged_from_raw_indices": [ + 155 + ] + }, + { + "symbol": "Co4ETab._rename_workflow", + "kind": "method", + "line_display": "1273-1289", + "line_start": 1273, + "line_end": 1289, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "note": "mở QInputDialog (cần Qt) rồi gọi co4e.save_workflow (đĩa), đồng bộ self._wf.name/self.name_edit nếu flow đang mở là flow bị đổi tên — gộp UI dialog + service + trạng thái chia sẻ self._wf trong 1 hàm, nên tách.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 157 + ] + }, + { + "symbol": "Co4ETab._delete_selected_workflow", + "kind": "method", + "line_display": "1291-1297", + "line_start": 1291, + "line_end": 1297, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "note": "tương ứng _delete_flow() trong bảng plan.md dòng 616; gọi co4e.delete_workflow (đĩa).", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 158 + ] + }, + { + "symbol": "Co4ETab._save", + "kind": "method", + "line_display": "1304-1309", + "line_start": 1304, + "line_end": 1309, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "note": "gộp _sync_wf_from_canvas (đọc canvas UI), lưu đĩa (co4e.save_workflow), và cập nhật UI (_reload_sidebar, status_message) — cần tách phần service khỏi phần UI khi chuyển sang co4e_workflow_service.py.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 160 + ] + }, + { + "symbol": "Co4ETab._autosave", + "kind": "method", + "line_display": "1311-1314", + "line_start": 1311, + "line_end": 1314, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "note": "gọi self._sync_wf_from_canvas() (cần canvas) rồi co4e.get_workflow/save_workflow (đĩa).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 161 + ] + }, + { + "symbol": "Co4ETab._skill_map", + "kind": "method", + "line_display": "1376-1382", + "line_start": 1376, + "line_end": 1382, + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "application/workflows/co4e_workflow_service.py", + "note": "chuẩn bị nội dung skill (skills_mod.skill_prefix_for, đọc đĩa) để đưa vào lúc chạy flow/chat — không có trong bảng plan.md, tự xếp theo chức năng (dùng lúc run/build system prompt, không phải UI danh sách skill).", + "in_old_table": "co", + "old_table_mismatch": "ọc đĩa) để đưa vào lúc chạy flow/chat — không có trong bảng plan.md, tự xếp theo chức năng (dùng lúc run/build system prompt, không phải UI danh sá", + "merged_from_raw_indices": [ + 171 + ] + }, + { + "symbol": "Co4ETab.ag_new_btn", + "kind": "attribute", + "line_display": "550", + "line_start": 550, + "line_end": 550, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "note": "hiện định nghĩa trực tiếp trong Co4ETab._build_sidebar — ứng viên chuyển sang agent_list_panel.py tương tự cách skills đã tách", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 69 + ] + }, + { + "symbol": "Co4ETab.agent_list", + "kind": "attribute", + "line_display": "558", + "line_start": 558, + "line_end": 558, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "note": "cùng lý do với ag_new_btn", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 70 + ] + }, + { + "symbol": "Co4ETab.ag_edit_btn", + "kind": "attribute", + "line_display": "562", + "line_start": 562, + "line_end": 562, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "note": "cùng lý do với ag_new_btn", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 71 + ] + }, + { + "symbol": "Co4ETab.ag_del_btn", + "kind": "attribute", + "line_display": "563", + "line_start": 563, + "line_end": 563, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "note": "cùng lý do với ag_new_btn", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 72 + ] + }, + { + "symbol": "Co4ETab._new_agent", + "kind": "method", + "line_display": "1339-1340", + "line_start": 1339, + "line_end": 1340, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/agent_list_panel.py", + "note": "tương ứng _create_agent() trong bảng plan.md dòng 620 (tên hàm thực tế là _new_agent).", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 166 + ] + }, + { + "symbol": "Co4ETab._edit_agent", + "kind": "method", + "line_display": "1342-1350", + "line_start": 1342, + "line_end": 1350, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/agent_list_panel.py", + "note": "khớp _edit_agent() dòng 620 plan.md; gọi co4e.list_custom_agents() (đĩa).", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 167 + ] + }, + { + "symbol": "Co4ETab._edit_agent_dialog", + "kind": "method", + "line_display": "1352-1358", + "line_start": 1352, + "line_end": 1358, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/agent_list_panel.py", + "note": "mở Co4EAgentDialog rồi co4e.save_custom_agent (đĩa) và self._reload_sidebar() — trạng thái chia sẻ, liên quan tới cắt ngang lát ở _reload_sidebar.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 168 + ] + }, + { + "symbol": "Co4ETab._delete_agent", + "kind": "method", + "line_display": "1360-1367", + "line_start": 1360, + "line_end": 1367, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/agent_list_panel.py", + "note": "khớp _delete_agent() dòng 620 plan.md; gọi co4e.delete_custom_agent (đĩa).", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 169 + ] + }, + { + "symbol": "_status_color", + "kind": "function", + "line_display": "43-50", + "line_start": 43, + "line_end": 50, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 221 + ] + }, + { + "symbol": "_NodeItem", + "kind": "class", + "line_display": "59-210", + "line_start": 59, + "line_end": 210, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "class nội bộ gắn chặt với Co4ECanvas qua self.canvas backreference — nên đi cùng file với Co4ECanvas", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 222 + ] + }, + { + "symbol": "_NodeItem.__init__", + "kind": "method", + "line_display": "62-72", + "line_start": 62, + "line_end": 72, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 223 + ] + }, + { + "symbol": "_NodeItem.node", + "kind": "attribute", + "line_display": "64", + "line_start": 64, + "line_end": 64, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "giữ tham chiếu domain Node — dữ liệu chia sẻ với core/co4e.py", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 224 + ] + }, + { + "symbol": "_NodeItem.canvas", + "kind": "attribute", + "line_display": "65", + "line_start": 65, + "line_end": 65, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "backreference tới Co4ECanvas cha — mọi event của _NodeItem đều gọi ngược lên canvas (add_step_below, begin_connect, delete_node, các signal) — điểm khớp nối chặt nhất trong file", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 225 + ] + }, + { + "symbol": "_NodeItem.status", + "kind": "attribute", + "line_display": "66", + "line_start": 66, + "line_end": 66, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 226 + ] + }, + { + "symbol": "_NodeItem._porting", + "kind": "attribute", + "line_display": "67", + "line_start": 67, + "line_end": 67, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 227 + ] + }, + { + "symbol": "_NodeItem.boundingRect", + "kind": "method", + "line_display": "74-76", + "line_start": 74, + "line_end": 76, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "trả QRectF như kiểu giá trị, logic thuần", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 228 + ] + }, + { + "symbol": "_NodeItem._card_rect", + "kind": "method", + "line_display": "78-79", + "line_start": 78, + "line_end": 79, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 229 + ] + }, + { + "symbol": "_NodeItem.paint", + "kind": "method", + "line_display": "81-139", + "line_start": 81, + "line_end": 139, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "vẽ toàn bộ card: nền, header stripe, label, badge role, preview instructions/sub-agents, footer model/skills, 2 port — gộp nhiều việc nhưng vẫn dưới 80 dòng nên chưa bắt buộc tách thêm", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 230 + ] + }, + { + "symbol": "_NodeItem._in_out_port", + "kind": "method", + "line_display": "141-143", + "line_start": 141, + "line_end": 143, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "hình học thuần dùng QPointF như kiểu giá trị", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 231 + ] + }, + { + "symbol": "_NodeItem.itemChange", + "kind": "method", + "line_display": "145-156", + "line_start": 145, + "line_end": 156, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "ghi self.node.x/y rồi gọi self.canvas._reposition_edges() và emit self.canvas.graph_changed/node_selected — chạm trạng thái chia sẻ của canvas cha", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 232 + ] + }, + { + "symbol": "_NodeItem.hoverMoveEvent", + "kind": "method", + "line_display": "158-161", + "line_start": 158, + "line_end": 161, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 233 + ] + }, + { + "symbol": "_NodeItem.mousePressEvent", + "kind": "method", + "line_display": "163-174", + "line_start": 163, + "line_end": 174, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "đọc/ghi self.canvas._connect_from, gọi canvas._finish_connect/begin_port_drag — trạng thái connect-mode chia sẻ với Co4ECanvas", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 234 + ] + }, + { + "symbol": "_NodeItem.mouseMoveEvent", + "kind": "method", + "line_display": "176-181", + "line_start": 176, + "line_end": 181, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 235 + ] + }, + { + "symbol": "_NodeItem.mouseReleaseEvent", + "kind": "method", + "line_display": "183-189", + "line_start": 183, + "line_end": 189, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 236 + ] + }, + { + "symbol": "_NodeItem.mouseDoubleClickEvent", + "kind": "method", + "line_display": "191-193", + "line_start": 191, + "line_end": 193, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 237 + ] + }, + { + "symbol": "_NodeItem.contextMenuEvent", + "kind": "method", + "line_display": "195-207", + "line_start": 195, + "line_end": 207, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "gọi canvas.add_step_below/begin_connect/delete_node — trạng thái/hành vi thuộc canvas cha", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 238 + ] + }, + { + "symbol": "_NodeItem.center", + "kind": "method", + "line_display": "209-210", + "line_start": 209, + "line_end": 210, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "trả QPointF như kiểu giá trị", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 239 + ] + }, + { + "symbol": "_EdgeItem", + "kind": "class", + "line_display": "213-286", + "line_start": 213, + "line_end": 286, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "class nội bộ gắn chặt với Co4ECanvas qua self.canvas backreference", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 240 + ] + }, + { + "symbol": "_EdgeItem.__init__", + "kind": "method", + "line_display": "214-225", + "line_start": 214, + "line_end": 225, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 241 + ] + }, + { + "symbol": "_EdgeItem.edge", + "kind": "attribute", + "line_display": "216", + "line_start": 216, + "line_end": 216, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "tham chiếu domain Edge — chia sẻ với core/co4e.py", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 242 + ] + }, + { + "symbol": "_EdgeItem.canvas", + "kind": "attribute", + "line_display": "217", + "line_start": 217, + "line_end": 217, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "backreference tới Co4ECanvas — contextMenuEvent gọi canvas.delete_edge", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 243 + ] + }, + { + "symbol": "_EdgeItem._dst", + "kind": "attribute", + "line_display": "218", + "line_start": 218, + "line_end": 218, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 244 + ] + }, + { + "symbol": "_EdgeItem._hover", + "kind": "attribute", + "line_display": "224", + "line_start": 224, + "line_end": 224, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 245 + ] + }, + { + "symbol": "_EdgeItem._apply_pen", + "kind": "method", + "line_display": "227-235", + "line_start": 227, + "line_end": 235, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 246 + ] + }, + { + "symbol": "_EdgeItem.update_path", + "kind": "method", + "line_display": "237-239", + "line_start": 237, + "line_end": 239, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 247 + ] + }, + { + "symbol": "_EdgeItem.boundingRect", + "kind": "method", + "line_display": "241-242", + "line_start": 241, + "line_end": 242, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "gọi super().boundingRect() phụ thuộc trạng thái path sống của item", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 248 + ] + }, + { + "symbol": "_EdgeItem.shape", + "kind": "method", + "line_display": "244-249", + "line_start": 244, + "line_end": 249, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "dùng QPainterPathStroker trên self.path() sống của item", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 249 + ] + }, + { + "symbol": "_EdgeItem.hoverEnterEvent", + "kind": "method", + "line_display": "251-255", + "line_start": 251, + "line_end": 255, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 250 + ] + }, + { + "symbol": "_EdgeItem.hoverLeaveEvent", + "kind": "method", + "line_display": "257-261", + "line_start": 257, + "line_end": 261, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 251 + ] + }, + { + "symbol": "_EdgeItem.paint", + "kind": "method", + "line_display": "263-279", + "line_start": 263, + "line_end": 279, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 252 + ] + }, + { + "symbol": "_EdgeItem.contextMenuEvent", + "kind": "method", + "line_display": "281-286", + "line_start": 281, + "line_end": 286, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "gọi self.canvas.delete_edge(self.edge)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 253 + ] + }, + { + "symbol": "Co4ECanvas", + "kind": "class", + "line_display": "289-700", + "line_start": 289, + "line_end": 700, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "cắt ngang lát — class tiếp tục sau dòng 700 (dropEvent chưa kết thúc, có thể còn method khác chưa đọc) — cần agent gộp đối chiếu với phần đọc dòng 701+", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 254 + ] + }, + { + "symbol": "Co4ECanvas.node_selected", + "kind": "attribute", + "line_display": "290", + "line_start": 290, + "line_end": 290, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "Signal được node_property_panel.py (và co4e_tab.py) nối vào để nạp node được chọn — điểm chia sẻ giữa canvas và property panel", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 255 + ] + }, + { + "symbol": "Co4ECanvas.node_activated", + "kind": "attribute", + "line_display": "291", + "line_start": 291, + "line_end": 291, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "Signal double-click, có thể được co4e_tab.py nối để mở panel chỉnh sửa — cần kiểm nơi consume", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 256 + ] + }, + { + "symbol": "Co4ECanvas.graph_changed", + "kind": "attribute", + "line_display": "292", + "line_start": 292, + "line_end": 292, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "Signal báo graph đổi (autosave) — nhiều khả năng được co4e_tab.py/co4e_workflow_service.py nối để lưu flow, trạng thái chia sẻ xuyên lớp application", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 257 + ] + }, + { + "symbol": "Co4ECanvas.__init__", + "kind": "method", + "line_display": "296-315", + "line_start": 296, + "line_end": 315, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 258 + ] + }, + { + "symbol": "Co4ECanvas._scene", + "kind": "attribute", + "line_display": "299", + "line_start": 299, + "line_end": 299, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 259 + ] + }, + { + "symbol": "Co4ECanvas._nodes", + "kind": "attribute", + "line_display": "305", + "line_start": 305, + "line_end": 305, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "dict id->_NodeItem — trạng thái trung tâm được đọc/ghi bởi gần như mọi method của Co4ECanvas (add/delete/relayout/zoom/status/route edges)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 260 + ] + }, + { + "symbol": "Co4ECanvas._edges", + "kind": "attribute", + "line_display": "306", + "line_start": 306, + "line_end": 306, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "list _EdgeItem — trạng thái trung tâm tương tự self._nodes", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 261 + ] + }, + { + "symbol": "Co4ECanvas._connect_from", + "kind": "attribute", + "line_display": "307", + "line_start": 307, + "line_end": 307, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "trạng thái connect-mode, cũng được _NodeItem.mousePressEvent đọc/ghi qua self.canvas", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 262 + ] + }, + { + "symbol": "Co4ECanvas._zoom", + "kind": "attribute", + "line_display": "308", + "line_start": 308, + "line_end": 308, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 263 + ] + }, + { + "symbol": "Co4ECanvas._panning", + "kind": "attribute", + "line_display": "309", + "line_start": 309, + "line_end": 309, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 264 + ] + }, + { + "symbol": "Co4ECanvas._pan_start", + "kind": "attribute", + "line_display": "310", + "line_start": 310, + "line_end": 310, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 265 + ] + }, + { + "symbol": "Co4ECanvas._overlay", + "kind": "attribute", + "line_display": "311", + "line_start": 311, + "line_end": 311, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "widget zoom/fit overlay được co4e_tab.py hoặc co4e_canvas_widget.py truyền vào qua add_overlay()", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 266 + ] + }, + { + "symbol": "Co4ECanvas._port_src", + "kind": "attribute", + "line_display": "313", + "line_start": 313, + "line_end": 313, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 267 + ] + }, + { + "symbol": "Co4ECanvas._port_src_pt", + "kind": "attribute", + "line_display": "314", + "line_start": 314, + "line_end": 314, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 268 + ] + }, + { + "symbol": "Co4ECanvas._temp_edge", + "kind": "attribute", + "line_display": "315", + "line_start": 315, + "line_end": 315, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 269 + ] + }, + { + "symbol": "Co4ECanvas.add_overlay", + "kind": "method", + "line_display": "318-323", + "line_start": 318, + "line_end": 323, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 270 + ] + }, + { + "symbol": "Co4ECanvas._place_overlay", + "kind": "method", + "line_display": "325-330", + "line_start": 325, + "line_end": 330, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 271 + ] + }, + { + "symbol": "Co4ECanvas.resizeEvent", + "kind": "method", + "line_display": "332-334", + "line_start": 332, + "line_end": 334, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 272 + ] + }, + { + "symbol": "Co4ECanvas.scrollContentsBy", + "kind": "method", + "line_display": "336-341", + "line_start": 336, + "line_end": 341, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 273 + ] + }, + { + "symbol": "Co4ECanvas.showEvent", + "kind": "method", + "line_display": "343-345", + "line_start": 343, + "line_end": 345, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 274 + ] + }, + { + "symbol": "Co4ECanvas.load", + "kind": "method", + "line_display": "348-362", + "line_start": 348, + "line_end": 362, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "reset toàn bộ self._nodes/self._edges/self._connect_from/self._port_src/self._temp_edge — điểm nạp lại state từ flow, được co4e_tab.py hoặc co4e_workflow_service.py gọi khi mở flow", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 275 + ] + }, + { + "symbol": "Co4ECanvas.nodes", + "kind": "method", + "line_display": "364-365", + "line_start": 364, + "line_end": 365, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "chỉ đọc .node từ self._nodes, không gọi API Qt trực tiếp", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 276 + ] + }, + { + "symbol": "Co4ECanvas.edges", + "kind": "method", + "line_display": "367-368", + "line_start": 367, + "line_end": 368, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 277 + ] + }, + { + "symbol": "Co4ECanvas.add_node", + "kind": "method", + "line_display": "371-382", + "line_start": 371, + "line_end": 382, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "ghi self._nodes, scene.addItem, emit graph_changed/node_selected — trạng thái chia sẻ với property panel qua node_selected", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 278 + ] + }, + { + "symbol": "Co4ECanvas.add_step_below", + "kind": "method", + "line_display": "384-390", + "line_start": 384, + "line_end": 390, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "orchestration thuần, ủy quyền cho add_node (bản thân không gọi trực tiếp API Qt)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 279 + ] + }, + { + "symbol": "Co4ECanvas._chain_tail", + "kind": "method", + "line_display": "392-396", + "line_start": 392, + "line_end": 396, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 280 + ] + }, + { + "symbol": "Co4ECanvas.add_palette_step", + "kind": "method", + "line_display": "398-400", + "line_start": 398, + "line_end": 400, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 281 + ] + }, + { + "symbol": "Co4ECanvas.begin_connect", + "kind": "method", + "line_display": "402-403", + "line_start": 402, + "line_end": 403, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 282 + ] + }, + { + "symbol": "Co4ECanvas._finish_connect", + "kind": "method", + "line_display": "405-409", + "line_start": 405, + "line_end": 409, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 283 + ] + }, + { + "symbol": "Co4ECanvas.begin_port_drag", + "kind": "method", + "line_display": "412-419", + "line_start": 412, + "line_end": 419, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 284 + ] + }, + { + "symbol": "Co4ECanvas.update_port_drag", + "kind": "method", + "line_display": "421-424", + "line_start": 421, + "line_end": 424, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 285 + ] + }, + { + "symbol": "Co4ECanvas.finish_port_drag", + "kind": "method", + "line_display": "426-435", + "line_start": 426, + "line_end": 435, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 286 + ] + }, + { + "symbol": "Co4ECanvas._node_at", + "kind": "method", + "line_display": "437-441", + "line_start": 437, + "line_end": 441, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "dùng self._scene.items(scene_pt) — cần scene đang sống", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 287 + ] + }, + { + "symbol": "Co4ECanvas._make_edge", + "kind": "method", + "line_display": "443-451", + "line_start": 443, + "line_end": 451, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 288 + ] + }, + { + "symbol": "Co4ECanvas._add_edge_item", + "kind": "method", + "line_display": "453-456", + "line_start": 453, + "line_end": 456, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 289 + ] + }, + { + "symbol": "Co4ECanvas.delete_edge", + "kind": "method", + "line_display": "458-463", + "line_start": 458, + "line_end": 463, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 290 + ] + }, + { + "symbol": "Co4ECanvas.delete_node", + "kind": "method", + "line_display": "465-475", + "line_start": 465, + "line_end": 475, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 291 + ] + }, + { + "symbol": "Co4ECanvas.delete_selected", + "kind": "method", + "line_display": "477-481", + "line_start": 477, + "line_end": 481, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 292 + ] + }, + { + "symbol": "Co4ECanvas._zoom_by", + "kind": "method", + "line_display": "484-495", + "line_start": 484, + "line_end": 495, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 293 + ] + }, + { + "symbol": "Co4ECanvas.zoom_in", + "kind": "method", + "line_display": "497-498", + "line_start": 497, + "line_end": 498, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 294 + ] + }, + { + "symbol": "Co4ECanvas.zoom_out", + "kind": "method", + "line_display": "500-501", + "line_start": 500, + "line_end": 501, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 295 + ] + }, + { + "symbol": "Co4ECanvas.reset_zoom", + "kind": "method", + "line_display": "503-505", + "line_start": 503, + "line_end": 505, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 296 + ] + }, + { + "symbol": "Co4ECanvas.wheelEvent", + "kind": "method", + "line_display": "507-519", + "line_start": 507, + "line_end": 519, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 297 + ] + }, + { + "symbol": "Co4ECanvas.mousePressEvent", + "kind": "method", + "line_display": "522-529", + "line_start": 522, + "line_end": 529, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "trùng tên với _NodeItem.mousePressEvent nhưng là override của Co4ECanvas (pan chuột giữa) — đừng nhầm khi gộp map", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 298 + ] + }, + { + "symbol": "Co4ECanvas.mouseMoveEvent", + "kind": "method", + "line_display": "531-540", + "line_start": 531, + "line_end": 540, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 299 + ] + }, + { + "symbol": "Co4ECanvas.mouseReleaseEvent", + "kind": "method", + "line_display": "542-548", + "line_start": 542, + "line_end": 548, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 300 + ] + }, + { + "symbol": "Co4ECanvas.fit_view", + "kind": "method", + "line_display": "550-558", + "line_start": 550, + "line_end": 558, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 301 + ] + }, + { + "symbol": "Co4ECanvas.relayout", + "kind": "method", + "line_display": "560-578", + "line_start": 560, + "line_end": 578, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "phần tính waves/cols (compute_waves, defaultdict) là logic thuần, phần item.setPos() cần scene sống — có thể tách hàm tính toạ độ ra khỏi phần apply nếu muốn test thuần Python", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 302 + ] + }, + { + "symbol": "Co4ECanvas.relayout_if_vertical", + "kind": "method", + "line_display": "580-589", + "line_start": 580, + "line_end": 589, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "bản thân chỉ ra quyết định thuần dựa trên node.x, việc chạm Qt nằm trong relayout() được gọi", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 303 + ] + }, + { + "symbol": "Co4ECanvas.add_workflow", + "kind": "method", + "line_display": "591-610", + "line_start": 591, + "line_end": 610, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 304 + ] + }, + { + "symbol": "Co4ECanvas.update_node_status", + "kind": "method", + "line_display": "612-616", + "line_start": 612, + "line_end": 616, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "được co4e_run_control_widget.py gọi khi step chạy/xong/lỗi — điểm nối giữa canvas và run control", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 305 + ] + }, + { + "symbol": "Co4ECanvas.reset_statuses", + "kind": "method", + "line_display": "618-621", + "line_start": 618, + "line_end": 621, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "được co4e_run_control_widget.py gọi khi bắt đầu run mới", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 306 + ] + }, + { + "symbol": "Co4ECanvas.refresh_node", + "kind": "method", + "line_display": "623-626", + "line_start": 623, + "line_end": 626, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 307 + ] + }, + { + "symbol": "Co4ECanvas._node_rects", + "kind": "method", + "line_display": "628-638", + "line_start": 628, + "line_end": 638, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "dựng QRectF như kiểu giá trị từ item.pos() — logic hình học thuần", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 308 + ] + }, + { + "symbol": "Co4ECanvas._reposition_edges", + "kind": "method", + "line_display": "640-649", + "line_start": 640, + "line_end": 649, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "gọi e.update_path (setPath) trên item sống, dùng hàm định tuyến _route từ canvas_geometry.py", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 309 + ] + }, + { + "symbol": "Co4ECanvas.keyPressEvent", + "kind": "method", + "line_display": "652-669", + "line_start": 652, + "line_end": 669, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 310 + ] + }, + { + "symbol": "Co4ECanvas.dragEnterEvent", + "kind": "method", + "line_display": "671-675", + "line_start": 671, + "line_end": 675, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 311 + ] + }, + { + "symbol": "Co4ECanvas.dragMoveEvent", + "kind": "method", + "line_display": "677-681", + "line_start": 677, + "line_end": 681, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 312 + ] + }, + { + "symbol": "Co4ECanvas.dropEvent", + "kind": "method", + "line_display": "683-701", + "line_start": 683, + "line_end": 701, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "[GỘP 2 lượt quét trùng ký hiệu] (dòng 683-700, target gốc=presentation/co4e/co4e_canvas_widget.py) cắt ngang lát — cần agent gộp đối chiếu (thân try chưa đóng ở dòng 700, còn tiếp; xử lý JSON từ mimeData trong bộ nhớ, không phải file đĩa nên touches_disk_or_network=false) || (dòng 683-701, target gốc=presentation/co4e/co4e_canvas_widget.py) cắt ngang lát — cần agent gộp đối chiếu. Method dropEvent bắt đầu ở dòng 683 (ngoài khoảng được giao 701-791), chỉ dòng 701 (e.acceptProposedAction()) nằm trong lát này; dòng 702 là dòng trống cuối file. File ui/co4e_canvas.py chỉ có 702 dòng — không có nội dung nào khác trong khoảng 702-791 vì đã hết file. Xử lý drop từ sidebar (kind=='workflow' → add_workflow, ngược lại → add_palette_step) — logic thao tác node/canvas nên khớp nhóm _add_node/_connect_nodes trong bảng plan.md dòng 623 dù plan.md không liệt kê rõ dropEvent.", + "in_old_table": "co", + "old_table_mismatch": "nnect_nodes trong bảng plan.md dòng 623 dù plan.md không liệt kê rõ dropEvent.", + "merged_from_raw_indices": [ + 313, + 314 + ] + }, + { + "symbol": "Co4ETab.canvas", + "kind": "attribute", + "line_display": "856", + "line_start": 856, + "line_end": 856, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "TRẠNG THÁI CHIA SẺ lớn nhất trong file — self.canvas được đọc/ghi ở gần như mọi nhóm chức năng khác (sync_wf_from_canvas, apply_workflow, node selection, run, add_blank_step...).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 100 + ] + }, + { + "symbol": "Co4ETab._build_canvas_overlay", + "kind": "method", + "line_display": "1041-1062", + "line_start": 1041, + "line_end": 1062, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "dựng nút zoom/fit gắn vào self.canvas.add_overlay(bar); các slot gọi thẳng self.canvas.zoom_in/zoom_out/fit_view (thuộc nhóm 3.2.2.21-22 trong plan.md → co4e_canvas_widget.py). Có thể tranh cãi nên giữ ở co4e_tab.py (được gọi từ _build_center) — ghi lại để người soát quyết.", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 124 + ] + }, + { + "symbol": "Co4ETab.zoom_in_btn", + "kind": "attribute", + "line_display": "1054", + "line_start": 1054, + "line_end": 1054, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 125 + ] + }, + { + "symbol": "Co4ETab.zoom_out_btn", + "kind": "attribute", + "line_display": "1055", + "line_start": 1055, + "line_end": 1055, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 126 + ] + }, + { + "symbol": "Co4ETab.fit_btn", + "kind": "attribute", + "line_display": "1056", + "line_start": 1056, + "line_end": 1056, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_canvas_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 127 + ] + }, + { + "symbol": "_skill_names", + "kind": "function", + "line_display": "61-65", + "line_start": 61, + "line_end": 65, + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "gọi skills_mod.list_skills()/builtin_skills() (đọc đĩa); dùng cho autocomplete /skill: trong _ChatInput — cũng liên quan skills_list_panel.py vì cùng nguồn dữ liệu", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 2 + ] + }, + { + "symbol": "_agent_names", + "kind": "function", + "line_display": "68-71", + "line_start": 68, + "line_end": 71, + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "gọi co4e.list_custom_agents() (đọc đĩa); dùng cho autocomplete /agent: trong _ChatInput — cũng liên quan agent_list_panel.py vì cùng nguồn dữ liệu", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 3 + ] + }, + { + "symbol": "_directive_token", + "kind": "function", + "line_display": "122-134", + "line_start": 122, + "line_end": 134, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "logic regex thuần Python, test được không cần Qt", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 12 + ] + }, + { + "symbol": "_ChatInput", + "kind": "class", + "line_display": "137-226", + "line_start": 137, + "line_end": 226, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "khai báo 'submit = Signal()' ở dòng 141 là thuộc tính lớp (không phải self.)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 13 + ] + }, + { + "symbol": "_ChatInput.__init__", + "kind": "method", + "line_display": "143-151", + "line_start": 143, + "line_end": 151, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 14 + ] + }, + { + "symbol": "_ChatInput._popup", + "kind": "attribute", + "line_display": "145", + "line_start": 145, + "line_end": 145, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "QListWidget popup autocomplete", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 15 + ] + }, + { + "symbol": "_ChatInput._maybe_popup", + "kind": "method", + "line_display": "153-178", + "line_start": 153, + "line_end": 178, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 16 + ] + }, + { + "symbol": "_ChatInput._add_row", + "kind": "method", + "line_display": "180-184", + "line_start": 180, + "line_end": 184, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 17 + ] + }, + { + "symbol": "_ChatInput._accept", + "kind": "method", + "line_display": "186-199", + "line_start": 186, + "line_end": 199, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 18 + ] + }, + { + "symbol": "_ChatInput.focusOutEvent", + "kind": "method", + "line_display": "201-204", + "line_start": 201, + "line_end": 204, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 19 + ] + }, + { + "symbol": "_ChatInput.keyPressEvent", + "kind": "method", + "line_display": "206-226", + "line_start": 206, + "line_end": 226, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 20 + ] + }, + { + "symbol": "Co4ETab._chat_worker", + "kind": "attribute", + "line_display": "236", + "line_start": 236, + "line_end": 236, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "AgentWorker của chat, hiện giữ trên Co4ETab", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 25 + ] + }, + { + "symbol": "Co4ETab._build_chat", + "kind": "method", + "line_display": "1064-1127", + "line_start": 1064, + "line_end": 1127, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "dài ~63 dòng, gộp: header 'Messages' + toggle, chat_stack (QStackedWidget chứa 1 ChatView/flow), input row + usage label + composer + routing toggle. Tạo self._flow_logs (Dict[str, ChatView]) — TRẠNG THÁI CHIA SẺ dùng bởi _ensure_flow_log/_active_log/chat_log/_apply_workflow (self._wf) — điểm dễ vỡ nhất khi tách file chat ra khỏi co4e_tab.py.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 128 + ] + }, + { + "symbol": "Co4ETab._chat_widget", + "kind": "attribute", + "line_display": "1066", + "line_start": 1066, + "line_end": 1066, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 129 + ] + }, + { + "symbol": "Co4ETab._mhdr", + "kind": "attribute", + "line_display": "1072", + "line_start": 1072, + "line_end": 1072, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 130 + ] + }, + { + "symbol": "Co4ETab.msgs_icon", + "kind": "attribute", + "line_display": "1074", + "line_start": 1074, + "line_end": 1074, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 131 + ] + }, + { + "symbol": "Co4ETab.msgs_title", + "kind": "attribute", + "line_display": "1075", + "line_start": 1075, + "line_end": 1075, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 132 + ] + }, + { + "symbol": "Co4ETab.chat_toggle_btn", + "kind": "attribute", + "line_display": "1076", + "line_start": 1076, + "line_end": 1076, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 133 + ] + }, + { + "symbol": "Co4ETab.chat_stack", + "kind": "attribute", + "line_display": "1091", + "line_start": 1091, + "line_end": 1091, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "chuyển self.center_stack tương tự — dùng chung với self.center_stack (co4e_tab.py).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 134 + ] + }, + { + "symbol": "Co4ETab._flow_logs", + "kind": "attribute", + "line_display": "1092", + "line_start": 1092, + "line_end": 1092, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "Dict[str, ChatView] keyed theo workflow id — TRẠNG THÁI CHIA SẺ chính của toàn bộ logic chat theo-flow; đọc/ghi bởi _ensure_flow_log, _active_log, chat_log, _apply_workflow, và các hàm chat khác ngoài phạm vi đọc (>1400).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 135 + ] + }, + { + "symbol": "Co4ETab.chat_input_row", + "kind": "attribute", + "line_display": "1094", + "line_start": 1094, + "line_end": 1094, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 136 + ] + }, + { + "symbol": "Co4ETab._usage_total_lbl", + "kind": "attribute", + "line_display": "1099", + "line_start": 1099, + "line_end": 1099, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 137 + ] + }, + { + "symbol": "Co4ETab.chat_input", + "kind": "attribute", + "line_display": "1105", + "line_start": 1105, + "line_end": 1105, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 138 + ] + }, + { + "symbol": "Co4ETab.chat_send_btn", + "kind": "attribute", + "line_display": "1108", + "line_start": 1108, + "line_end": 1108, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 139 + ] + }, + { + "symbol": "Co4ETab.co4e_routing_toggle", + "kind": "attribute", + "line_display": "1113", + "line_start": 1113, + "line_end": 1113, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "RoutingToggle(self.ctx, 'co4e') — self.ctx là trạng thái chia sẻ của cả Co4ETab (khởi tạo ngoài phạm vi đọc).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 140 + ] + }, + { + "symbol": "Co4ETab._co4e_routed_provider", + "kind": "attribute", + "line_display": "1114; 1853", + "line_start": 1114, + "line_end": 1853, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "[GỘP 2 lượt quét trùng ký hiệu] (dòng 1114-1114, target gốc=presentation/co4e/co4e_chat_view.py) override provider cho lượt chat kế tiếp — dùng bởi _apply_co4e_routing (ngoài phạm vi đọc, >1400). || (dòng 1853-1853, target gốc=presentation/co4e/co4e_chat_view.py) gán None lần đầu tại đây (trong _apply_co4e_routing); đọc bằng getattr(self, '_co4e_routed_provider', None) ở _run_chat_turn dòng ~1922 — gợi ý có thể không được init trong __init__. Trạng thái routing theo từng lượt chat, dùng chung giữa chat-view và _start_canvas_run/manager.start.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "[GỘP 2 lượt quét trùng ký hiệu] (dòng 1114-1114, target gốc=presentation/co4e/co4e_chat_view.py) overr", + "merged_from_raw_indices": [ + 141, + 204 + ] + }, + { + "symbol": "Co4ETab._vsplit_sizes", + "kind": "attribute", + "line_display": "1121", + "line_start": 1121, + "line_end": 1121, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "dùng bởi _toggle_messages để restore kích thước splitter — chia sẻ với self._vsplit (co4e_tab.py).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 142 + ] + }, + { + "symbol": "Co4ETab._msgs_collapsed", + "kind": "attribute", + "line_display": "1122", + "line_start": 1122, + "line_end": 1122, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 143 + ] + }, + { + "symbol": "Co4ETab._toggle_messages", + "kind": "method", + "line_display": "1129-1161", + "line_start": 1129, + "line_end": 1161, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "thao tác self._vsplit (tạo ở co4e_tab.py/_build_center) — trạng thái chia sẻ giữa co4e_chat_view.py và co4e_tab.py.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 144 + ] + }, + { + "symbol": "Co4ETab._ensure_flow_log", + "kind": "method", + "line_display": "1164-1173", + "line_start": 1164, + "line_end": 1173, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "đọc/ghi self._flow_logs — trạng thái chia sẻ chính của chat theo-flow.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 145 + ] + }, + { + "symbol": "Co4ETab._active_log", + "kind": "method", + "line_display": "1175-1177", + "line_start": 1175, + "line_end": 1177, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "đọc self._wf — trạng thái chia sẻ với toàn bộ Co4ETab (canvas, sidebar, save/autosave, run control).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 146 + ] + }, + { + "symbol": "Co4ETab.chat_log", + "kind": "method", + "line_display": "1180-1183", + "line_start": 1180, + "line_end": 1183, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "@property, chỉ đọc, uỷ nhiệm cho _active_log().", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 147 + ] + }, + { + "symbol": "Co4ETab._plan_bubble", + "kind": "method", + "line_display": "1186-1187", + "line_start": 1186, + "line_end": 1187, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "@property getter, đọc self._active_log()._co4e_plan_bubble (thuộc tính gắn thêm vào từng instance ChatView).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 148 + ] + }, + { + "symbol": "Co4ETab._plan_bubble (setter)", + "kind": "method", + "line_display": "1189-1191", + "line_start": 1189, + "line_end": 1191, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "@_plan_bubble.setter, ghi self._active_log()._co4e_plan_bubble.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 149 + ] + }, + { + "symbol": "Co4ETab._chat_send", + "kind": "method", + "line_display": "1820-1846", + "line_start": 1820, + "line_end": 1846, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "self.chat_input.clear(), self._append_chat — thao tác widget; điều phối /agent /skill directive rồi gọi self._run_chat_turn (network qua provider, không trực tiếp trong hàm này)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 202 + ] + }, + { + "symbol": "Co4ETab._apply_co4e_routing", + "kind": "method", + "line_display": "1848-1883", + "line_start": 1848, + "line_end": 1883, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "gọi confirm_switch (dialog Qt) khi mode=='manual' và self._append_chat khi có switch — cần widget sống. Gán self._co4e_routed_provider (xem attribute riêng).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 203 + ] + }, + { + "symbol": "Co4ETab._extract_agent_directive", + "kind": "method", + "line_display": "1885-1891", + "line_start": 1885, + "line_end": 1891, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "regex thuần Python", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 205 + ] + }, + { + "symbol": "Co4ETab._resolve_agent", + "kind": "method", + "line_display": "1893-1901", + "line_start": 1893, + "line_end": 1901, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "tra cứu BUILTIN_AGENTS và co4e.list_custom_agents() (bộ nhớ/đĩa tùy triển khai list_custom_agents, không rõ trong khoảng đọc) — cross-reference với agent_list_panel.py (nguồn danh sách custom agent)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 206 + ] + }, + { + "symbol": "Co4ETab._run_chat_turn", + "kind": "method", + "line_display": "1903-1974", + "line_start": 1903, + "line_end": 1974, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "72 dòng, gộp: chuẩn bị prompt, tạo bubble stream, định nghĩa 4 closures nội bộ (job/on_event/done/failed) và khởi worker nền — nên tách các closures ra thành hàm riêng nếu dễ đọc hơn. Closure job() gọi run_cowork(provider,...) — network/AI call thật sự. Đọc/ghi self._chat_worker, self._co4e_routed_provider, self.chat_send_btn, self._wf; set log._co4e_plan_bubble=None (thuộc log là ChatView, không phải self).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 207 + ] + }, + { + "symbol": "Co4ETab._run_chat_turn.job", + "kind": "function", + "line_display": "1917-1946", + "line_start": 1917, + "line_end": 1946, + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "closure nội bộ của _run_chat_turn, chạy trong AgentWorker (thread nền); gọi run_cowork(provider,...) — network/AI call thật; dùng usage_tracker (đọc/ghi trạng thái tích lũy usage)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 208 + ] + }, + { + "symbol": "Co4ETab._run_chat_turn.on_event", + "kind": "function", + "line_display": "1948-1954", + "line_start": 1948, + "line_end": 1954, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "closure nội bộ, cập nhật assistant.set_markdown và log.scroll_to_bottom (widget)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 209 + ] + }, + { + "symbol": "Co4ETab._run_chat_turn.done", + "kind": "function", + "line_display": "1956-1962", + "line_start": 1956, + "line_end": 1962, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "closure nội bộ, gán self._chat_worker = None, thao tác widget assistant/log", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 210 + ] + }, + { + "symbol": "Co4ETab._run_chat_turn.failed", + "kind": "function", + "line_display": "1964-1967", + "line_start": 1964, + "line_end": 1967, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "closure nội bộ, gán self._chat_worker = None, gọi self._append_chat lỗi", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 211 + ] + }, + { + "symbol": "Co4ETab._append_chat", + "kind": "method", + "line_display": "1976-1991", + "line_start": 1976, + "line_end": 1991, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "nhận tham số log tùy chọn, mặc định self.chat_log — dùng bởi rất nhiều method ở cả run-control (qua tham số log truyền vào) và chat-view; điểm nối giữa hai nhóm.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 212 + ] + }, + { + "symbol": "Co4ETab._fmt_usage", + "kind": "method", + "line_display": "1994-2001", + "line_start": 1994, + "line_end": 2001, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "format chuỗi thuần, đọc self.ctx.config.data — không chạm widget", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 213 + ] + }, + { + "symbol": "Co4ETab._apply_usage", + "kind": "method", + "line_display": "2003-2020", + "line_start": 2003, + "line_end": 2020, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "bub.add_usage(...) thao tác widget bubble; ghi self._flow_usage[wf_id] — trạng thái tổng usage theo flow, dùng chung với _refresh_usage_total", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 214 + ] + }, + { + "symbol": "Co4ETab._refresh_usage_total", + "kind": "method", + "line_display": "2022-2037", + "line_start": 2022, + "line_end": 2037, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "self._usage_total_lbl.setText — đọc self._wf, self._flow_usage", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 215 + ] + }, + { + "symbol": "Co4ETab._append_diff", + "kind": "method", + "line_display": "2039-2043", + "line_start": 2039, + "line_end": 2043, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 216 + ] + }, + { + "symbol": "Co4ETab._append_plan", + "kind": "method", + "line_display": "2045-2056", + "line_start": 2045, + "line_end": 2056, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "đọc/ghi log._co4e_plan_bubble (thuộc tính động trên đối tượng log/ChatView, không phải self)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 217 + ] + }, + { + "symbol": "_html_escape", + "kind": "function", + "line_display": "2082-2083", + "line_start": 2082, + "line_end": 2083, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_chat_view.py", + "note": "hàm module-level (ngoài class Co4ETab), escape HTML thuần, dùng cho hiển thị chat", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 219 + ] + }, + { + "symbol": "_PLAN_GLYPH", + "kind": "attribute", + "line_display": "45-46", + "line_start": 45, + "line_end": 46, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "module-level dict glyph trạng thái dùng bởi _fmt_plan", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 0 + ] + }, + { + "symbol": "_fmt_plan", + "kind": "function", + "line_display": "49-58", + "line_start": 49, + "line_end": 58, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "helper thuần Python dùng bởi _render_plan()", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 1 + ] + }, + { + "symbol": "Co4ETab.manager", + "kind": "attribute", + "line_display": "238", + "line_start": 238, + "line_end": 238, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "Co4ERunManager — lõi run control, trạng thái chia sẻ với canvas (node status) và chat view (run_logs)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 26 + ] + }, + { + "symbol": "Co4ETab._flow_runs", + "kind": "attribute", + "line_display": "243", + "line_start": 243, + "line_end": 243, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "map wf_id->run id, chia sẻ với _open_flow/_close_flow_tab (co4e_tab.py) và canvas", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 27 + ] + }, + { + "symbol": "Co4ETab._run_logs", + "kind": "attribute", + "line_display": "244", + "line_start": 244, + "line_end": 244, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "map run_id->ChatView, chia sẻ với co4e_chat_view.py", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 28 + ] + }, + { + "symbol": "Co4ETab._flow_usage", + "kind": "attribute", + "line_display": "248", + "line_start": 248, + "line_end": 248, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "usage token/cost theo flow, hiển thị ở Messages header", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 30 + ] + }, + { + "symbol": "Co4ETab._manual_active", + "kind": "attribute", + "line_display": "252", + "line_start": 252, + "line_end": 252, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "chia sẻ với _close_flow_tab (co4e_tab.py) — set lại self.run_btn khi đóng tab", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 33 + ] + }, + { + "symbol": "Co4ETab._manual_order", + "kind": "attribute", + "line_display": "253", + "line_start": 253, + "line_end": 253, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 34 + ] + }, + { + "symbol": "Co4ETab._manual_idx", + "kind": "attribute", + "line_display": "254", + "line_start": 254, + "line_end": 254, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 35 + ] + }, + { + "symbol": "Co4ETab._cur_run_id", + "kind": "method", + "line_display": "460-473", + "line_start": 460, + "line_end": 473, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "logic thuần Python, không gọi Qt trực tiếp", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 53 + ] + }, + { + "symbol": "Co4ETab._update_run_btn", + "kind": "method", + "line_display": "480-482", + "line_start": 480, + "line_end": 482, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 55 + ] + }, + { + "symbol": "Co4ETab.runs_more_btn", + "kind": "attribute", + "line_display": "586", + "line_start": 586, + "line_end": 586, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 76 + ] + }, + { + "symbol": "Co4ETab.runs_side_list", + "kind": "attribute", + "line_display": "594", + "line_start": 594, + "line_end": 594, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 77 + ] + }, + { + "symbol": "Co4ETab._SIDE_RUNS", + "kind": "attribute", + "line_display": "605", + "line_start": 605, + "line_end": 605, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "class-level constant, không phải self.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 78 + ] + }, + { + "symbol": "Co4ETab._refresh_side_runs", + "kind": "method", + "line_display": "607-619", + "line_start": 607, + "line_end": 619, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 79 + ] + }, + { + "symbol": "Co4ETab._on_side_run_clicked", + "kind": "method", + "line_display": "621-629", + "line_start": 621, + "line_end": 629, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "chạm self.runs_table (định nghĩa ngoài khoảng đọc — thuộc trang Flow Status)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 80 + ] + }, + { + "symbol": "Co4ETab.mode_combo", + "kind": "attribute", + "line_display": "828", + "line_start": 828, + "line_end": 828, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "combo chọn run mode auto/plan/manual — thuộc nhóm _set_run_mode() trong plan.md dù được dựng bên trong _build_center (co4e_tab.py); ranh giới tách file ở đây dễ vỡ.", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 97 + ] + }, + { + "symbol": "Co4ETab.run_btn", + "kind": "attribute", + "line_display": "833", + "line_start": 833, + "line_end": 833, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "nút Run — tương tự mode_combo, dựng trong _build_center nhưng thuộc nhóm run control; cũng bị _update_run_btn (<701), _on_run_clicked, _on_mode_changed đọc/ghi text.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 98 + ] + }, + { + "symbol": "Co4ETab.runs_btn", + "kind": "attribute", + "line_display": "840", + "line_start": 840, + "line_end": 840, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "toggle chuyển sang trang Runs (self.center_stack) — chia sẻ state center_stack với co4e_tab.py.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 99 + ] + }, + { + "symbol": "Co4ETab._build_runs_page", + "kind": "method", + "line_display": "873-932", + "line_start": 873, + "line_end": 932, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "dựng trang bảng Runs (theo dõi mọi run của mọi flow) — dùng self.manager (Co4ERunManager, sẽ thay bằng co4e_workflow_service) — trạng thái chia sẻ.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 102 + ] + }, + { + "symbol": "Co4ETab.runs_back_btn", + "kind": "attribute", + "line_display": "882", + "line_start": 882, + "line_end": 882, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 103 + ] + }, + { + "symbol": "Co4ETab.runs_title", + "kind": "attribute", + "line_display": "887", + "line_start": 887, + "line_end": 887, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 104 + ] + }, + { + "symbol": "Co4ETab.ws_folder_btn", + "kind": "attribute", + "line_display": "892", + "line_start": 892, + "line_end": 892, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 105 + ] + }, + { + "symbol": "Co4ETab.run_stop_btn", + "kind": "attribute", + "line_display": "900", + "line_start": 900, + "line_end": 900, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 106 + ] + }, + { + "symbol": "Co4ETab.run_rename_btn", + "kind": "attribute", + "line_display": "905", + "line_start": 905, + "line_end": 905, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 107 + ] + }, + { + "symbol": "Co4ETab.run_del_btn", + "kind": "attribute", + "line_display": "909", + "line_start": 909, + "line_end": 909, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 108 + ] + }, + { + "symbol": "Co4ETab.run_clear_btn", + "kind": "attribute", + "line_display": "913", + "line_start": 913, + "line_end": 913, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "clicked gọi self.manager.clear_finished() — trạng thái chia sẻ self.manager.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 109 + ] + }, + { + "symbol": "Co4ETab.runs_table", + "kind": "attribute", + "line_display": "921", + "line_start": 921, + "line_end": 921, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 110 + ] + }, + { + "symbol": "Co4ETab._current_mode", + "kind": "method", + "line_display": "1384-1385", + "line_start": 1384, + "line_end": 1385, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "đọc self.mode_combo — khớp nhóm _set_run_mode() dòng 624 plan.md.", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 172 + ] + }, + { + "symbol": "Co4ETab._on_mode_changed", + "kind": "method", + "line_display": "1387-1393", + "line_start": 1387, + "line_end": 1393, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "reset self._manual_active/_manual_order/_manual_idx (trạng thái chia sẻ với luồng manual step _manual_step/_manual_run_or_advance, ngoài phạm vi đọc >1400) và gọi self._cur_run_id() (chia sẻ với self.manager).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 173 + ] + }, + { + "symbol": "Co4ETab._on_run_clicked", + "kind": "method", + "line_display": "1395-1400", + "line_start": 1395, + "line_end": 1400, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "cắt ngang lát — cần agent gộp đối chiếu (tiếp tục sau dòng 1400). Dùng self.manager.stop() và self._cur_run_id() — trạng thái chia sẻ với co4e_workflow_service tương lai. Khớp nhóm _run_flow()/_stop_flow() dòng 618 plan.md (dù đó là bản service, đây là UI handler nút Run).", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 174 + ] + }, + { + "symbol": "Co4ETab.", + "kind": "method", + "line_display": "1401-1405", + "line_start": 1401, + "line_end": 1405, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "cắt ngang lát — cần agent gộp đối chiếu. Định nghĩa (def ...) nằm ở lát trước dòng 1401 nên tên chính xác không xác định được; đoạn thấy được chỉ dispatch theo self._current_mode() sang _manual_run_or_advance() hoặc _start_canvas_run() — thuộc nhóm Run/mode.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "(def ...) nằm ở lát trước dòng 1401 nên tên chính xác không xác định được; đoạn thấy được chỉ dispatch theo self._current_mode() sang _manual_run_or", + "merged_from_raw_indices": [ + 175 + ] + }, + { + "symbol": "Co4ETab._start_canvas_run", + "kind": "method", + "line_display": "1407-1424", + "line_start": 1407, + "line_end": 1424, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "gọi self.manager.start(...) — spawn chạy flow (dẫn tới gọi provider AI ở tầng khác); đọc/ghi self._wf, self._flow_runs, self._flow_runs[wf_id], self._run_logs, self.chat_log — trạng thái chia sẻ giữa run-control và chat-view. self.manager (Co4ERunManager) nên đổi sang application/workflows/co4e_workflow_service.py theo mapping.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 176 + ] + }, + { + "symbol": "Co4ETab._run_single", + "kind": "method", + "line_display": "1426-1431", + "line_start": 1426, + "line_end": 1431, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "wrapper mỏng gọi _start_canvas_run; đọc self._wf.id", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 177 + ] + }, + { + "symbol": "Co4ETab._run_from", + "kind": "method", + "line_display": "1433-1437", + "line_start": 1433, + "line_end": 1437, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "wrapper mỏng gọi _start_canvas_run với self._downstream(node_id)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 178 + ] + }, + { + "symbol": "Co4ETab._downstream", + "kind": "method", + "line_display": "1439-1450", + "line_start": 1439, + "line_end": 1450, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "thuật toán BFS thuần Python, chỉ đọc self.canvas.edges() làm input — test được với danh sách edge giả lập, không cần canvas thật", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 179 + ] + }, + { + "symbol": "Co4ETab._manual_run_or_advance", + "kind": "method", + "line_display": "1453-1466", + "line_start": 1453, + "line_end": 1466, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "gọi self.canvas.reset_statuses() và self._append_chat (self._append_chat thuộc nhóm chat-view) — cắt ngang giữa run-control và chat-view. Đọc/ghi self._manual_active, self._manual_order, self._manual_idx, self._wf, self._outputs_for(...), self._plan_bubble — trạng thái run thuần túy chia sẻ với _manual_step.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 180 + ] + }, + { + "symbol": "Co4ETab._manual_step", + "kind": "method", + "line_display": "1468-1484", + "line_start": 1468, + "line_end": 1484, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "gọi self.manager.start(...) (network/AI qua provider) và self.run_btn.setText, self._append_chat (chat-view); đọc/ghi self._manual_idx, self._manual_order, self._wf, self._flow_runs, self._run_logs, self.chat_log — trạng thái chia sẻ rộng giữa run-control và chat-view.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 181 + ] + }, + { + "symbol": "Co4ETab._topo_order", + "kind": "method", + "line_display": "1486-1491", + "line_start": 1486, + "line_end": 1491, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "đọc self.canvas.nodes()/edges() làm dữ liệu đầu vào, logic tính toán thuần túy (co4e.compute_waves) — test được với dữ liệu giả", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 182 + ] + }, + { + "symbol": "Co4ETab._on_manager_event", + "kind": "method", + "line_display": "1494-1550", + "line_start": 1494, + "line_end": 1550, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "method dài (57 dòng), gộp nhiều việc không liên quan: định tuyến sự kiện chạy theo từng flow (routing run_id -> log), cập nhật trạng thái node trên canvas, hiển thị bubble chat (assistant/diff/plan/tool-failed — thuộc co4e_chat_view.py), xử lý hoàn tất run (run_done/run_error), hiển thị popup thông báo, cập nhật status bar. Nên tách phần hiển thị chat (self._append_chat/_append_diff/_append_plan) sang co4e_chat_view.py, giữ phần routing/flow-completion ở co4e_run_control_widget.py. Đọc/ghi self._flow_runs, self._run_logs, self.chat_log, self.canvas, self._wf, self._outputs_for(...), self._manual_active, self._manual_idx — trạng thái chia sẻ rất rộng, điểm dễ vỡ nhất khi tách file.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 183 + ] + }, + { + "symbol": "Co4ETab._notify_run_finished", + "kind": "method", + "line_display": "1552-1573", + "line_start": 1552, + "line_end": 1573, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "tạo QMessageBox không chặn; khởi tạo lazy self._run_popups (xem attribute riêng)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 184 + ] + }, + { + "symbol": "Co4ETab._run_popups", + "kind": "attribute", + "line_display": "1560-1561", + "line_start": 1560, + "line_end": 1561, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "khởi tạo lazy (list rỗng) trong _notify_run_finished qua hasattr guard — không init trong __init__; giữ ref các QMessageBox non-blocking khỏi bị GC", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 185 + ] + }, + { + "symbol": "Co4ETab._refresh_runs", + "kind": "method", + "line_display": "1575-1616", + "line_start": 1575, + "line_end": 1616, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "render bảng runs_table + gọi self._refresh_side_runs() (sidebar) + cập nhật self.flow_bar.setTabText và self._sections['co4e.runs_tab'] — self._sections và self.flow_bar là trạng thái chia sẻ với co4e_tab.py (container/sidebar).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 186 + ] + }, + { + "symbol": "Co4ETab._stop_selected_run", + "kind": "method", + "line_display": "1618-1624", + "line_start": 1618, + "line_end": 1624, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 187 + ] + }, + { + "symbol": "Co4ETab._delete_selected_run", + "kind": "method", + "line_display": "1626-1639", + "line_start": 1626, + "line_end": 1639, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "đọc/ghi self._flow_runs, self._run_logs — trạng thái chia sẻ với _on_manager_event/_start_canvas_run", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 188 + ] + }, + { + "symbol": "Co4ETab._runs_context_menu", + "kind": "method", + "line_display": "1641-1655", + "line_start": 1641, + "line_end": 1655, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 189 + ] + }, + { + "symbol": "Co4ETab._open_run_output_folder", + "kind": "method", + "line_display": "1704-1715", + "line_start": 1704, + "line_end": 1715, + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "path.mkdir + open_location (spawn process); dùng bởi _runs_context_menu 'Open output'", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 194 + ] + }, + { + "symbol": "Co4ETab._rename_selected_run", + "kind": "method", + "line_display": "1717-1748", + "line_start": 1717, + "line_end": 1748, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "gọi co4e.save_workflow(wf) (ghi đĩa); đọc/ghi self._flows (list flow của sidebar/tab-bar), self.flow_bar, self.name_edit, self._wf — chạm nhiều trạng thái chia sẻ với co4e_tab.py container (tab bar + name edit thuộc header, không rõ nằm ở panel nào) — rủi ro vỡ cao khi tách.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 195 + ] + }, + { + "symbol": "Co4ETab._run_selected_in_background", + "kind": "method", + "line_display": "1750-1760", + "line_start": 1750, + "line_end": 1760, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "gọi self.manager.start(...) (network/AI) và self._refresh_side_runs() (widget)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 196 + ] + }, + { + "symbol": "Co4ETab._wf_by_id", + "kind": "method", + "line_display": "1762-1770", + "line_start": 1762, + "line_end": 1770, + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "gọi co4e.get_workflow(wf_id) (đọc đĩa) và self._sync_wf_from_canvas() (không nằm trong khoảng đọc) — đọc self._wf; dùng chung bởi _rerun_run_item/_open_run_from_table (Runs tab) và có thể cả co4e_tab.py container", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 197 + ] + }, + { + "symbol": "Co4ETab._rerun_run_item", + "kind": "method", + "line_display": "1772-1783", + "line_start": 1772, + "line_end": 1783, + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "gọi self.manager.start(...) (network/AI)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 198 + ] + }, + { + "symbol": "Co4ETab._open_run_from_table", + "kind": "method", + "line_display": "1785-1804", + "line_start": 1785, + "line_end": 1804, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "gọi self._open_flow(wf) (không nằm trong khoảng đọc, theo plan.md thuộc co4e_tab.py) và self.canvas.update_node_status — nối Runs tab với việc mở flow trên canvas, điểm khớp nối giữa run-control và container/canvas.", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 199 + ] + }, + { + "symbol": "_qcolor", + "kind": "function", + "line_display": "2086-2088", + "line_start": 2086, + "line_end": 2088, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_run_control_widget.py", + "note": "hàm module-level (ngoài class Co4ETab), tạo QColor từ hex string — dùng kiểu giá trị QColor, không cần QApplication sống; dùng trong _refresh_runs để tô màu status", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 220 + ] + }, + { + "symbol": "_EqualTabBar", + "kind": "class", + "line_display": "74-94", + "line_start": 74, + "line_end": 94, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 4 + ] + }, + { + "symbol": "_EqualTabBar._GAP", + "kind": "attribute", + "line_display": "80", + "line_start": 80, + "line_end": 80, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "class-level constant, không phải self.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 5 + ] + }, + { + "symbol": "_EqualTabBar.tabSizeHint", + "kind": "method", + "line_display": "82-90", + "line_start": 82, + "line_end": 90, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 6 + ] + }, + { + "symbol": "_EqualTabBar.resizeEvent", + "kind": "method", + "line_display": "92-94", + "line_start": 92, + "line_end": 94, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 7 + ] + }, + { + "symbol": "Co4ETab", + "kind": "class", + "line_display": "229-700", + "line_start": 229, + "line_end": 700, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "Lớp kéo dài quá dòng 700 (cắt ngang lát) — chỉ ghi nhận phần 229-700; 'status_message = Signal(str)' dòng 230 là thuộc tính lớp, không phải self.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 21 + ] + }, + { + "symbol": "Co4ETab.__init__", + "kind": "method", + "line_display": "232-304", + "line_start": 232, + "line_end": 304, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "method 73 dòng, gộp: khởi state run/flow, dựng splitter 3 cột (sidebar/center/config), wiring canvas & config panel, gọi _reload_sidebar (đọc đĩa qua co4e.list_workflows) và _open_flow; chạm rất nhiều thuộc tính chia sẻ: self._wf, self._flows, self.manager, self._flow_runs, self._run_logs, self._flow_outputs, self._flow_usage, self.config, self.canvas (gán ở _build_center ngoài khoảng đọc này)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 22 + ] + }, + { + "symbol": "Co4ETab.ctx", + "kind": "attribute", + "line_display": "234", + "line_start": 234, + "line_end": 234, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 23 + ] + }, + { + "symbol": "Co4ETab._wf", + "kind": "attribute", + "line_display": "235", + "line_start": 235, + "line_end": 235, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "trạng thái chia sẻ — đọc/ghi bởi canvas, run control, chat view", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 24 + ] + }, + { + "symbol": "Co4ETab._flows", + "kind": "attribute", + "line_display": "257", + "line_start": 257, + "line_end": 257, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "danh sách flow đang mở dạng tab — trạng thái chia sẻ nhạy cảm (nêu rõ trong hướng dẫn đề bài)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 36 + ] + }, + { + "symbol": "Co4ETab._active_flow_idx", + "kind": "attribute", + "line_display": "258", + "line_start": 258, + "line_end": 258, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "chỉ số tab đang active — chia sẻ giữa _open_flow, _on_flow_tab_changed, _reflect_active_run", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 37 + ] + }, + { + "symbol": "Co4ETab._split", + "kind": "attribute", + "line_display": "261", + "line_start": 261, + "line_end": 261, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 38 + ] + }, + { + "symbol": "Co4ETab._config_collapsed", + "kind": "attribute", + "line_display": "274", + "line_start": 274, + "line_end": 274, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "trạng thái cho _toggle_config (định nghĩa dòng 989, ngoài khoảng đọc); plan.md xếp _toggle_config ở co4e_tab.py container", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 40 + ] + }, + { + "symbol": "Co4ETab._config_expanded_w", + "kind": "attribute", + "line_display": "275; 995", + "line_start": 275, + "line_end": 995, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "[GỘP 2 lượt quét trùng ký hiệu] (dòng 275-275, target gốc=presentation/co4e/co4e_tab.py) cùng lý do với _config_collapsed || (dòng 995-995, target gốc=presentation/co4e/co4e_tab.py) gán trong nhánh collapse của _toggle_config; có thể đã khởi tạo trong __init__ (ngoài phạm vi đọc).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "[GỘP 2 lượt quét trùng ký hiệu] (dòng 275-275, target gốc=presentation/co4e/co4e_tab.py) cùng lý do vớ", + "merged_from_raw_indices": [ + 41, + 122 + ] + }, + { + "symbol": "Co4ETab._narrow_guard", + "kind": "attribute", + "line_display": "280", + "line_start": 280, + "line_end": 280, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "gắn với _apply_narrow_layout (dòng 977, ngoài khoảng đọc)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 42 + ] + }, + { + "symbol": "Co4ETab._open_flow", + "kind": "method", + "line_display": "307-338", + "line_start": 307, + "line_end": 338, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "khớp plan.md: _open_flow() -> co4e_tab.py, gọi canvas; chạm self._flows, self.flow_bar (định nghĩa ngoài khoảng đọc), self.canvas", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 43 + ] + }, + { + "symbol": "Co4ETab._close_other_flows", + "kind": "method", + "line_display": "340-355", + "line_start": 340, + "line_end": 355, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 44 + ] + }, + { + "symbol": "Co4ETab._show_runs", + "kind": "method", + "line_display": "357-367", + "line_start": 357, + "line_end": 367, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "chuyển đổi center_stack giữa flow editor và Runs table — liên quan Flow Status (run control)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 45 + ] + }, + { + "symbol": "Co4ETab._on_flow_tab_changed", + "kind": "method", + "line_display": "369-385", + "line_start": 369, + "line_end": 385, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "chạm self.center_stack (định nghĩa ngoài khoảng đọc, ở _build_center)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 46 + ] + }, + { + "symbol": "Co4ETab._sync_runs_toggle", + "kind": "method", + "line_display": "387-394", + "line_start": 387, + "line_end": 394, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 47 + ] + }, + { + "symbol": "Co4ETab._add_tab_close_button", + "kind": "method", + "line_display": "396-406", + "line_start": 396, + "line_end": 406, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 48 + ] + }, + { + "symbol": "Co4ETab._close_flow_tab_button", + "kind": "method", + "line_display": "408-412", + "line_start": 408, + "line_end": 412, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 49 + ] + }, + { + "symbol": "Co4ETab._close_flow_tab", + "kind": "method", + "line_display": "414-442", + "line_start": 414, + "line_end": 442, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "chạm self._flow_runs/_run_logs/_manual_active/self.run_btn (chia sẻ với run control widget)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 50 + ] + }, + { + "symbol": "Co4ETab._sync_active_flow_tab_text", + "kind": "method", + "line_display": "444-447", + "line_start": 444, + "line_end": 447, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 51 + ] + }, + { + "symbol": "Co4ETab._build_sidebar", + "kind": "method", + "line_display": "485-603", + "line_start": 485, + "line_end": 603, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": ">80 dòng (119 dòng) — gộp dựng 4 section (Workflows/Agents/Skills/Runs) + wiring nhiều nút bấm; nên tách theo section: Workflows giữ ở container, Agents nên chuyển agent_list_panel.py, Skills đã tách (chỉ còn wiring), Runs nên chuyển co4e_run_control_widget.py", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 56 + ] + }, + { + "symbol": "Co4ETab._sections", + "kind": "attribute", + "line_display": "493", + "line_start": 493, + "line_end": 493, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "trạng thái chia sẻ (nêu rõ trong hướng dẫn đề bài) — dùng bởi _fold_section, _sync_section_arrow", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 60 + ] + }, + { + "symbol": "Co4ETab.sidebar", + "kind": "attribute", + "line_display": "494", + "line_start": 494, + "line_end": 494, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 61 + ] + }, + { + "symbol": "Co4ETab.side_split", + "kind": "attribute", + "line_display": "498", + "line_start": 498, + "line_end": 498, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 62 + ] + }, + { + "symbol": "_Col", + "kind": "class", + "line_display": "503-511", + "line_start": 503, + "line_end": 511, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "adapter nội bộ định nghĩa bên trong _build_sidebar, chỉ dùng tại chỗ", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 57 + ] + }, + { + "symbol": "_Col.__init__", + "kind": "method", + "line_display": "506-507", + "line_start": 506, + "line_end": 507, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 58 + ] + }, + { + "symbol": "_Col.addWidget", + "kind": "method", + "line_display": "509-511", + "line_start": 509, + "line_end": 511, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 59 + ] + }, + { + "symbol": "Co4ETab.wf_new_btn", + "kind": "attribute", + "line_display": "516", + "line_start": 516, + "line_end": 516, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 63 + ] + }, + { + "symbol": "Co4ETab.wf_list", + "kind": "attribute", + "line_display": "527", + "line_start": 527, + "line_end": 527, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 64 + ] + }, + { + "symbol": "Co4ETab.wf_edit_btn", + "kind": "attribute", + "line_display": "534", + "line_start": 534, + "line_end": 534, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 65 + ] + }, + { + "symbol": "Co4ETab.wf_dup_btn", + "kind": "attribute", + "line_display": "535", + "line_start": 535, + "line_end": 535, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 66 + ] + }, + { + "symbol": "Co4ETab.wf_del_btn", + "kind": "attribute", + "line_display": "536", + "line_start": 536, + "line_end": 536, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 67 + ] + }, + { + "symbol": "Co4ETab.wf_runbg_btn", + "kind": "attribute", + "line_display": "543", + "line_start": 543, + "line_end": 543, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 68 + ] + }, + { + "symbol": "Co4ETab._skills_panel", + "kind": "attribute", + "line_display": "575", + "line_start": 575, + "line_end": 575, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "instantiate SkillsListPanel đã tách; Co4ETab giữ wiring theo comment trong code (dòng 571-574)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 73 + ] + }, + { + "symbol": "Co4ETab.sk_manage_btn", + "kind": "attribute", + "line_display": "576", + "line_start": 576, + "line_end": 576, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "cùng lý do với _skills_panel", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 74 + ] + }, + { + "symbol": "Co4ETab.skill_list", + "kind": "attribute", + "line_display": "578", + "line_start": 578, + "line_end": 578, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "cùng lý do với _skills_panel", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 75 + ] + }, + { + "symbol": "Co4ETab._section", + "kind": "method", + "line_display": "631-663", + "line_start": 631, + "line_end": 663, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "chạm self._sections (chia sẻ) — helper dựng section sidebar dùng chung", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 81 + ] + }, + { + "symbol": "Co4ETab._fold_section", + "kind": "method", + "line_display": "665-677", + "line_start": 665, + "line_end": 677, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 82 + ] + }, + { + "symbol": "Co4ETab._sync_section_arrow", + "kind": "method", + "line_display": "679-681", + "line_start": 679, + "line_end": 681, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 83 + ] + }, + { + "symbol": "Co4ETab._icon_btn", + "kind": "method", + "line_display": "683-687", + "line_start": 683, + "line_end": 687, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "helper dùng chung tạo nút icon, dùng bởi cả section Workflows và Agents", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 84 + ] + }, + { + "symbol": "Co4ETab._reload_sidebar", + "kind": "method", + "line_display": "689-722", + "line_start": 689, + "line_end": 722, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "[GỘP 2 lượt quét trùng ký hiệu] (dòng 689-700, target gốc=presentation/co4e/co4e_tab.py) cắt ngang lát — cần agent gộp đối chiếu (method tiếp tục sau dòng 700); gọi co4e.list_workflows() (đọc đĩa) rồi dựng QListWidgetItem trực tiếp trong cùng hàm — trộn data-fetch và UI, nên tách phần đọc dữ liệu sang co4e_workflow_service.py || (dòng 689-722, target gốc=unsure) cắt ngang lát — cần agent gộp đối chiếu (bắt đầu trước dòng 701). Gộp refresh cả agent_list và skill_list trong cùng 1 hàm — nên tách thành _refresh_agents_list (agent_list_panel.py) và _refresh_skills_list (skills_list_panel.py) như plan.md yêu cầu; gọi co4e.list_custom_agents() (đĩa) và skills_mod.skill_prefix_for (đĩa).", + "in_old_table": "co", + "old_table_mismatch": "[GỘP 2 lượt quét trùng ký hiệu] (dòng 689-700, target gốc=presentation/co4e/co4e_tab.py) cắt ngang lát", + "merged_from_raw_indices": [ + 85, + 86 + ] + }, + { + "symbol": "Co4ETab._build_center", + "kind": "method", + "line_display": "731-871", + "line_start": 731, + "line_end": 871, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "dài ~140 dòng, làm nhiều việc không liên quan: dựng flow tab bar (ẩn, không hiển thị cho user), dựng runs-page stack, toolbar flow (name_edit/save/save_tpl/mode_combo/run_btn/runs_btn), tạo canvas, gọi _build_canvas_overlay, tạo chat widget, splitter dọc self._vsplit. Nên tách nhỏ. Đọc self._wf.name (dòng 814) và tạo self.center_stack — TRẠNG THÁI CHIA SẺ dùng bởi _show_runs/_apply_workflow (ngoài phạm vi đọc). Khớp phần '_build_canvas()' trong bảng plan.md dòng 615.", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 88 + ] + }, + { + "symbol": "Co4ETab.flow_bar", + "kind": "attribute", + "line_display": "738", + "line_start": 738, + "line_end": 738, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "QTabBar bị ẩn (setVisible False dòng 802), chỉ dùng làm index nội bộ ánh xạ flow↔canvas — trạng thái chia sẻ với _on_flow_tab_changed/_close_flow_tab (định nghĩa <701, ngoài phạm vi đọc).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 89 + ] + }, + { + "symbol": "Co4ETab.flow_add_btn", + "kind": "attribute", + "line_display": "764", + "line_start": 764, + "line_end": 764, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "ẩn (setVisible False), không hiển thị cho user hiện tại.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 90 + ] + }, + { + "symbol": "Co4ETab.flow_scroll", + "kind": "attribute", + "line_display": "781", + "line_start": 781, + "line_end": 781, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 91 + ] + }, + { + "symbol": "Co4ETab.center_stack", + "kind": "attribute", + "line_display": "805", + "line_start": 805, + "line_end": 805, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "TRẠNG THÁI CHIA SẺ — chuyển đổi giữa trang Runs (co4e_run_control_widget) và trang flow editor; dùng bởi _show_runs (ngoài phạm vi đọc) và _apply_workflow.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 92 + ] + }, + { + "symbol": "Co4ETab.name_edit", + "kind": "attribute", + "line_display": "814", + "line_start": 814, + "line_end": 814, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "khởi tạo từ self._wf.name — trạng thái chia sẻ; cũng bị _on_name_changed/_new_workflow đọc/ghi.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 93 + ] + }, + { + "symbol": "Co4ETab.add_step_btn", + "kind": "attribute", + "line_display": "819", + "line_start": 819, + "line_end": 819, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 94 + ] + }, + { + "symbol": "Co4ETab.save_btn", + "kind": "attribute", + "line_display": "822", + "line_start": 822, + "line_end": 822, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 95 + ] + }, + { + "symbol": "Co4ETab.save_tpl_btn", + "kind": "attribute", + "line_display": "826", + "line_start": 826, + "line_end": 826, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 96 + ] + }, + { + "symbol": "Co4ETab._vsplit", + "kind": "attribute", + "line_display": "863", + "line_start": 863, + "line_end": 863, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "splitter dọc canvas/chat — dùng chung với _toggle_messages (co4e_chat_view.py thao tác self._vsplit.setSizes) — trạng thái chia sẻ giữa co4e_tab.py và co4e_chat_view.py.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 101 + ] + }, + { + "symbol": "Co4ETab._NARROW", + "kind": "attribute", + "line_display": "971", + "line_start": 971, + "line_end": 971, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "hằng class-level (không phải self.), ngưỡng chiều rộng dùng bởi _apply_narrow_layout.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 118 + ] + }, + { + "symbol": "Co4ETab.showEvent", + "kind": "method", + "line_display": "973-975", + "line_start": 973, + "line_end": 975, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "Qt override, gọi self._narrow_guard.attach() (đối tượng khởi tạo ngoài phạm vi đọc, <701). [ANOMALY: cùng tên method định nghĩa 2 lần ở 2 dòng khác nhau trong cùng class -- có khả năng là lỗi nguồn (định nghĩa sau đè định nghĩa trước), không phải do quét trùng; giữ 2 dòng riêng, cần người quyết định định nghĩa nào còn hiệu lực]", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "ợng khởi tạo ngoài phạm vi đọc, <701). [ANOMALY: cùng tên method định nghĩa 2 lần ở 2 dòng khác nhau trong cùng class -- có khả", + "merged_from_raw_indices": [ + 119 + ] + }, + { + "symbol": "Co4ETab._apply_narrow_layout", + "kind": "method", + "line_display": "977-987", + "line_start": 977, + "line_end": 987, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "so self._config_collapsed rồi gọi self._toggle_config() — trạng thái chia sẻ với node_property_panel wrap logic.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 120 + ] + }, + { + "symbol": "Co4ETab._toggle_config", + "kind": "method", + "line_display": "989-1032", + "line_start": 989, + "line_end": 1032, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "dài 44 dòng, gộp: ẩn/hiện self.config (widget thuộc node_property_panel.py), đổi icon, tính lại self._split.setSizes, gọi _refresh_min_width — thao tác trực tiếp self.config/self.config_container (node_property_panel.py) và self._split (co4e_tab.py) cùng lúc — ranh giới tách file dễ vỡ nhất ở đoạn này. Ghi self._config_expanded_w.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 121 + ] + }, + { + "symbol": "Co4ETab._refresh_min_width", + "kind": "method", + "line_display": "1034-1039", + "line_start": 1034, + "line_end": 1039, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "thao tác trực tiếp self._split (QSplitter) và self.config_container — chia sẻ với _build_center/_wrap_config.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 123 + ] + }, + { + "symbol": "Co4ETab._apply_workflow", + "kind": "method", + "line_display": "1194-1207", + "line_start": 1194, + "line_end": 1207, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "hàm điều phối trung tâm khi mở 1 flow: gán self._wf (TRẠNG THÁI CHIA SẺ dùng khắp mọi nhóm chức năng — canvas, chat_stack/_flow_logs, config panel, run button, usage total). Đây là điểm nối chính giữa các file sau khi tách — không nên tách nhỏ hơn nếu không rất cẩn thận.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 150 + ] + }, + { + "symbol": "Co4ETab._new_workflow", + "kind": "method", + "line_display": "1209-1217", + "line_start": 1209, + "line_end": 1217, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "gọi self._open_flow(...) — khớp dòng plan.md '_open_flow() -> co4e_tab.py → gọi canvas'.", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 151 + ] + }, + { + "symbol": "Co4ETab._selected_wf", + "kind": "method", + "line_display": "1219-1225", + "line_start": 1219, + "line_end": 1225, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "đọc self.wf_list (sidebar, dựng ở _build_sidebar <701) rồi gọi co4e.get_workflow (đĩa).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 152 + ] + }, + { + "symbol": "Co4ETab._load_selected_workflow", + "kind": "method", + "line_display": "1227-1230", + "line_start": 1227, + "line_end": 1230, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 153 + ] + }, + { + "symbol": "Co4ETab._edit_selected_workflow", + "kind": "method", + "line_display": "1232-1237", + "line_start": 1232, + "line_end": 1237, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 154 + ] + }, + { + "symbol": "Co4ETab._wf_context_menu", + "kind": "method", + "line_display": "1248-1271", + "line_start": 1248, + "line_end": 1271, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "dựng QMenu cho sidebar flows, điều phối gọi _edit_selected_workflow/_rename_workflow/_duplicate_selected_workflow/_run_selected_in_background/_delete_selected_workflow (một số nằm ngoài phạm vi đọc, dòng >1400).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 156 + ] + }, + { + "symbol": "Co4ETab._sync_wf_from_canvas", + "kind": "method", + "line_display": "1299-1302", + "line_start": 1299, + "line_end": 1302, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "đọc self.canvas.nodes()/edges() và ghi self._wf.nodes/edges/name — cầu nối giữa co4e_canvas_widget.py và trạng thái self._wf chia sẻ; cân nhắc đặt cùng canvas nếu muốn canvas tự chịu trách nhiệm export dữ liệu.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 159 + ] + }, + { + "symbol": "Co4ETab._on_name_changed", + "kind": "method", + "line_display": "1316-1318", + "line_start": 1316, + "line_end": 1318, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "ghi self._wf.name (trạng thái chia sẻ) rồi gọi self._sync_active_flow_tab_text() (định nghĩa dòng 444, ngoài phạm vi đọc).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 162 + ] + }, + { + "symbol": "Co4ETab._add_blank_step", + "kind": "method", + "line_display": "1320-1322", + "line_start": 1320, + "line_end": 1322, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "nút 'Add' trên toolbar uỷ nhiệm sang self.canvas.add_palette_step — liên quan nhóm _add_node() trong plan.md (co4e_canvas_widget.py) nhưng bản thân handler chỉ là cầu nối từ toolbar.", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 163 + ] + }, + { + "symbol": "Co4ETab.set_project", + "kind": "method", + "line_display": "1658-1674", + "line_start": 1658, + "line_end": 1674, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "gọi load_project(project_id) (đọc đĩa) và self.manager.set_output_root/set_current_project (self.manager nên là co4e_workflow_service). Gán self._project_id, self._project_dir — không chắc là lần gán đầu tiên (có thể đã init ở __init__ ngoài khoảng đọc). Không khớp rõ nhóm nào trong danh sách đích cho trước — xếp tạm vào co4e_tab.py vì đây là API binding cấp container gọi từ ngoài.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "ể đã init ở __init__ ngoài khoảng đọc). Không khớp rõ nhóm nào trong danh sách đích cho trước — xếp tạm vào co4e_tab.py vì đây là", + "merged_from_raw_indices": [ + 190 + ] + }, + { + "symbol": "Co4ETab._flow_output_root", + "kind": "method", + "line_display": "1676-1686", + "line_start": 1676, + "line_end": 1686, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "helper dùng chung bởi cả chat (_out_dir) và run-control (_open_workspace_folder, _open_run_output_folder) — trạng thái/logic cắt ngang nhiều nhóm; đọc self._project_dir, self.ctx.config", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 191 + ] + }, + { + "symbol": "Co4ETab._refresh_ws_folder_btn", + "kind": "method", + "line_display": "1688-1693", + "line_start": 1688, + "line_end": 1693, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 192 + ] + }, + { + "symbol": "Co4ETab._open_workspace_folder", + "kind": "method", + "line_display": "1695-1702", + "line_start": 1695, + "line_end": 1702, + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "root.mkdir + open_location (mở file explorer hệ điều hành — spawn process)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 193 + ] + }, + { + "symbol": "Co4ETab.showEvent", + "kind": "method", + "line_display": "1806-1809", + "line_start": 1806, + "line_end": 1809, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "override Qt lifecycle method của chính QWidget container nên phải ở lại co4e_tab.py; gọi self._refresh_runs() (thuộc co4e_run_control_widget.py) — điểm nối giữa container và run-control widget. [ANOMALY: cùng tên method định nghĩa 2 lần ở 2 dòng khác nhau trong cùng class -- có khả năng là lỗi nguồn (định nghĩa sau đè định nghĩa trước), không phải do quét trùng; giữ 2 dòng riêng, cần người quyết định định nghĩa nào còn hiệu lực]", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "giữa container và run-control widget. [ANOMALY: cùng tên method định nghĩa 2 lần ở 2 dòng khác nhau trong cùng class -- có khả", + "merged_from_raw_indices": [ + 200 + ] + }, + { + "symbol": "Co4ETab._out_dir", + "kind": "method", + "line_display": "1811-1817", + "line_start": 1811, + "line_end": 1817, + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "d.mkdir(parents=True, exist_ok=True) — ghi đĩa; dùng chung bởi _run_chat_turn (chat) và tiềm năng bởi run-control; đọc self._wf.name, self._flow_output_root()", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 201 + ] + }, + { + "symbol": "Co4ETab._retranslate", + "kind": "method", + "line_display": "2059-2079", + "line_start": 2059, + "line_end": 2079, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/co4e_tab.py", + "note": "cập nhật text i18n cho rất nhiều widget thuộc nhiều nhóm khác nhau (sidebar buttons, runs_table, run control buttons) và gọi self._reload_sidebar()/self._refresh_runs() — thuộc container vì bao trùm toàn tab, dù có thể tách nhỏ theo từng panel sau này.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 218 + ] + }, + { + "symbol": "_SectionHeader", + "kind": "class", + "line_display": "30-52", + "line_start": 30, + "line_end": 52, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "Widget nội bộ (header có thể click, thu/mở section) chỉ dùng bởi StepConfigPanel; không có trong bảng plan.md/function_list.md, xếp cùng chỗ với StepConfigPanel vì mô tả node_property_panel.py là 'Bọc StepConfigPanel'", + "in_old_table": "co", + "old_table_mismatch": "section) chỉ dùng bởi StepConfigPanel; không có trong bảng plan.md/function_list.md, xếp cùng chỗ với StepConfigPanel vì mô tả node_property_panel", + "merged_from_raw_indices": [ + 315 + ] + }, + { + "symbol": "_SectionHeader.clicked", + "kind": "attribute", + "line_display": "36", + "line_start": 36, + "line_end": 36, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "Signal Qt khai báo ở cấp class, không phải self. gán trong __init__", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 316 + ] + }, + { + "symbol": "_SectionHeader.mousePressEvent", + "kind": "method", + "line_display": "38-41", + "line_start": 38, + "line_end": 41, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 317 + ] + }, + { + "symbol": "_SectionHeader.showEvent", + "kind": "method", + "line_display": "43-52", + "line_start": 43, + "line_end": 52, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "recompute fontMetrics khi label thực sự hiển thị — cần widget đang sống, không test được nếu không có QApplication", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 318 + ] + }, + { + "symbol": "_add_section", + "kind": "function", + "line_display": "55-130", + "line_start": 55, + "line_end": 130, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "Hàm dựng UI khối section thu gọn/mở rộng (header + body animate) dùng riêng cho StepConfigPanel; chứa 2 closure nội bộ _on_finished và _toggle. Không có trong bảng cũ.", + "in_old_table": "co", + "old_table_mismatch": "closure nội bộ _on_finished và _toggle. Không có trong bảng cũ.", + "merged_from_raw_indices": [ + 319 + ] + }, + { + "symbol": "_add_section._on_finished", + "kind": "function", + "line_display": "103-112", + "line_start": 103, + "line_end": 112, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "closure lồng bên trong _add_section, không phải hàm top-level — chỉ tồn tại khi _add_section chạy", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 320 + ] + }, + { + "symbol": "_add_section._toggle", + "kind": "function", + "line_display": "114-127", + "line_start": 114, + "line_end": 127, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "closure lồng bên trong _add_section, gắn vào header.clicked", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 321 + ] + }, + { + "symbol": "StepConfigPanel", + "kind": "class", + "line_display": "133-528", + "line_start": 133, + "line_end": 528, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "cắt ngang lát — cần agent gộp đối chiếu (lớp còn tiếp tục sau dòng 528, chỉ đọc được 1-528). Bảng plan.md/function_list.md không liệt kê StepConfigPanel trực tiếp (chỉ có _build_config_panel() -> co4e_tab.py container); xếp theo mô tả node_property_panel.py 'Bọc StepConfigPanel, nối chọn node sang panel thuộc tính' trong danh sách đích được giao cho task này — người quyết cuối nên xác nhận lại.", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 322 + ] + }, + { + "symbol": "StepConfigPanel.changed", + "kind": "attribute", + "line_display": "134", + "line_start": 134, + "line_end": 134, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "Signal Qt: bất kỳ field nào đổi -> canvas repaint node + autosave; đây là điểm nối trạng thái chia sẻ với canvas/co4e_workflow_service, cần giữ tên/signature khi tách file", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 323 + ] + }, + { + "symbol": "StepConfigPanel.run_node", + "kind": "attribute", + "line_display": "135", + "line_start": 135, + "line_end": 135, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "Signal Qt 'chạy step này' — nối sang co4e_run_control_widget.py hoặc co4e_workflow_service.py", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 324 + ] + }, + { + "symbol": "StepConfigPanel.run_from", + "kind": "attribute", + "line_display": "136", + "line_start": 136, + "line_end": 136, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "Signal Qt 'chạy từ bước này' — nối sang co4e_run_control_widget.py", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 325 + ] + }, + { + "symbol": "StepConfigPanel.delete_node", + "kind": "attribute", + "line_display": "137", + "line_start": 137, + "line_end": 137, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "Signal Qt xoá step — nối sang co4e_canvas_widget.py để xoá node trên canvas", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 326 + ] + }, + { + "symbol": "StepConfigPanel.__init__", + "kind": "method", + "line_display": "139-313", + "line_start": 139, + "line_end": 313, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": ">80 dòng (174 dòng) — gộp nhiều việc không liên quan: dựng section Cơ bản, section Model&Quyền, section Skills&Tệp, section Sub-agents (ẩn/hiện theo is_parallel), và dựng hàng nút footer Run/Run-from/Delete, cộng thêm cơ chế 'outer.addStretch(1)' vá lỗi layout. Nên tách thành các hàm _build_basic_section(), _build_model_section(), _build_skills_section(), _build_subagent_section(), _build_footer() riêng khi tách file.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 327 + ] + }, + { + "symbol": "StepConfigPanel.ctx", + "kind": "attribute", + "line_display": "141", + "line_start": 141, + "line_end": 141, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "context được truyền từ ngoài vào, dùng cho _ai_draft/_load_models (gọi AI provider) — trạng thái chia sẻ với co4e_tab.py", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 328 + ] + }, + { + "symbol": "StepConfigPanel._step", + "kind": "attribute", + "line_display": "142", + "line_start": 142, + "line_end": 142, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "Step đang chỉnh sửa — trạng thái chia sẻ giữa load_step()/_on_edit()/mọi hành động subagent+attachment; do canvas gán vào qua load_step()", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 329 + ] + }, + { + "symbol": "StepConfigPanel._node_id", + "kind": "attribute", + "line_display": "143", + "line_start": 143, + "line_end": 143, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "id node đang chọn — dùng để emit run_node/run_from/delete_node; là cầu nối canvas <-> property panel", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 330 + ] + }, + { + "symbol": "StepConfigPanel._loading", + "kind": "attribute", + "line_display": "144", + "line_start": 144, + "line_end": 144, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "cờ chặn _on_edit() chạy lại trong lúc load_step() đang set giá trị field", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 331 + ] + }, + { + "symbol": "StepConfigPanel.label_edit", + "kind": "attribute", + "line_display": "159", + "line_start": 159, + "line_end": 159, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 332 + ] + }, + { + "symbol": "StepConfigPanel.role_edit", + "kind": "attribute", + "line_display": "163", + "line_start": 163, + "line_end": 163, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 333 + ] + }, + { + "symbol": "StepConfigPanel.icon_edit", + "kind": "attribute", + "line_display": "170", + "line_start": 170, + "line_end": 170, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 334 + ] + }, + { + "symbol": "StepConfigPanel.instructions_edit", + "kind": "attribute", + "line_display": "175", + "line_start": 175, + "line_end": 175, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 335 + ] + }, + { + "symbol": "StepConfigPanel.gen_btn", + "kind": "attribute", + "line_display": "178", + "line_start": 178, + "line_end": 178, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "nút 'AI draft' — enable chỉ khi có ctx", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 336 + ] + }, + { + "symbol": "StepConfigPanel.context_edit", + "kind": "attribute", + "line_display": "192", + "line_start": 192, + "line_end": 192, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 337 + ] + }, + { + "symbol": "StepConfigPanel.model_combo", + "kind": "attribute", + "line_display": "201", + "line_start": 201, + "line_end": 201, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 338 + ] + }, + { + "symbol": "StepConfigPanel.load_models_btn", + "kind": "attribute", + "line_display": "204", + "line_start": 204, + "line_end": 204, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 339 + ] + }, + { + "symbol": "StepConfigPanel.perm_combo", + "kind": "attribute", + "line_display": "214", + "line_start": 214, + "line_end": 214, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 340 + ] + }, + { + "symbol": "StepConfigPanel.verify_chk", + "kind": "attribute", + "line_display": "221", + "line_start": 221, + "line_end": 221, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 341 + ] + }, + { + "symbol": "StepConfigPanel.rounds_spin", + "kind": "attribute", + "line_display": "223", + "line_start": 223, + "line_end": 223, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 342 + ] + }, + { + "symbol": "StepConfigPanel.skills_list", + "kind": "attribute", + "line_display": "236", + "line_start": 236, + "line_end": 236, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "checklist skill của registry, gán checked theo step.skills", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 343 + ] + }, + { + "symbol": "StepConfigPanel.attach_list", + "kind": "attribute", + "line_display": "242", + "line_start": 242, + "line_end": 242, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 344 + ] + }, + { + "symbol": "StepConfigPanel.attach_add_btn", + "kind": "attribute", + "line_display": "244", + "line_start": 244, + "line_end": 244, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 345 + ] + }, + { + "symbol": "StepConfigPanel.attach_del_btn", + "kind": "attribute", + "line_display": "247", + "line_start": 247, + "line_end": 247, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 346 + ] + }, + { + "symbol": "StepConfigPanel._parallel_card", + "kind": "attribute", + "line_display": "263", + "line_start": 263, + "line_end": 263, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "card cả section Sub-agents; load_step() ẩn/hiện toàn bộ card này theo step.is_parallel", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 347 + ] + }, + { + "symbol": "StepConfigPanel.sub_list", + "kind": "attribute", + "line_display": "264", + "line_start": 264, + "line_end": 264, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 348 + ] + }, + { + "symbol": "StepConfigPanel.sub_add_btn", + "kind": "attribute", + "line_display": "267", + "line_start": 267, + "line_end": 267, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 349 + ] + }, + { + "symbol": "Co4ETab.config", + "kind": "attribute", + "line_display": "268", + "line_start": 268, + "line_end": 268, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "StepConfigPanel + wiring changed/run_node/run_from/delete_node (dòng 268-273) — khớp vai trò mô tả cho node_property_panel.py", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 39 + ] + }, + { + "symbol": "StepConfigPanel.sub_del_btn", + "kind": "attribute", + "line_display": "270", + "line_start": 270, + "line_end": 270, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 350 + ] + }, + { + "symbol": "StepConfigPanel.run_btn", + "kind": "attribute", + "line_display": "283", + "line_start": 283, + "line_end": 283, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "click emit run_node(self._node_id)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 351 + ] + }, + { + "symbol": "StepConfigPanel.run_from_btn", + "kind": "attribute", + "line_display": "287", + "line_start": 287, + "line_end": 287, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "click emit run_from(self._node_id)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 352 + ] + }, + { + "symbol": "StepConfigPanel.del_btn", + "kind": "attribute", + "line_display": "290", + "line_start": 290, + "line_end": 290, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "click emit delete_node(self._node_id)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 353 + ] + }, + { + "symbol": "StepConfigPanel.load_step", + "kind": "method", + "line_display": "316-354", + "line_start": 316, + "line_end": 354, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "Điểm nối chính giữa canvas (khi chọn node) và panel thuộc tính — nhận (node_id, step, skill_names) từ ngoài rồi ghi self._step/self._node_id; đây là API mà co4e_canvas_widget.py hoặc co4e_tab.py sẽ gọi khi chọn node", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 354 + ] + }, + { + "symbol": "StepConfigPanel.clear_step", + "kind": "method", + "line_display": "356-359", + "line_start": 356, + "line_end": 359, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "gọi khi bỏ chọn node — reset self._step/self._node_id", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 355 + ] + }, + { + "symbol": "StepConfigPanel._on_edit", + "kind": "method", + "line_display": "362-378", + "line_start": 362, + "line_end": 378, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "ghi ngược giá trị field UI vào self._step rồi emit changed() — canvas repaint + autosave phụ thuộc signal này, đổi tên/behavior ở đây ảnh hưởng cả canvas lẫn service lưu flow", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 356 + ] + }, + { + "symbol": "StepConfigPanel._available_agent_names", + "kind": "method", + "line_display": "380-390", + "line_start": 380, + "line_end": 390, + "needs_qt_widget": false, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "staticmethod; gọi core.co4e.list_custom_agents() đọc file JSON trong AGENTS_DIR trên đĩa — logic thuần Python nhưng có I/O, có thể tách ra application layer nếu cần test không đụng đĩa", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 357 + ] + }, + { + "symbol": "StepConfigPanel._add_subagent", + "kind": "method", + "line_display": "392-408", + "line_start": 392, + "line_end": 408, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "dùng QInputDialog để chọn/nhập tên agent song song", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 358 + ] + }, + { + "symbol": "StepConfigPanel._edit_subagent", + "kind": "method", + "line_display": "410-428", + "line_start": 410, + "line_end": 428, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "double-click 1 dòng sub-agent để chọn lại agent khác", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 359 + ] + }, + { + "symbol": "StepConfigPanel._del_subagent", + "kind": "method", + "line_display": "430-437", + "line_start": 430, + "line_end": 437, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 360 + ] + }, + { + "symbol": "StepConfigPanel._add_attachment", + "kind": "method", + "line_display": "439-453", + "line_start": 439, + "line_end": 453, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "QFileDialog chỉ chọn đường dẫn hiển thị tên file, không tự đọc nội dung ở đây (nội dung được đọc lúc chạy step, ở nơi khác)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 361 + ] + }, + { + "symbol": "StepConfigPanel._del_attachment", + "kind": "method", + "line_display": "455-462", + "line_start": 455, + "line_end": 462, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 362 + ] + }, + { + "symbol": "StepConfigPanel._ai_draft", + "kind": "method", + "line_display": "464-498", + "line_start": 464, + "line_end": 498, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "gọi generate_agent_prompt(ctx.build_active_provider(), ...) qua AgentWorker — gọi network tới AI provider, chạy nền rồi cập nhật UI ở callback done(); nếu tách sang service, phần gọi AI nên chuyển xuống application layer, phần còn lại (QInputDialog + set text) ở lại đây", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 363 + ] + }, + { + "symbol": "StepConfigPanel._draft_worker", + "kind": "attribute", + "line_display": "497", + "line_start": 497, + "line_end": 497, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "giữ tham chiếu AgentWorker (QThread-like) để không bị GC giữa lúc job async đang chạy", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 364 + ] + }, + { + "symbol": "StepConfigPanel._load_models", + "kind": "method", + "line_display": "500-528", + "line_start": 500, + "line_end": 528, + "needs_qt_widget": true, + "touches_disk_or_network": true, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "gọi preview_ai.fetch_live_models(ctx) qua AgentWorker — network call tới provider để lấy danh sách model; cắt ngang lát — cần agent gộp đối chiếu vì dòng cuối trùng đúng biên đọc được giao (528), chưa chắc thân method đã hết ở đây", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 365 + ] + }, + { + "symbol": "StepConfigPanel._model_worker", + "kind": "attribute", + "line_display": "525", + "line_start": 525, + "line_end": 525, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "giữ tham chiếu AgentWorker của _load_models để không bị GC", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 366 + ] + }, + { + "symbol": "Co4ETab._wrap_config", + "kind": "method", + "line_display": "934-964", + "line_start": 934, + "line_end": 964, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "bọc self.config (StepConfigPanel) với header expand/collapse — khớp mô tả node_property_panel.py trong prompt.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 111 + ] + }, + { + "symbol": "Co4ETab.config_toggle_btn", + "kind": "attribute", + "line_display": "946", + "line_start": 946, + "line_end": 946, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 112 + ] + }, + { + "symbol": "Co4ETab.config_title", + "kind": "attribute", + "line_display": "951", + "line_start": 951, + "line_end": 951, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 113 + ] + }, + { + "symbol": "Co4ETab._cfg_vlayout", + "kind": "attribute", + "line_display": "957", + "line_start": 957, + "line_end": 957, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "dùng lại trong _toggle_config (co4e_tab.py) — trạng thái chia sẻ.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 114 + ] + }, + { + "symbol": "Co4ETab._cfg_top_spacer", + "kind": "attribute", + "line_display": "961", + "line_start": 961, + "line_end": 961, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "QSpacerItem — kiểu giá trị layout, không cần QApplication đang sống.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 115 + ] + }, + { + "symbol": "Co4ETab._cfg_bot_spacer", + "kind": "attribute", + "line_display": "962", + "line_start": 962, + "line_end": 962, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 116 + ] + }, + { + "symbol": "Co4ETab.config_container", + "kind": "attribute", + "line_display": "963", + "line_start": 963, + "line_end": 963, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "dùng lại bởi _toggle_config (co4e_tab.py) — trạng thái chia sẻ giữa node_property_panel.py và co4e_tab.py.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 117 + ] + }, + { + "symbol": "Co4ETab._on_node_selected", + "kind": "method", + "line_display": "1325-1331", + "line_start": 1325, + "line_end": 1331, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "khớp mô tả 'nối chọn node sang panel thuộc tính' trong prompt. Đọc self.canvas.nodes() và self.config, toggle self._config_collapsed (trạng thái chia sẻ với _toggle_config ở co4e_tab.py).", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 164 + ] + }, + { + "symbol": "Co4ETab._on_config_changed", + "kind": "method", + "line_display": "1333-1336", + "line_start": 1333, + "line_end": 1336, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/node_property_panel.py", + "note": "gọi self.canvas.refresh_node cho từng node rồi self._autosave() — cầu nối property panel ↔ canvas ↔ service lưu đĩa.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 165 + ] + }, + { + "symbol": "Co4ETab._manage_skills", + "kind": "method", + "line_display": "1369-1373", + "line_start": 1369, + "line_end": 1373, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "presentation/co4e/skills_list_panel.py", + "note": "mở SkillsDialog rồi self._reload_sidebar() — không có tên tương ứng trực tiếp trong bảng plan.md, tự xếp theo mô tả skills_list_panel.py.", + "in_old_table": "co", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 170 + ] + }, + { + "symbol": "_PaletteList", + "kind": "class", + "line_display": "97-119", + "line_start": 97, + "line_end": 119, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "unsure", + "note": "list kéo-thả dùng chung cho wf_list và agent_list, phát payload CO4E_MIME hiểu bởi canvas — không rõ nên đặt ở co4e_tab.py (nơi dùng) hay co4e_canvas_widget.py (định nghĩa giao thức CO4E_MIME)", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 8 + ] + }, + { + "symbol": "_PaletteList.__init__", + "kind": "method", + "line_display": "102-106", + "line_start": 102, + "line_end": 106, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "unsure", + "note": "cùng lý do với class _PaletteList", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 9 + ] + }, + { + "symbol": "_PaletteList._payload_role", + "kind": "attribute", + "line_display": "104", + "line_start": 104, + "line_end": 104, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "unsure", + "note": "cùng lý do với class _PaletteList", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 10 + ] + }, + { + "symbol": "_PaletteList.startDrag", + "kind": "method", + "line_display": "108-119", + "line_start": 108, + "line_end": 119, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "unsure", + "note": "cùng lý do với class _PaletteList; dùng CO4E_MIME từ co4e_canvas", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 11 + ] + }, + { + "symbol": "Co4ETab._project_id", + "kind": "attribute", + "line_display": "249", + "line_start": 249, + "line_end": 249, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "unsure", + "note": "project Workspace đang chọn, ảnh hưởng đường dẫn output flow — không chắc thuộc container hay run control", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 31 + ] + }, + { + "symbol": "Co4ETab._project_dir", + "kind": "attribute", + "line_display": "250", + "line_start": 250, + "line_end": 250, + "needs_qt_widget": false, + "touches_disk_or_network": false, + "target_file": "unsure", + "note": "cùng lý do với _project_id", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 32 + ] + }, + { + "symbol": "Co4ETab._reflect_active_run", + "kind": "method", + "line_display": "449-457", + "line_start": 449, + "line_end": 457, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "unsure", + "note": "cầu nối giữa self.manager (run control) và self.canvas (canvas widget) — không chắc nên đặt file nào", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 52 + ] + }, + { + "symbol": "Co4ETab._palette_item", + "kind": "method", + "line_display": "724-728", + "line_start": 724, + "line_end": 728, + "needs_qt_widget": true, + "touches_disk_or_network": false, + "target_file": "unsure", + "note": "staticmethod helper dùng chung để tạo QListWidgetItem cho cả agent_list, skill_list, và cả node palette sequential/parallel (thấy dùng ở dòng 701-704) — không rõ nên đặt ở agent_list_panel.py, skills_list_panel.py hay co4e_canvas_widget.py.", + "in_old_table": "chua/khong ro", + "old_table_mismatch": "-", + "merged_from_raw_indices": [ + 87 + ] + } + ] +} \ No newline at end of file diff --git a/docs/architecture/co4e-split-map.md b/docs/architecture/co4e-split-map.md new file mode 100644 index 0000000..6dd2086 --- /dev/null +++ b/docs/architecture/co4e-split-map.md @@ -0,0 +1,407 @@ +# Bản đồ tách file Co4E (gộp từ 6 agent quét song song) + +- Tổng số symbol quét được (thô, tính cả trùng): **367** +- Tổng số dòng trong bản đồ cuối cùng (sau gộp trùng): **363** +- Số nhóm ký hiệu bị quét trùng bởi 2 agent (đã gộp làm 1 dòng): 4 (Co4ECanvas.dropEvent, Co4ETab._co4e_routed_provider, Co4ETab._config_expanded_w, Co4ETab._reload_sidebar) +- Số ký hiệu có 2 định nghĩa thật ở 2 dòng khác nhau, giữ riêng và gắn cờ: 1 (Co4ETab.showEvent) +- EXPECTED (tools/check_co4e.py) có **27** phần tử; kết quả đối chiếu: OK — cả 27 xuất hiện đúng 1 lần, có target cụ thể +- Số note bắt đầu bằng `khac tai lieu:`: **0** (không có -> không có mục 'Chỗ thấy khác tài liệu' nào phát sinh từ tiêu chí này) + +## Ghi chú về gộp trùng (5 ký hiệu bị 2 agent cùng quét thấy) + +### `Co4ETab._config_expanded_w` +- dòng 275-275, target agent gốc đề xuất = `presentation/co4e/co4e_tab.py` — cùng lý do với _config_collapsed +- dòng 995-995, target agent gốc đề xuất = `presentation/co4e/co4e_tab.py` — gán trong nhánh collapse của _toggle_config; có thể đã khởi tạo trong __init__ (ngoài phạm vi đọc). +- **Quyết định gộp**: 1 dòng, target cuối = `presentation/co4e/co4e_tab.py`, dòng 275; 995 + +### `Co4ETab._reload_sidebar` +- dòng 689-700, target agent gốc đề xuất = `presentation/co4e/co4e_tab.py` — cắt ngang lát — cần agent gộp đối chiếu (method tiếp tục sau dòng 700); gọi co4e.list_workflows() (đọc đĩa) rồi dựng QListWidgetItem trực tiếp trong cùng hàm — trộn data-fetch và UI, nên tách phần đọc dữ liệu sang co4e_workflow_service.py +- dòng 689-722, target agent gốc đề xuất = `unsure` — cắt ngang lát — cần agent gộp đối chiếu (bắt đầu trước dòng 701). Gộp refresh cả agent_list và skill_list trong cùng 1 hàm — nên tách thành _refresh_agents_list (agent_list_panel.py) và _refresh_skills_list (skills_list_panel.py) như plan.md yêu cầu; gọi co4e.list_custom_agents() (đĩa) và skills_mod.skill_prefix_for (đĩa). +- **Quyết định gộp**: 1 dòng, target cuối = `presentation/co4e/co4e_tab.py`, dòng 689-722 + +### `Co4ETab.showEvent` +- dòng 973-975, target agent gốc đề xuất = `presentation/co4e/co4e_tab.py` — Qt override, gọi self._narrow_guard.attach() (đối tượng khởi tạo ngoài phạm vi đọc, <701). +- dòng 1806-1809, target agent gốc đề xuất = `presentation/co4e/co4e_tab.py` — override Qt lifecycle method của chính QWidget container nên phải ở lại co4e_tab.py; gọi self._refresh_runs() (thuộc co4e_run_control_widget.py) — điểm nối giữa container và run-control widget. +- **Quyết định**: đây là 2 định nghĩa method trùng tên thật sự tồn tại ở 2 vị trí khác nhau trong cùng class `Co4ETab` (khả năng cao là lỗi nguồn — định nghĩa sau đè định nghĩa trước, làm dòng logic ở định nghĩa trước thành dead code). Giữ nguyên 2 dòng riêng biệt trong bản đồ, KHÔNG gộp, và cần người quyết định giữ định nghĩa nào. + +### `Co4ETab._co4e_routed_provider` +- dòng 1114-1114, target agent gốc đề xuất = `presentation/co4e/co4e_chat_view.py` — override provider cho lượt chat kế tiếp — dùng bởi _apply_co4e_routing (ngoài phạm vi đọc, >1400). +- dòng 1853-1853, target agent gốc đề xuất = `presentation/co4e/co4e_chat_view.py` — gán None lần đầu tại đây (trong _apply_co4e_routing); đọc bằng getattr(self, '_co4e_routed_provider', None) ở _run_chat_turn dòng ~1922 — gợi ý có thể không được init trong __init__. Trạng thái routing theo từng lượt chat, dùng chung giữa chat-view và _start_canvas_run/manager.start. +- **Quyết định gộp**: 1 dòng, target cuối = `presentation/co4e/co4e_chat_view.py`, dòng 1114; 1853 + +### `Co4ECanvas.dropEvent` +- dòng 683-700, target agent gốc đề xuất = `presentation/co4e/co4e_canvas_widget.py` — cắt ngang lát — cần agent gộp đối chiếu (thân try chưa đóng ở dòng 700, còn tiếp; xử lý JSON từ mimeData trong bộ nhớ, không phải file đĩa nên touches_disk_or_network=false) +- dòng 683-701, target agent gốc đề xuất = `presentation/co4e/co4e_canvas_widget.py` — cắt ngang lát — cần agent gộp đối chiếu. Method dropEvent bắt đầu ở dòng 683 (ngoài khoảng được giao 701-791), chỉ dòng 701 (e.acceptProposedAction()) nằm trong lát này; dòng 702 là dòng trống cuối file. File ui/co4e_canvas.py chỉ có 702 dòng — không có nội dung nào khác trong khoảng 702-791 vì đã hết file. Xử lý drop từ sidebar (kind=='workflow' → add_workflow, ngược lại → add_palette_step) — logic thao tác node/canvas nên khớp nhóm _add_node/_connect_nodes trong bảng plan.md dòng 623 dù plan.md không liệt kê rõ dropEvent. +- **Quyết định gộp**: 1 dòng, target cuối = `presentation/co4e/co4e_canvas_widget.py`, dòng 683-701 + +## Bảng đầy đủ + +| symbol | dòng | file đích | lý do | có trong bảng cũ chưa | chỗ nào thấy bảng cũ sai | +|---|---|---|---|---|---| +| Co4ETab._flow_outputs | 245 | application/workflows/co4e_workflow_service.py | state per-flow outputs — ứng viên chuyển vào state machine thuần Python | chua/khong ro | - | +| Co4ETab._outputs_for | 475-478 | application/workflows/co4e_workflow_service.py | truy cập dict state per-flow outputs, thuần Python | chua/khong ro | - | +| Co4ETab._duplicate_selected_workflow | 1239-1246 | application/workflows/co4e_workflow_service.py | tương ứng _duplicate_flow() trong bảng plan.md dòng 616, nhưng tên hàm thực tế khác (_duplicate_selected_workflow). Gộp gọi service (co4e.duplicate_workflow, đĩa) với cập nhật UI (self._reload_sidebar(), self.status_message.emit) — cần tách; phần UI nên ở lại co4e_tab.py. | co | ate_flow() trong bảng plan.md dòng 616, nhưng tên hàm thực tế khác (_duplicate_selected_workflow). Gộp gọi service (co4e.duplicate_workflow, đĩa) | +| Co4ETab._rename_workflow | 1273-1289 | application/workflows/co4e_workflow_service.py | mở QInputDialog (cần Qt) rồi gọi co4e.save_workflow (đĩa), đồng bộ self._wf.name/self.name_edit nếu flow đang mở là flow bị đổi tên — gộp UI dialog + service + trạng thái chia sẻ self._wf trong 1 hàm, nên tách. | chua/khong ro | - | +| Co4ETab._delete_selected_workflow | 1291-1297 | application/workflows/co4e_workflow_service.py | tương ứng _delete_flow() trong bảng plan.md dòng 616; gọi co4e.delete_workflow (đĩa). | co | - | +| Co4ETab._save | 1304-1309 | application/workflows/co4e_workflow_service.py | gộp _sync_wf_from_canvas (đọc canvas UI), lưu đĩa (co4e.save_workflow), và cập nhật UI (_reload_sidebar, status_message) — cần tách phần service khỏi phần UI khi chuyển sang co4e_workflow_service.py. | chua/khong ro | - | +| Co4ETab._autosave | 1311-1314 | application/workflows/co4e_workflow_service.py | gọi self._sync_wf_from_canvas() (cần canvas) rồi co4e.get_workflow/save_workflow (đĩa). | chua/khong ro | - | +| Co4ETab._skill_map | 1376-1382 | application/workflows/co4e_workflow_service.py | chuẩn bị nội dung skill (skills_mod.skill_prefix_for, đọc đĩa) để đưa vào lúc chạy flow/chat — không có trong bảng plan.md, tự xếp theo chức năng (dùng lúc run/build system prompt, không phải UI danh sách skill). | co | ọc đĩa) để đưa vào lúc chạy flow/chat — không có trong bảng plan.md, tự xếp theo chức năng (dùng lúc run/build system prompt, không phải UI danh sá | +| Co4ETab.ag_new_btn | 550 | presentation/co4e/agent_list_panel.py | hiện định nghĩa trực tiếp trong Co4ETab._build_sidebar — ứng viên chuyển sang agent_list_panel.py tương tự cách skills đã tách | chua/khong ro | - | +| Co4ETab.agent_list | 558 | presentation/co4e/agent_list_panel.py | cùng lý do với ag_new_btn | chua/khong ro | - | +| Co4ETab.ag_edit_btn | 562 | presentation/co4e/agent_list_panel.py | cùng lý do với ag_new_btn | chua/khong ro | - | +| Co4ETab.ag_del_btn | 563 | presentation/co4e/agent_list_panel.py | cùng lý do với ag_new_btn | chua/khong ro | - | +| Co4ETab._new_agent | 1339-1340 | presentation/co4e/agent_list_panel.py | tương ứng _create_agent() trong bảng plan.md dòng 620 (tên hàm thực tế là _new_agent). | co | - | +| Co4ETab._edit_agent | 1342-1350 | presentation/co4e/agent_list_panel.py | khớp _edit_agent() dòng 620 plan.md; gọi co4e.list_custom_agents() (đĩa). | co | - | +| Co4ETab._edit_agent_dialog | 1352-1358 | presentation/co4e/agent_list_panel.py | mở Co4EAgentDialog rồi co4e.save_custom_agent (đĩa) và self._reload_sidebar() — trạng thái chia sẻ, liên quan tới cắt ngang lát ở _reload_sidebar. | chua/khong ro | - | +| Co4ETab._delete_agent | 1360-1367 | presentation/co4e/agent_list_panel.py | khớp _delete_agent() dòng 620 plan.md; gọi co4e.delete_custom_agent (đĩa). | co | - | +| _status_color | 43-50 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _NodeItem | 59-210 | presentation/co4e/co4e_canvas_widget.py | class nội bộ gắn chặt với Co4ECanvas qua self.canvas backreference — nên đi cùng file với Co4ECanvas | chua/khong ro | - | +| _NodeItem.__init__ | 62-72 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _NodeItem.node | 64 | presentation/co4e/co4e_canvas_widget.py | giữ tham chiếu domain Node — dữ liệu chia sẻ với core/co4e.py | chua/khong ro | - | +| _NodeItem.canvas | 65 | presentation/co4e/co4e_canvas_widget.py | backreference tới Co4ECanvas cha — mọi event của _NodeItem đều gọi ngược lên canvas (add_step_below, begin_connect, delete_node, các signal) — điểm khớp nối chặt nhất trong file | chua/khong ro | - | +| _NodeItem.status | 66 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _NodeItem._porting | 67 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _NodeItem.boundingRect | 74-76 | presentation/co4e/co4e_canvas_widget.py | trả QRectF như kiểu giá trị, logic thuần | chua/khong ro | - | +| _NodeItem._card_rect | 78-79 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _NodeItem.paint | 81-139 | presentation/co4e/co4e_canvas_widget.py | vẽ toàn bộ card: nền, header stripe, label, badge role, preview instructions/sub-agents, footer model/skills, 2 port — gộp nhiều việc nhưng vẫn dưới 80 dòng nên chưa bắt buộc tách thêm | chua/khong ro | - | +| _NodeItem._in_out_port | 141-143 | presentation/co4e/co4e_canvas_widget.py | hình học thuần dùng QPointF như kiểu giá trị | chua/khong ro | - | +| _NodeItem.itemChange | 145-156 | presentation/co4e/co4e_canvas_widget.py | ghi self.node.x/y rồi gọi self.canvas._reposition_edges() và emit self.canvas.graph_changed/node_selected — chạm trạng thái chia sẻ của canvas cha | chua/khong ro | - | +| _NodeItem.hoverMoveEvent | 158-161 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _NodeItem.mousePressEvent | 163-174 | presentation/co4e/co4e_canvas_widget.py | đọc/ghi self.canvas._connect_from, gọi canvas._finish_connect/begin_port_drag — trạng thái connect-mode chia sẻ với Co4ECanvas | chua/khong ro | - | +| _NodeItem.mouseMoveEvent | 176-181 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _NodeItem.mouseReleaseEvent | 183-189 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _NodeItem.mouseDoubleClickEvent | 191-193 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _NodeItem.contextMenuEvent | 195-207 | presentation/co4e/co4e_canvas_widget.py | gọi canvas.add_step_below/begin_connect/delete_node — trạng thái/hành vi thuộc canvas cha | chua/khong ro | - | +| _NodeItem.center | 209-210 | presentation/co4e/co4e_canvas_widget.py | trả QPointF như kiểu giá trị | chua/khong ro | - | +| _EdgeItem | 213-286 | presentation/co4e/co4e_canvas_widget.py | class nội bộ gắn chặt với Co4ECanvas qua self.canvas backreference | chua/khong ro | - | +| _EdgeItem.__init__ | 214-225 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _EdgeItem.edge | 216 | presentation/co4e/co4e_canvas_widget.py | tham chiếu domain Edge — chia sẻ với core/co4e.py | chua/khong ro | - | +| _EdgeItem.canvas | 217 | presentation/co4e/co4e_canvas_widget.py | backreference tới Co4ECanvas — contextMenuEvent gọi canvas.delete_edge | chua/khong ro | - | +| _EdgeItem._dst | 218 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _EdgeItem._hover | 224 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _EdgeItem._apply_pen | 227-235 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _EdgeItem.update_path | 237-239 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _EdgeItem.boundingRect | 241-242 | presentation/co4e/co4e_canvas_widget.py | gọi super().boundingRect() phụ thuộc trạng thái path sống của item | chua/khong ro | - | +| _EdgeItem.shape | 244-249 | presentation/co4e/co4e_canvas_widget.py | dùng QPainterPathStroker trên self.path() sống của item | chua/khong ro | - | +| _EdgeItem.hoverEnterEvent | 251-255 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _EdgeItem.hoverLeaveEvent | 257-261 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _EdgeItem.paint | 263-279 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _EdgeItem.contextMenuEvent | 281-286 | presentation/co4e/co4e_canvas_widget.py | gọi self.canvas.delete_edge(self.edge) | chua/khong ro | - | +| Co4ECanvas | 289-700 | presentation/co4e/co4e_canvas_widget.py | cắt ngang lát — class tiếp tục sau dòng 700 (dropEvent chưa kết thúc, có thể còn method khác chưa đọc) — cần agent gộp đối chiếu với phần đọc dòng 701+ | chua/khong ro | - | +| Co4ECanvas.node_selected | 290 | presentation/co4e/co4e_canvas_widget.py | Signal được node_property_panel.py (và co4e_tab.py) nối vào để nạp node được chọn — điểm chia sẻ giữa canvas và property panel | chua/khong ro | - | +| Co4ECanvas.node_activated | 291 | presentation/co4e/co4e_canvas_widget.py | Signal double-click, có thể được co4e_tab.py nối để mở panel chỉnh sửa — cần kiểm nơi consume | chua/khong ro | - | +| Co4ECanvas.graph_changed | 292 | presentation/co4e/co4e_canvas_widget.py | Signal báo graph đổi (autosave) — nhiều khả năng được co4e_tab.py/co4e_workflow_service.py nối để lưu flow, trạng thái chia sẻ xuyên lớp application | chua/khong ro | - | +| Co4ECanvas.__init__ | 296-315 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._scene | 299 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._nodes | 305 | presentation/co4e/co4e_canvas_widget.py | dict id->_NodeItem — trạng thái trung tâm được đọc/ghi bởi gần như mọi method của Co4ECanvas (add/delete/relayout/zoom/status/route edges) | chua/khong ro | - | +| Co4ECanvas._edges | 306 | presentation/co4e/co4e_canvas_widget.py | list _EdgeItem — trạng thái trung tâm tương tự self._nodes | chua/khong ro | - | +| Co4ECanvas._connect_from | 307 | presentation/co4e/co4e_canvas_widget.py | trạng thái connect-mode, cũng được _NodeItem.mousePressEvent đọc/ghi qua self.canvas | chua/khong ro | - | +| Co4ECanvas._zoom | 308 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._panning | 309 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._pan_start | 310 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._overlay | 311 | presentation/co4e/co4e_canvas_widget.py | widget zoom/fit overlay được co4e_tab.py hoặc co4e_canvas_widget.py truyền vào qua add_overlay() | chua/khong ro | - | +| Co4ECanvas._port_src | 313 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._port_src_pt | 314 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._temp_edge | 315 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.add_overlay | 318-323 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._place_overlay | 325-330 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.resizeEvent | 332-334 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.scrollContentsBy | 336-341 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.showEvent | 343-345 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.load | 348-362 | presentation/co4e/co4e_canvas_widget.py | reset toàn bộ self._nodes/self._edges/self._connect_from/self._port_src/self._temp_edge — điểm nạp lại state từ flow, được co4e_tab.py hoặc co4e_workflow_service.py gọi khi mở flow | chua/khong ro | - | +| Co4ECanvas.nodes | 364-365 | presentation/co4e/co4e_canvas_widget.py | chỉ đọc .node từ self._nodes, không gọi API Qt trực tiếp | chua/khong ro | - | +| Co4ECanvas.edges | 367-368 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.add_node | 371-382 | presentation/co4e/co4e_canvas_widget.py | ghi self._nodes, scene.addItem, emit graph_changed/node_selected — trạng thái chia sẻ với property panel qua node_selected | chua/khong ro | - | +| Co4ECanvas.add_step_below | 384-390 | presentation/co4e/co4e_canvas_widget.py | orchestration thuần, ủy quyền cho add_node (bản thân không gọi trực tiếp API Qt) | chua/khong ro | - | +| Co4ECanvas._chain_tail | 392-396 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.add_palette_step | 398-400 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.begin_connect | 402-403 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._finish_connect | 405-409 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.begin_port_drag | 412-419 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.update_port_drag | 421-424 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.finish_port_drag | 426-435 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._node_at | 437-441 | presentation/co4e/co4e_canvas_widget.py | dùng self._scene.items(scene_pt) — cần scene đang sống | chua/khong ro | - | +| Co4ECanvas._make_edge | 443-451 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._add_edge_item | 453-456 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.delete_edge | 458-463 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.delete_node | 465-475 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.delete_selected | 477-481 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._zoom_by | 484-495 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.zoom_in | 497-498 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.zoom_out | 500-501 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.reset_zoom | 503-505 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.wheelEvent | 507-519 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.mousePressEvent | 522-529 | presentation/co4e/co4e_canvas_widget.py | trùng tên với _NodeItem.mousePressEvent nhưng là override của Co4ECanvas (pan chuột giữa) — đừng nhầm khi gộp map | chua/khong ro | - | +| Co4ECanvas.mouseMoveEvent | 531-540 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.mouseReleaseEvent | 542-548 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.fit_view | 550-558 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.relayout | 560-578 | presentation/co4e/co4e_canvas_widget.py | phần tính waves/cols (compute_waves, defaultdict) là logic thuần, phần item.setPos() cần scene sống — có thể tách hàm tính toạ độ ra khỏi phần apply nếu muốn test thuần Python | chua/khong ro | - | +| Co4ECanvas.relayout_if_vertical | 580-589 | presentation/co4e/co4e_canvas_widget.py | bản thân chỉ ra quyết định thuần dựa trên node.x, việc chạm Qt nằm trong relayout() được gọi | chua/khong ro | - | +| Co4ECanvas.add_workflow | 591-610 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.update_node_status | 612-616 | presentation/co4e/co4e_canvas_widget.py | được co4e_run_control_widget.py gọi khi step chạy/xong/lỗi — điểm nối giữa canvas và run control | chua/khong ro | - | +| Co4ECanvas.reset_statuses | 618-621 | presentation/co4e/co4e_canvas_widget.py | được co4e_run_control_widget.py gọi khi bắt đầu run mới | chua/khong ro | - | +| Co4ECanvas.refresh_node | 623-626 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas._node_rects | 628-638 | presentation/co4e/co4e_canvas_widget.py | dựng QRectF như kiểu giá trị từ item.pos() — logic hình học thuần | chua/khong ro | - | +| Co4ECanvas._reposition_edges | 640-649 | presentation/co4e/co4e_canvas_widget.py | gọi e.update_path (setPath) trên item sống, dùng hàm định tuyến _route từ canvas_geometry.py | chua/khong ro | - | +| Co4ECanvas.keyPressEvent | 652-669 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.dragEnterEvent | 671-675 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.dragMoveEvent | 677-681 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ECanvas.dropEvent | 683-701 | presentation/co4e/co4e_canvas_widget.py | [GỘP 2 lượt quét trùng ký hiệu] (dòng 683-700, target gốc=presentation/co4e/co4e_canvas_widget.py) cắt ngang lát — cần agent gộp đối chiếu (thân try chưa đóng ở dòng 700, còn tiếp; xử lý JSON từ mimeData trong bộ nhớ, không phải file đĩa nên touches_disk_or_network=false) \|\| (dòng 683-701, target gốc=presentation/co4e/co4e_canvas_widget.py) cắt ngang lát — cần agent gộp đối chiếu. Method dropEvent bắt đầu ở dòng 683 (ngoài khoảng được giao 701-791), chỉ dòng 701 (e.acceptProposedAction()) nằm trong lát này; dòng 702 là dòng trống cuối file. File ui/co4e_canvas.py chỉ có 702 dòng — không có nội dung nào khác trong khoảng 702-791 vì đã hết file. Xử lý drop từ sidebar (kind=='workflow' → add_workflow, ngược lại → add_palette_step) — logic thao tác node/canvas nên khớp nhóm _add_node/_connect_nodes trong bảng plan.md dòng 623 dù plan.md không liệt kê rõ dropEvent. | co | nnect_nodes trong bảng plan.md dòng 623 dù plan.md không liệt kê rõ dropEvent. | +| Co4ETab.canvas | 856 | presentation/co4e/co4e_canvas_widget.py | TRẠNG THÁI CHIA SẺ lớn nhất trong file — self.canvas được đọc/ghi ở gần như mọi nhóm chức năng khác (sync_wf_from_canvas, apply_workflow, node selection, run, add_blank_step...). | chua/khong ro | - | +| Co4ETab._build_canvas_overlay | 1041-1062 | presentation/co4e/co4e_canvas_widget.py | dựng nút zoom/fit gắn vào self.canvas.add_overlay(bar); các slot gọi thẳng self.canvas.zoom_in/zoom_out/fit_view (thuộc nhóm 3.2.2.21-22 trong plan.md → co4e_canvas_widget.py). Có thể tranh cãi nên giữ ở co4e_tab.py (được gọi từ _build_center) — ghi lại để người soát quyết. | co | - | +| Co4ETab.zoom_in_btn | 1054 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.zoom_out_btn | 1055 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.fit_btn | 1056 | presentation/co4e/co4e_canvas_widget.py | (không có ghi chú) | chua/khong ro | - | +| _skill_names | 61-65 | presentation/co4e/co4e_chat_view.py | gọi skills_mod.list_skills()/builtin_skills() (đọc đĩa); dùng cho autocomplete /skill: trong _ChatInput — cũng liên quan skills_list_panel.py vì cùng nguồn dữ liệu | chua/khong ro | - | +| _agent_names | 68-71 | presentation/co4e/co4e_chat_view.py | gọi co4e.list_custom_agents() (đọc đĩa); dùng cho autocomplete /agent: trong _ChatInput — cũng liên quan agent_list_panel.py vì cùng nguồn dữ liệu | chua/khong ro | - | +| _directive_token | 122-134 | presentation/co4e/co4e_chat_view.py | logic regex thuần Python, test được không cần Qt | chua/khong ro | - | +| _ChatInput | 137-226 | presentation/co4e/co4e_chat_view.py | khai báo 'submit = Signal()' ở dòng 141 là thuộc tính lớp (không phải self.) | chua/khong ro | - | +| _ChatInput.__init__ | 143-151 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| _ChatInput._popup | 145 | presentation/co4e/co4e_chat_view.py | QListWidget popup autocomplete | chua/khong ro | - | +| _ChatInput._maybe_popup | 153-178 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| _ChatInput._add_row | 180-184 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| _ChatInput._accept | 186-199 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| _ChatInput.focusOutEvent | 201-204 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| _ChatInput.keyPressEvent | 206-226 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._chat_worker | 236 | presentation/co4e/co4e_chat_view.py | AgentWorker của chat, hiện giữ trên Co4ETab | chua/khong ro | - | +| Co4ETab._build_chat | 1064-1127 | presentation/co4e/co4e_chat_view.py | dài ~63 dòng, gộp: header 'Messages' + toggle, chat_stack (QStackedWidget chứa 1 ChatView/flow), input row + usage label + composer + routing toggle. Tạo self._flow_logs (Dict[str, ChatView]) — TRẠNG THÁI CHIA SẺ dùng bởi _ensure_flow_log/_active_log/chat_log/_apply_workflow (self._wf) — điểm dễ vỡ nhất khi tách file chat ra khỏi co4e_tab.py. | chua/khong ro | - | +| Co4ETab._chat_widget | 1066 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._mhdr | 1072 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.msgs_icon | 1074 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.msgs_title | 1075 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.chat_toggle_btn | 1076 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.chat_stack | 1091 | presentation/co4e/co4e_chat_view.py | chuyển self.center_stack tương tự — dùng chung với self.center_stack (co4e_tab.py). | chua/khong ro | - | +| Co4ETab._flow_logs | 1092 | presentation/co4e/co4e_chat_view.py | Dict[str, ChatView] keyed theo workflow id — TRẠNG THÁI CHIA SẺ chính của toàn bộ logic chat theo-flow; đọc/ghi bởi _ensure_flow_log, _active_log, chat_log, _apply_workflow, và các hàm chat khác ngoài phạm vi đọc (>1400). | chua/khong ro | - | +| Co4ETab.chat_input_row | 1094 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._usage_total_lbl | 1099 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.chat_input | 1105 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.chat_send_btn | 1108 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.co4e_routing_toggle | 1113 | presentation/co4e/co4e_chat_view.py | RoutingToggle(self.ctx, 'co4e') — self.ctx là trạng thái chia sẻ của cả Co4ETab (khởi tạo ngoài phạm vi đọc). | chua/khong ro | - | +| Co4ETab._co4e_routed_provider | 1114; 1853 | presentation/co4e/co4e_chat_view.py | [GỘP 2 lượt quét trùng ký hiệu] (dòng 1114-1114, target gốc=presentation/co4e/co4e_chat_view.py) override provider cho lượt chat kế tiếp — dùng bởi _apply_co4e_routing (ngoài phạm vi đọc, >1400). \|\| (dòng 1853-1853, target gốc=presentation/co4e/co4e_chat_view.py) gán None lần đầu tại đây (trong _apply_co4e_routing); đọc bằng getattr(self, '_co4e_routed_provider', None) ở _run_chat_turn dòng ~1922 — gợi ý có thể không được init trong __init__. Trạng thái routing theo từng lượt chat, dùng chung giữa chat-view và _start_canvas_run/manager.start. | chua/khong ro | [GỘP 2 lượt quét trùng ký hiệu] (dòng 1114-1114, target gốc=presentation/co4e/co4e_chat_view.py) overr | +| Co4ETab._vsplit_sizes | 1121 | presentation/co4e/co4e_chat_view.py | dùng bởi _toggle_messages để restore kích thước splitter — chia sẻ với self._vsplit (co4e_tab.py). | chua/khong ro | - | +| Co4ETab._msgs_collapsed | 1122 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._toggle_messages | 1129-1161 | presentation/co4e/co4e_chat_view.py | thao tác self._vsplit (tạo ở co4e_tab.py/_build_center) — trạng thái chia sẻ giữa co4e_chat_view.py và co4e_tab.py. | chua/khong ro | - | +| Co4ETab._ensure_flow_log | 1164-1173 | presentation/co4e/co4e_chat_view.py | đọc/ghi self._flow_logs — trạng thái chia sẻ chính của chat theo-flow. | chua/khong ro | - | +| Co4ETab._active_log | 1175-1177 | presentation/co4e/co4e_chat_view.py | đọc self._wf — trạng thái chia sẻ với toàn bộ Co4ETab (canvas, sidebar, save/autosave, run control). | chua/khong ro | - | +| Co4ETab.chat_log | 1180-1183 | presentation/co4e/co4e_chat_view.py | @property, chỉ đọc, uỷ nhiệm cho _active_log(). | chua/khong ro | - | +| Co4ETab._plan_bubble | 1186-1187 | presentation/co4e/co4e_chat_view.py | @property getter, đọc self._active_log()._co4e_plan_bubble (thuộc tính gắn thêm vào từng instance ChatView). | chua/khong ro | - | +| Co4ETab._plan_bubble (setter) | 1189-1191 | presentation/co4e/co4e_chat_view.py | @_plan_bubble.setter, ghi self._active_log()._co4e_plan_bubble. | chua/khong ro | - | +| Co4ETab._chat_send | 1820-1846 | presentation/co4e/co4e_chat_view.py | self.chat_input.clear(), self._append_chat — thao tác widget; điều phối /agent /skill directive rồi gọi self._run_chat_turn (network qua provider, không trực tiếp trong hàm này) | chua/khong ro | - | +| Co4ETab._apply_co4e_routing | 1848-1883 | presentation/co4e/co4e_chat_view.py | gọi confirm_switch (dialog Qt) khi mode=='manual' và self._append_chat khi có switch — cần widget sống. Gán self._co4e_routed_provider (xem attribute riêng). | chua/khong ro | - | +| Co4ETab._extract_agent_directive | 1885-1891 | presentation/co4e/co4e_chat_view.py | regex thuần Python | chua/khong ro | - | +| Co4ETab._resolve_agent | 1893-1901 | presentation/co4e/co4e_chat_view.py | tra cứu BUILTIN_AGENTS và co4e.list_custom_agents() (bộ nhớ/đĩa tùy triển khai list_custom_agents, không rõ trong khoảng đọc) — cross-reference với agent_list_panel.py (nguồn danh sách custom agent) | chua/khong ro | - | +| Co4ETab._run_chat_turn | 1903-1974 | presentation/co4e/co4e_chat_view.py | 72 dòng, gộp: chuẩn bị prompt, tạo bubble stream, định nghĩa 4 closures nội bộ (job/on_event/done/failed) và khởi worker nền — nên tách các closures ra thành hàm riêng nếu dễ đọc hơn. Closure job() gọi run_cowork(provider,...) — network/AI call thật sự. Đọc/ghi self._chat_worker, self._co4e_routed_provider, self.chat_send_btn, self._wf; set log._co4e_plan_bubble=None (thuộc log là ChatView, không phải self). | chua/khong ro | - | +| Co4ETab._run_chat_turn.job | 1917-1946 | presentation/co4e/co4e_chat_view.py | closure nội bộ của _run_chat_turn, chạy trong AgentWorker (thread nền); gọi run_cowork(provider,...) — network/AI call thật; dùng usage_tracker (đọc/ghi trạng thái tích lũy usage) | chua/khong ro | - | +| Co4ETab._run_chat_turn.on_event | 1948-1954 | presentation/co4e/co4e_chat_view.py | closure nội bộ, cập nhật assistant.set_markdown và log.scroll_to_bottom (widget) | chua/khong ro | - | +| Co4ETab._run_chat_turn.done | 1956-1962 | presentation/co4e/co4e_chat_view.py | closure nội bộ, gán self._chat_worker = None, thao tác widget assistant/log | chua/khong ro | - | +| Co4ETab._run_chat_turn.failed | 1964-1967 | presentation/co4e/co4e_chat_view.py | closure nội bộ, gán self._chat_worker = None, gọi self._append_chat lỗi | chua/khong ro | - | +| Co4ETab._append_chat | 1976-1991 | presentation/co4e/co4e_chat_view.py | nhận tham số log tùy chọn, mặc định self.chat_log — dùng bởi rất nhiều method ở cả run-control (qua tham số log truyền vào) và chat-view; điểm nối giữa hai nhóm. | chua/khong ro | - | +| Co4ETab._fmt_usage | 1994-2001 | presentation/co4e/co4e_chat_view.py | format chuỗi thuần, đọc self.ctx.config.data — không chạm widget | chua/khong ro | - | +| Co4ETab._apply_usage | 2003-2020 | presentation/co4e/co4e_chat_view.py | bub.add_usage(...) thao tác widget bubble; ghi self._flow_usage[wf_id] — trạng thái tổng usage theo flow, dùng chung với _refresh_usage_total | chua/khong ro | - | +| Co4ETab._refresh_usage_total | 2022-2037 | presentation/co4e/co4e_chat_view.py | self._usage_total_lbl.setText — đọc self._wf, self._flow_usage | chua/khong ro | - | +| Co4ETab._append_diff | 2039-2043 | presentation/co4e/co4e_chat_view.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._append_plan | 2045-2056 | presentation/co4e/co4e_chat_view.py | đọc/ghi log._co4e_plan_bubble (thuộc tính động trên đối tượng log/ChatView, không phải self) | chua/khong ro | - | +| _html_escape | 2082-2083 | presentation/co4e/co4e_chat_view.py | hàm module-level (ngoài class Co4ETab), escape HTML thuần, dùng cho hiển thị chat | chua/khong ro | - | +| _PLAN_GLYPH | 45-46 | presentation/co4e/co4e_run_control_widget.py | module-level dict glyph trạng thái dùng bởi _fmt_plan | chua/khong ro | - | +| _fmt_plan | 49-58 | presentation/co4e/co4e_run_control_widget.py | helper thuần Python dùng bởi _render_plan() | chua/khong ro | - | +| Co4ETab.manager | 238 | presentation/co4e/co4e_run_control_widget.py | Co4ERunManager — lõi run control, trạng thái chia sẻ với canvas (node status) và chat view (run_logs) | chua/khong ro | - | +| Co4ETab._flow_runs | 243 | presentation/co4e/co4e_run_control_widget.py | map wf_id->run id, chia sẻ với _open_flow/_close_flow_tab (co4e_tab.py) và canvas | chua/khong ro | - | +| Co4ETab._run_logs | 244 | presentation/co4e/co4e_run_control_widget.py | map run_id->ChatView, chia sẻ với co4e_chat_view.py | chua/khong ro | - | +| Co4ETab._flow_usage | 248 | presentation/co4e/co4e_run_control_widget.py | usage token/cost theo flow, hiển thị ở Messages header | chua/khong ro | - | +| Co4ETab._manual_active | 252 | presentation/co4e/co4e_run_control_widget.py | chia sẻ với _close_flow_tab (co4e_tab.py) — set lại self.run_btn khi đóng tab | chua/khong ro | - | +| Co4ETab._manual_order | 253 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._manual_idx | 254 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._cur_run_id | 460-473 | presentation/co4e/co4e_run_control_widget.py | logic thuần Python, không gọi Qt trực tiếp | chua/khong ro | - | +| Co4ETab._update_run_btn | 480-482 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.runs_more_btn | 586 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.runs_side_list | 594 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._SIDE_RUNS | 605 | presentation/co4e/co4e_run_control_widget.py | class-level constant, không phải self. | chua/khong ro | - | +| Co4ETab._refresh_side_runs | 607-619 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._on_side_run_clicked | 621-629 | presentation/co4e/co4e_run_control_widget.py | chạm self.runs_table (định nghĩa ngoài khoảng đọc — thuộc trang Flow Status) | chua/khong ro | - | +| Co4ETab.mode_combo | 828 | presentation/co4e/co4e_run_control_widget.py | combo chọn run mode auto/plan/manual — thuộc nhóm _set_run_mode() trong plan.md dù được dựng bên trong _build_center (co4e_tab.py); ranh giới tách file ở đây dễ vỡ. | co | - | +| Co4ETab.run_btn | 833 | presentation/co4e/co4e_run_control_widget.py | nút Run — tương tự mode_combo, dựng trong _build_center nhưng thuộc nhóm run control; cũng bị _update_run_btn (<701), _on_run_clicked, _on_mode_changed đọc/ghi text. | chua/khong ro | - | +| Co4ETab.runs_btn | 840 | presentation/co4e/co4e_run_control_widget.py | toggle chuyển sang trang Runs (self.center_stack) — chia sẻ state center_stack với co4e_tab.py. | chua/khong ro | - | +| Co4ETab._build_runs_page | 873-932 | presentation/co4e/co4e_run_control_widget.py | dựng trang bảng Runs (theo dõi mọi run của mọi flow) — dùng self.manager (Co4ERunManager, sẽ thay bằng co4e_workflow_service) — trạng thái chia sẻ. | chua/khong ro | - | +| Co4ETab.runs_back_btn | 882 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.runs_title | 887 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.ws_folder_btn | 892 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.run_stop_btn | 900 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.run_rename_btn | 905 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.run_del_btn | 909 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.run_clear_btn | 913 | presentation/co4e/co4e_run_control_widget.py | clicked gọi self.manager.clear_finished() — trạng thái chia sẻ self.manager. | chua/khong ro | - | +| Co4ETab.runs_table | 921 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._current_mode | 1384-1385 | presentation/co4e/co4e_run_control_widget.py | đọc self.mode_combo — khớp nhóm _set_run_mode() dòng 624 plan.md. | co | - | +| Co4ETab._on_mode_changed | 1387-1393 | presentation/co4e/co4e_run_control_widget.py | reset self._manual_active/_manual_order/_manual_idx (trạng thái chia sẻ với luồng manual step _manual_step/_manual_run_or_advance, ngoài phạm vi đọc >1400) và gọi self._cur_run_id() (chia sẻ với self.manager). | chua/khong ro | - | +| Co4ETab._on_run_clicked | 1395-1400 | presentation/co4e/co4e_run_control_widget.py | cắt ngang lát — cần agent gộp đối chiếu (tiếp tục sau dòng 1400). Dùng self.manager.stop() và self._cur_run_id() — trạng thái chia sẻ với co4e_workflow_service tương lai. Khớp nhóm _run_flow()/_stop_flow() dòng 618 plan.md (dù đó là bản service, đây là UI handler nút Run). | co | - | +| Co4ETab. | 1401-1405 | presentation/co4e/co4e_run_control_widget.py | cắt ngang lát — cần agent gộp đối chiếu. Định nghĩa (def ...) nằm ở lát trước dòng 1401 nên tên chính xác không xác định được; đoạn thấy được chỉ dispatch theo self._current_mode() sang _manual_run_or_advance() hoặc _start_canvas_run() — thuộc nhóm Run/mode. | chua/khong ro | (def ...) nằm ở lát trước dòng 1401 nên tên chính xác không xác định được; đoạn thấy được chỉ dispatch theo self._current_mode() sang _manual_run_or | +| Co4ETab._start_canvas_run | 1407-1424 | presentation/co4e/co4e_run_control_widget.py | gọi self.manager.start(...) — spawn chạy flow (dẫn tới gọi provider AI ở tầng khác); đọc/ghi self._wf, self._flow_runs, self._flow_runs[wf_id], self._run_logs, self.chat_log — trạng thái chia sẻ giữa run-control và chat-view. self.manager (Co4ERunManager) nên đổi sang application/workflows/co4e_workflow_service.py theo mapping. | chua/khong ro | - | +| Co4ETab._run_single | 1426-1431 | presentation/co4e/co4e_run_control_widget.py | wrapper mỏng gọi _start_canvas_run; đọc self._wf.id | chua/khong ro | - | +| Co4ETab._run_from | 1433-1437 | presentation/co4e/co4e_run_control_widget.py | wrapper mỏng gọi _start_canvas_run với self._downstream(node_id) | chua/khong ro | - | +| Co4ETab._downstream | 1439-1450 | presentation/co4e/co4e_run_control_widget.py | thuật toán BFS thuần Python, chỉ đọc self.canvas.edges() làm input — test được với danh sách edge giả lập, không cần canvas thật | chua/khong ro | - | +| Co4ETab._manual_run_or_advance | 1453-1466 | presentation/co4e/co4e_run_control_widget.py | gọi self.canvas.reset_statuses() và self._append_chat (self._append_chat thuộc nhóm chat-view) — cắt ngang giữa run-control và chat-view. Đọc/ghi self._manual_active, self._manual_order, self._manual_idx, self._wf, self._outputs_for(...), self._plan_bubble — trạng thái run thuần túy chia sẻ với _manual_step. | chua/khong ro | - | +| Co4ETab._manual_step | 1468-1484 | presentation/co4e/co4e_run_control_widget.py | gọi self.manager.start(...) (network/AI qua provider) và self.run_btn.setText, self._append_chat (chat-view); đọc/ghi self._manual_idx, self._manual_order, self._wf, self._flow_runs, self._run_logs, self.chat_log — trạng thái chia sẻ rộng giữa run-control và chat-view. | chua/khong ro | - | +| Co4ETab._topo_order | 1486-1491 | presentation/co4e/co4e_run_control_widget.py | đọc self.canvas.nodes()/edges() làm dữ liệu đầu vào, logic tính toán thuần túy (co4e.compute_waves) — test được với dữ liệu giả | chua/khong ro | - | +| Co4ETab._on_manager_event | 1494-1550 | presentation/co4e/co4e_run_control_widget.py | method dài (57 dòng), gộp nhiều việc không liên quan: định tuyến sự kiện chạy theo từng flow (routing run_id -> log), cập nhật trạng thái node trên canvas, hiển thị bubble chat (assistant/diff/plan/tool-failed — thuộc co4e_chat_view.py), xử lý hoàn tất run (run_done/run_error), hiển thị popup thông báo, cập nhật status bar. Nên tách phần hiển thị chat (self._append_chat/_append_diff/_append_plan) sang co4e_chat_view.py, giữ phần routing/flow-completion ở co4e_run_control_widget.py. Đọc/ghi self._flow_runs, self._run_logs, self.chat_log, self.canvas, self._wf, self._outputs_for(...), self._manual_active, self._manual_idx — trạng thái chia sẻ rất rộng, điểm dễ vỡ nhất khi tách file. | chua/khong ro | - | +| Co4ETab._notify_run_finished | 1552-1573 | presentation/co4e/co4e_run_control_widget.py | tạo QMessageBox không chặn; khởi tạo lazy self._run_popups (xem attribute riêng) | chua/khong ro | - | +| Co4ETab._run_popups | 1560-1561 | presentation/co4e/co4e_run_control_widget.py | khởi tạo lazy (list rỗng) trong _notify_run_finished qua hasattr guard — không init trong __init__; giữ ref các QMessageBox non-blocking khỏi bị GC | chua/khong ro | - | +| Co4ETab._refresh_runs | 1575-1616 | presentation/co4e/co4e_run_control_widget.py | render bảng runs_table + gọi self._refresh_side_runs() (sidebar) + cập nhật self.flow_bar.setTabText và self._sections['co4e.runs_tab'] — self._sections và self.flow_bar là trạng thái chia sẻ với co4e_tab.py (container/sidebar). | chua/khong ro | - | +| Co4ETab._stop_selected_run | 1618-1624 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._delete_selected_run | 1626-1639 | presentation/co4e/co4e_run_control_widget.py | đọc/ghi self._flow_runs, self._run_logs — trạng thái chia sẻ với _on_manager_event/_start_canvas_run | chua/khong ro | - | +| Co4ETab._runs_context_menu | 1641-1655 | presentation/co4e/co4e_run_control_widget.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._open_run_output_folder | 1704-1715 | presentation/co4e/co4e_run_control_widget.py | path.mkdir + open_location (spawn process); dùng bởi _runs_context_menu 'Open output' | chua/khong ro | - | +| Co4ETab._rename_selected_run | 1717-1748 | presentation/co4e/co4e_run_control_widget.py | gọi co4e.save_workflow(wf) (ghi đĩa); đọc/ghi self._flows (list flow của sidebar/tab-bar), self.flow_bar, self.name_edit, self._wf — chạm nhiều trạng thái chia sẻ với co4e_tab.py container (tab bar + name edit thuộc header, không rõ nằm ở panel nào) — rủi ro vỡ cao khi tách. | chua/khong ro | - | +| Co4ETab._run_selected_in_background | 1750-1760 | presentation/co4e/co4e_run_control_widget.py | gọi self.manager.start(...) (network/AI) và self._refresh_side_runs() (widget) | chua/khong ro | - | +| Co4ETab._wf_by_id | 1762-1770 | presentation/co4e/co4e_run_control_widget.py | gọi co4e.get_workflow(wf_id) (đọc đĩa) và self._sync_wf_from_canvas() (không nằm trong khoảng đọc) — đọc self._wf; dùng chung bởi _rerun_run_item/_open_run_from_table (Runs tab) và có thể cả co4e_tab.py container | chua/khong ro | - | +| Co4ETab._rerun_run_item | 1772-1783 | presentation/co4e/co4e_run_control_widget.py | gọi self.manager.start(...) (network/AI) | chua/khong ro | - | +| Co4ETab._open_run_from_table | 1785-1804 | presentation/co4e/co4e_run_control_widget.py | gọi self._open_flow(wf) (không nằm trong khoảng đọc, theo plan.md thuộc co4e_tab.py) và self.canvas.update_node_status — nối Runs tab với việc mở flow trên canvas, điểm khớp nối giữa run-control và container/canvas. | co | - | +| _qcolor | 2086-2088 | presentation/co4e/co4e_run_control_widget.py | hàm module-level (ngoài class Co4ETab), tạo QColor từ hex string — dùng kiểu giá trị QColor, không cần QApplication sống; dùng trong _refresh_runs để tô màu status | chua/khong ro | - | +| _EqualTabBar | 74-94 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| _EqualTabBar._GAP | 80 | presentation/co4e/co4e_tab.py | class-level constant, không phải self. | chua/khong ro | - | +| _EqualTabBar.tabSizeHint | 82-90 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| _EqualTabBar.resizeEvent | 92-94 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab | 229-700 | presentation/co4e/co4e_tab.py | Lớp kéo dài quá dòng 700 (cắt ngang lát) — chỉ ghi nhận phần 229-700; 'status_message = Signal(str)' dòng 230 là thuộc tính lớp, không phải self. | chua/khong ro | - | +| Co4ETab.__init__ | 232-304 | presentation/co4e/co4e_tab.py | method 73 dòng, gộp: khởi state run/flow, dựng splitter 3 cột (sidebar/center/config), wiring canvas & config panel, gọi _reload_sidebar (đọc đĩa qua co4e.list_workflows) và _open_flow; chạm rất nhiều thuộc tính chia sẻ: self._wf, self._flows, self.manager, self._flow_runs, self._run_logs, self._flow_outputs, self._flow_usage, self.config, self.canvas (gán ở _build_center ngoài khoảng đọc này) | chua/khong ro | - | +| Co4ETab.ctx | 234 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._wf | 235 | presentation/co4e/co4e_tab.py | trạng thái chia sẻ — đọc/ghi bởi canvas, run control, chat view | chua/khong ro | - | +| Co4ETab._flows | 257 | presentation/co4e/co4e_tab.py | danh sách flow đang mở dạng tab — trạng thái chia sẻ nhạy cảm (nêu rõ trong hướng dẫn đề bài) | chua/khong ro | - | +| Co4ETab._active_flow_idx | 258 | presentation/co4e/co4e_tab.py | chỉ số tab đang active — chia sẻ giữa _open_flow, _on_flow_tab_changed, _reflect_active_run | chua/khong ro | - | +| Co4ETab._split | 261 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._config_collapsed | 274 | presentation/co4e/co4e_tab.py | trạng thái cho _toggle_config (định nghĩa dòng 989, ngoài khoảng đọc); plan.md xếp _toggle_config ở co4e_tab.py container | co | - | +| Co4ETab._config_expanded_w | 275; 995 | presentation/co4e/co4e_tab.py | [GỘP 2 lượt quét trùng ký hiệu] (dòng 275-275, target gốc=presentation/co4e/co4e_tab.py) cùng lý do với _config_collapsed \|\| (dòng 995-995, target gốc=presentation/co4e/co4e_tab.py) gán trong nhánh collapse của _toggle_config; có thể đã khởi tạo trong __init__ (ngoài phạm vi đọc). | chua/khong ro | [GỘP 2 lượt quét trùng ký hiệu] (dòng 275-275, target gốc=presentation/co4e/co4e_tab.py) cùng lý do vớ | +| Co4ETab._narrow_guard | 280 | presentation/co4e/co4e_tab.py | gắn với _apply_narrow_layout (dòng 977, ngoài khoảng đọc) | chua/khong ro | - | +| Co4ETab._open_flow | 307-338 | presentation/co4e/co4e_tab.py | khớp plan.md: _open_flow() -> co4e_tab.py, gọi canvas; chạm self._flows, self.flow_bar (định nghĩa ngoài khoảng đọc), self.canvas | co | - | +| Co4ETab._close_other_flows | 340-355 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._show_runs | 357-367 | presentation/co4e/co4e_tab.py | chuyển đổi center_stack giữa flow editor và Runs table — liên quan Flow Status (run control) | chua/khong ro | - | +| Co4ETab._on_flow_tab_changed | 369-385 | presentation/co4e/co4e_tab.py | chạm self.center_stack (định nghĩa ngoài khoảng đọc, ở _build_center) | chua/khong ro | - | +| Co4ETab._sync_runs_toggle | 387-394 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._add_tab_close_button | 396-406 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._close_flow_tab_button | 408-412 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._close_flow_tab | 414-442 | presentation/co4e/co4e_tab.py | chạm self._flow_runs/_run_logs/_manual_active/self.run_btn (chia sẻ với run control widget) | chua/khong ro | - | +| Co4ETab._sync_active_flow_tab_text | 444-447 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._build_sidebar | 485-603 | presentation/co4e/co4e_tab.py | >80 dòng (119 dòng) — gộp dựng 4 section (Workflows/Agents/Skills/Runs) + wiring nhiều nút bấm; nên tách theo section: Workflows giữ ở container, Agents nên chuyển agent_list_panel.py, Skills đã tách (chỉ còn wiring), Runs nên chuyển co4e_run_control_widget.py | chua/khong ro | - | +| Co4ETab._sections | 493 | presentation/co4e/co4e_tab.py | trạng thái chia sẻ (nêu rõ trong hướng dẫn đề bài) — dùng bởi _fold_section, _sync_section_arrow | chua/khong ro | - | +| Co4ETab.sidebar | 494 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.side_split | 498 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| _Col | 503-511 | presentation/co4e/co4e_tab.py | adapter nội bộ định nghĩa bên trong _build_sidebar, chỉ dùng tại chỗ | chua/khong ro | - | +| _Col.__init__ | 506-507 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| _Col.addWidget | 509-511 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.wf_new_btn | 516 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.wf_list | 527 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.wf_edit_btn | 534 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.wf_dup_btn | 535 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.wf_del_btn | 536 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.wf_runbg_btn | 543 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._skills_panel | 575 | presentation/co4e/co4e_tab.py | instantiate SkillsListPanel đã tách; Co4ETab giữ wiring theo comment trong code (dòng 571-574) | chua/khong ro | - | +| Co4ETab.sk_manage_btn | 576 | presentation/co4e/co4e_tab.py | cùng lý do với _skills_panel | chua/khong ro | - | +| Co4ETab.skill_list | 578 | presentation/co4e/co4e_tab.py | cùng lý do với _skills_panel | chua/khong ro | - | +| Co4ETab._section | 631-663 | presentation/co4e/co4e_tab.py | chạm self._sections (chia sẻ) — helper dựng section sidebar dùng chung | chua/khong ro | - | +| Co4ETab._fold_section | 665-677 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._sync_section_arrow | 679-681 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._icon_btn | 683-687 | presentation/co4e/co4e_tab.py | helper dùng chung tạo nút icon, dùng bởi cả section Workflows và Agents | chua/khong ro | - | +| Co4ETab._reload_sidebar | 689-722 | presentation/co4e/co4e_tab.py | [GỘP 2 lượt quét trùng ký hiệu] (dòng 689-700, target gốc=presentation/co4e/co4e_tab.py) cắt ngang lát — cần agent gộp đối chiếu (method tiếp tục sau dòng 700); gọi co4e.list_workflows() (đọc đĩa) rồi dựng QListWidgetItem trực tiếp trong cùng hàm — trộn data-fetch và UI, nên tách phần đọc dữ liệu sang co4e_workflow_service.py \|\| (dòng 689-722, target gốc=unsure) cắt ngang lát — cần agent gộp đối chiếu (bắt đầu trước dòng 701). Gộp refresh cả agent_list và skill_list trong cùng 1 hàm — nên tách thành _refresh_agents_list (agent_list_panel.py) và _refresh_skills_list (skills_list_panel.py) như plan.md yêu cầu; gọi co4e.list_custom_agents() (đĩa) và skills_mod.skill_prefix_for (đĩa). | co | [GỘP 2 lượt quét trùng ký hiệu] (dòng 689-700, target gốc=presentation/co4e/co4e_tab.py) cắt ngang lát | +| Co4ETab._build_center | 731-871 | presentation/co4e/co4e_tab.py | dài ~140 dòng, làm nhiều việc không liên quan: dựng flow tab bar (ẩn, không hiển thị cho user), dựng runs-page stack, toolbar flow (name_edit/save/save_tpl/mode_combo/run_btn/runs_btn), tạo canvas, gọi _build_canvas_overlay, tạo chat widget, splitter dọc self._vsplit. Nên tách nhỏ. Đọc self._wf.name (dòng 814) và tạo self.center_stack — TRẠNG THÁI CHIA SẺ dùng bởi _show_runs/_apply_workflow (ngoài phạm vi đọc). Khớp phần '_build_canvas()' trong bảng plan.md dòng 615. | co | - | +| Co4ETab.flow_bar | 738 | presentation/co4e/co4e_tab.py | QTabBar bị ẩn (setVisible False dòng 802), chỉ dùng làm index nội bộ ánh xạ flow↔canvas — trạng thái chia sẻ với _on_flow_tab_changed/_close_flow_tab (định nghĩa <701, ngoài phạm vi đọc). | chua/khong ro | - | +| Co4ETab.flow_add_btn | 764 | presentation/co4e/co4e_tab.py | ẩn (setVisible False), không hiển thị cho user hiện tại. | chua/khong ro | - | +| Co4ETab.flow_scroll | 781 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.center_stack | 805 | presentation/co4e/co4e_tab.py | TRẠNG THÁI CHIA SẺ — chuyển đổi giữa trang Runs (co4e_run_control_widget) và trang flow editor; dùng bởi _show_runs (ngoài phạm vi đọc) và _apply_workflow. | chua/khong ro | - | +| Co4ETab.name_edit | 814 | presentation/co4e/co4e_tab.py | khởi tạo từ self._wf.name — trạng thái chia sẻ; cũng bị _on_name_changed/_new_workflow đọc/ghi. | chua/khong ro | - | +| Co4ETab.add_step_btn | 819 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.save_btn | 822 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.save_tpl_btn | 826 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._vsplit | 863 | presentation/co4e/co4e_tab.py | splitter dọc canvas/chat — dùng chung với _toggle_messages (co4e_chat_view.py thao tác self._vsplit.setSizes) — trạng thái chia sẻ giữa co4e_tab.py và co4e_chat_view.py. | chua/khong ro | - | +| Co4ETab._NARROW | 971 | presentation/co4e/co4e_tab.py | hằng class-level (không phải self.), ngưỡng chiều rộng dùng bởi _apply_narrow_layout. | chua/khong ro | - | +| Co4ETab.showEvent | 973-975 | presentation/co4e/co4e_tab.py | Qt override, gọi self._narrow_guard.attach() (đối tượng khởi tạo ngoài phạm vi đọc, <701). [ANOMALY: cùng tên method định nghĩa 2 lần ở 2 dòng khác nhau trong cùng class -- có khả năng là lỗi nguồn (định nghĩa sau đè định nghĩa trước), không phải do quét trùng; giữ 2 dòng riêng, cần người quyết định định nghĩa nào còn hiệu lực] | chua/khong ro | ợng khởi tạo ngoài phạm vi đọc, <701). [ANOMALY: cùng tên method định nghĩa 2 lần ở 2 dòng khác nhau trong cùng class -- có khả | +| Co4ETab._apply_narrow_layout | 977-987 | presentation/co4e/co4e_tab.py | so self._config_collapsed rồi gọi self._toggle_config() — trạng thái chia sẻ với node_property_panel wrap logic. | chua/khong ro | - | +| Co4ETab._toggle_config | 989-1032 | presentation/co4e/co4e_tab.py | dài 44 dòng, gộp: ẩn/hiện self.config (widget thuộc node_property_panel.py), đổi icon, tính lại self._split.setSizes, gọi _refresh_min_width — thao tác trực tiếp self.config/self.config_container (node_property_panel.py) và self._split (co4e_tab.py) cùng lúc — ranh giới tách file dễ vỡ nhất ở đoạn này. Ghi self._config_expanded_w. | chua/khong ro | - | +| Co4ETab._refresh_min_width | 1034-1039 | presentation/co4e/co4e_tab.py | thao tác trực tiếp self._split (QSplitter) và self.config_container — chia sẻ với _build_center/_wrap_config. | chua/khong ro | - | +| Co4ETab._apply_workflow | 1194-1207 | presentation/co4e/co4e_tab.py | hàm điều phối trung tâm khi mở 1 flow: gán self._wf (TRẠNG THÁI CHIA SẺ dùng khắp mọi nhóm chức năng — canvas, chat_stack/_flow_logs, config panel, run button, usage total). Đây là điểm nối chính giữa các file sau khi tách — không nên tách nhỏ hơn nếu không rất cẩn thận. | chua/khong ro | - | +| Co4ETab._new_workflow | 1209-1217 | presentation/co4e/co4e_tab.py | gọi self._open_flow(...) — khớp dòng plan.md '_open_flow() -> co4e_tab.py → gọi canvas'. | co | - | +| Co4ETab._selected_wf | 1219-1225 | presentation/co4e/co4e_tab.py | đọc self.wf_list (sidebar, dựng ở _build_sidebar <701) rồi gọi co4e.get_workflow (đĩa). | chua/khong ro | - | +| Co4ETab._load_selected_workflow | 1227-1230 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._edit_selected_workflow | 1232-1237 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._wf_context_menu | 1248-1271 | presentation/co4e/co4e_tab.py | dựng QMenu cho sidebar flows, điều phối gọi _edit_selected_workflow/_rename_workflow/_duplicate_selected_workflow/_run_selected_in_background/_delete_selected_workflow (một số nằm ngoài phạm vi đọc, dòng >1400). | chua/khong ro | - | +| Co4ETab._sync_wf_from_canvas | 1299-1302 | presentation/co4e/co4e_tab.py | đọc self.canvas.nodes()/edges() và ghi self._wf.nodes/edges/name — cầu nối giữa co4e_canvas_widget.py và trạng thái self._wf chia sẻ; cân nhắc đặt cùng canvas nếu muốn canvas tự chịu trách nhiệm export dữ liệu. | chua/khong ro | - | +| Co4ETab._on_name_changed | 1316-1318 | presentation/co4e/co4e_tab.py | ghi self._wf.name (trạng thái chia sẻ) rồi gọi self._sync_active_flow_tab_text() (định nghĩa dòng 444, ngoài phạm vi đọc). | chua/khong ro | - | +| Co4ETab._add_blank_step | 1320-1322 | presentation/co4e/co4e_tab.py | nút 'Add' trên toolbar uỷ nhiệm sang self.canvas.add_palette_step — liên quan nhóm _add_node() trong plan.md (co4e_canvas_widget.py) nhưng bản thân handler chỉ là cầu nối từ toolbar. | co | - | +| Co4ETab.set_project | 1658-1674 | presentation/co4e/co4e_tab.py | gọi load_project(project_id) (đọc đĩa) và self.manager.set_output_root/set_current_project (self.manager nên là co4e_workflow_service). Gán self._project_id, self._project_dir — không chắc là lần gán đầu tiên (có thể đã init ở __init__ ngoài khoảng đọc). Không khớp rõ nhóm nào trong danh sách đích cho trước — xếp tạm vào co4e_tab.py vì đây là API binding cấp container gọi từ ngoài. | chua/khong ro | ể đã init ở __init__ ngoài khoảng đọc). Không khớp rõ nhóm nào trong danh sách đích cho trước — xếp tạm vào co4e_tab.py vì đây là | +| Co4ETab._flow_output_root | 1676-1686 | presentation/co4e/co4e_tab.py | helper dùng chung bởi cả chat (_out_dir) và run-control (_open_workspace_folder, _open_run_output_folder) — trạng thái/logic cắt ngang nhiều nhóm; đọc self._project_dir, self.ctx.config | chua/khong ro | - | +| Co4ETab._refresh_ws_folder_btn | 1688-1693 | presentation/co4e/co4e_tab.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._open_workspace_folder | 1695-1702 | presentation/co4e/co4e_tab.py | root.mkdir + open_location (mở file explorer hệ điều hành — spawn process) | chua/khong ro | - | +| Co4ETab.showEvent | 1806-1809 | presentation/co4e/co4e_tab.py | override Qt lifecycle method của chính QWidget container nên phải ở lại co4e_tab.py; gọi self._refresh_runs() (thuộc co4e_run_control_widget.py) — điểm nối giữa container và run-control widget. [ANOMALY: cùng tên method định nghĩa 2 lần ở 2 dòng khác nhau trong cùng class -- có khả năng là lỗi nguồn (định nghĩa sau đè định nghĩa trước), không phải do quét trùng; giữ 2 dòng riêng, cần người quyết định định nghĩa nào còn hiệu lực] | chua/khong ro | giữa container và run-control widget. [ANOMALY: cùng tên method định nghĩa 2 lần ở 2 dòng khác nhau trong cùng class -- có khả | +| Co4ETab._out_dir | 1811-1817 | presentation/co4e/co4e_tab.py | d.mkdir(parents=True, exist_ok=True) — ghi đĩa; dùng chung bởi _run_chat_turn (chat) và tiềm năng bởi run-control; đọc self._wf.name, self._flow_output_root() | chua/khong ro | - | +| Co4ETab._retranslate | 2059-2079 | presentation/co4e/co4e_tab.py | cập nhật text i18n cho rất nhiều widget thuộc nhiều nhóm khác nhau (sidebar buttons, runs_table, run control buttons) và gọi self._reload_sidebar()/self._refresh_runs() — thuộc container vì bao trùm toàn tab, dù có thể tách nhỏ theo từng panel sau này. | chua/khong ro | - | +| _SectionHeader | 30-52 | presentation/co4e/node_property_panel.py | Widget nội bộ (header có thể click, thu/mở section) chỉ dùng bởi StepConfigPanel; không có trong bảng plan.md/function_list.md, xếp cùng chỗ với StepConfigPanel vì mô tả node_property_panel.py là 'Bọc StepConfigPanel' | co | section) chỉ dùng bởi StepConfigPanel; không có trong bảng plan.md/function_list.md, xếp cùng chỗ với StepConfigPanel vì mô tả node_property_panel | +| _SectionHeader.clicked | 36 | presentation/co4e/node_property_panel.py | Signal Qt khai báo ở cấp class, không phải self. gán trong __init__ | chua/khong ro | - | +| _SectionHeader.mousePressEvent | 38-41 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| _SectionHeader.showEvent | 43-52 | presentation/co4e/node_property_panel.py | recompute fontMetrics khi label thực sự hiển thị — cần widget đang sống, không test được nếu không có QApplication | chua/khong ro | - | +| _add_section | 55-130 | presentation/co4e/node_property_panel.py | Hàm dựng UI khối section thu gọn/mở rộng (header + body animate) dùng riêng cho StepConfigPanel; chứa 2 closure nội bộ _on_finished và _toggle. Không có trong bảng cũ. | co | closure nội bộ _on_finished và _toggle. Không có trong bảng cũ. | +| _add_section._on_finished | 103-112 | presentation/co4e/node_property_panel.py | closure lồng bên trong _add_section, không phải hàm top-level — chỉ tồn tại khi _add_section chạy | chua/khong ro | - | +| _add_section._toggle | 114-127 | presentation/co4e/node_property_panel.py | closure lồng bên trong _add_section, gắn vào header.clicked | chua/khong ro | - | +| StepConfigPanel | 133-528 | presentation/co4e/node_property_panel.py | cắt ngang lát — cần agent gộp đối chiếu (lớp còn tiếp tục sau dòng 528, chỉ đọc được 1-528). Bảng plan.md/function_list.md không liệt kê StepConfigPanel trực tiếp (chỉ có _build_config_panel() -> co4e_tab.py container); xếp theo mô tả node_property_panel.py 'Bọc StepConfigPanel, nối chọn node sang panel thuộc tính' trong danh sách đích được giao cho task này — người quyết cuối nên xác nhận lại. | co | - | +| StepConfigPanel.changed | 134 | presentation/co4e/node_property_panel.py | Signal Qt: bất kỳ field nào đổi -> canvas repaint node + autosave; đây là điểm nối trạng thái chia sẻ với canvas/co4e_workflow_service, cần giữ tên/signature khi tách file | chua/khong ro | - | +| StepConfigPanel.run_node | 135 | presentation/co4e/node_property_panel.py | Signal Qt 'chạy step này' — nối sang co4e_run_control_widget.py hoặc co4e_workflow_service.py | chua/khong ro | - | +| StepConfigPanel.run_from | 136 | presentation/co4e/node_property_panel.py | Signal Qt 'chạy từ bước này' — nối sang co4e_run_control_widget.py | chua/khong ro | - | +| StepConfigPanel.delete_node | 137 | presentation/co4e/node_property_panel.py | Signal Qt xoá step — nối sang co4e_canvas_widget.py để xoá node trên canvas | chua/khong ro | - | +| StepConfigPanel.__init__ | 139-313 | presentation/co4e/node_property_panel.py | >80 dòng (174 dòng) — gộp nhiều việc không liên quan: dựng section Cơ bản, section Model&Quyền, section Skills&Tệp, section Sub-agents (ẩn/hiện theo is_parallel), và dựng hàng nút footer Run/Run-from/Delete, cộng thêm cơ chế 'outer.addStretch(1)' vá lỗi layout. Nên tách thành các hàm _build_basic_section(), _build_model_section(), _build_skills_section(), _build_subagent_section(), _build_footer() riêng khi tách file. | chua/khong ro | - | +| StepConfigPanel.ctx | 141 | presentation/co4e/node_property_panel.py | context được truyền từ ngoài vào, dùng cho _ai_draft/_load_models (gọi AI provider) — trạng thái chia sẻ với co4e_tab.py | chua/khong ro | - | +| StepConfigPanel._step | 142 | presentation/co4e/node_property_panel.py | Step đang chỉnh sửa — trạng thái chia sẻ giữa load_step()/_on_edit()/mọi hành động subagent+attachment; do canvas gán vào qua load_step() | chua/khong ro | - | +| StepConfigPanel._node_id | 143 | presentation/co4e/node_property_panel.py | id node đang chọn — dùng để emit run_node/run_from/delete_node; là cầu nối canvas <-> property panel | chua/khong ro | - | +| StepConfigPanel._loading | 144 | presentation/co4e/node_property_panel.py | cờ chặn _on_edit() chạy lại trong lúc load_step() đang set giá trị field | chua/khong ro | - | +| StepConfigPanel.label_edit | 159 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.role_edit | 163 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.icon_edit | 170 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.instructions_edit | 175 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.gen_btn | 178 | presentation/co4e/node_property_panel.py | nút 'AI draft' — enable chỉ khi có ctx | chua/khong ro | - | +| StepConfigPanel.context_edit | 192 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.model_combo | 201 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.load_models_btn | 204 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.perm_combo | 214 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.verify_chk | 221 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.rounds_spin | 223 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.skills_list | 236 | presentation/co4e/node_property_panel.py | checklist skill của registry, gán checked theo step.skills | chua/khong ro | - | +| StepConfigPanel.attach_list | 242 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.attach_add_btn | 244 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.attach_del_btn | 247 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel._parallel_card | 263 | presentation/co4e/node_property_panel.py | card cả section Sub-agents; load_step() ẩn/hiện toàn bộ card này theo step.is_parallel | chua/khong ro | - | +| StepConfigPanel.sub_list | 264 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.sub_add_btn | 267 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.config | 268 | presentation/co4e/node_property_panel.py | StepConfigPanel + wiring changed/run_node/run_from/delete_node (dòng 268-273) — khớp vai trò mô tả cho node_property_panel.py | chua/khong ro | - | +| StepConfigPanel.sub_del_btn | 270 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel.run_btn | 283 | presentation/co4e/node_property_panel.py | click emit run_node(self._node_id) | chua/khong ro | - | +| StepConfigPanel.run_from_btn | 287 | presentation/co4e/node_property_panel.py | click emit run_from(self._node_id) | chua/khong ro | - | +| StepConfigPanel.del_btn | 290 | presentation/co4e/node_property_panel.py | click emit delete_node(self._node_id) | chua/khong ro | - | +| StepConfigPanel.load_step | 316-354 | presentation/co4e/node_property_panel.py | Điểm nối chính giữa canvas (khi chọn node) và panel thuộc tính — nhận (node_id, step, skill_names) từ ngoài rồi ghi self._step/self._node_id; đây là API mà co4e_canvas_widget.py hoặc co4e_tab.py sẽ gọi khi chọn node | chua/khong ro | - | +| StepConfigPanel.clear_step | 356-359 | presentation/co4e/node_property_panel.py | gọi khi bỏ chọn node — reset self._step/self._node_id | chua/khong ro | - | +| StepConfigPanel._on_edit | 362-378 | presentation/co4e/node_property_panel.py | ghi ngược giá trị field UI vào self._step rồi emit changed() — canvas repaint + autosave phụ thuộc signal này, đổi tên/behavior ở đây ảnh hưởng cả canvas lẫn service lưu flow | chua/khong ro | - | +| StepConfigPanel._available_agent_names | 380-390 | presentation/co4e/node_property_panel.py | staticmethod; gọi core.co4e.list_custom_agents() đọc file JSON trong AGENTS_DIR trên đĩa — logic thuần Python nhưng có I/O, có thể tách ra application layer nếu cần test không đụng đĩa | chua/khong ro | - | +| StepConfigPanel._add_subagent | 392-408 | presentation/co4e/node_property_panel.py | dùng QInputDialog để chọn/nhập tên agent song song | chua/khong ro | - | +| StepConfigPanel._edit_subagent | 410-428 | presentation/co4e/node_property_panel.py | double-click 1 dòng sub-agent để chọn lại agent khác | chua/khong ro | - | +| StepConfigPanel._del_subagent | 430-437 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel._add_attachment | 439-453 | presentation/co4e/node_property_panel.py | QFileDialog chỉ chọn đường dẫn hiển thị tên file, không tự đọc nội dung ở đây (nội dung được đọc lúc chạy step, ở nơi khác) | chua/khong ro | - | +| StepConfigPanel._del_attachment | 455-462 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| StepConfigPanel._ai_draft | 464-498 | presentation/co4e/node_property_panel.py | gọi generate_agent_prompt(ctx.build_active_provider(), ...) qua AgentWorker — gọi network tới AI provider, chạy nền rồi cập nhật UI ở callback done(); nếu tách sang service, phần gọi AI nên chuyển xuống application layer, phần còn lại (QInputDialog + set text) ở lại đây | chua/khong ro | - | +| StepConfigPanel._draft_worker | 497 | presentation/co4e/node_property_panel.py | giữ tham chiếu AgentWorker (QThread-like) để không bị GC giữa lúc job async đang chạy | chua/khong ro | - | +| StepConfigPanel._load_models | 500-528 | presentation/co4e/node_property_panel.py | gọi preview_ai.fetch_live_models(ctx) qua AgentWorker — network call tới provider để lấy danh sách model; cắt ngang lát — cần agent gộp đối chiếu vì dòng cuối trùng đúng biên đọc được giao (528), chưa chắc thân method đã hết ở đây | chua/khong ro | - | +| StepConfigPanel._model_worker | 525 | presentation/co4e/node_property_panel.py | giữ tham chiếu AgentWorker của _load_models để không bị GC | chua/khong ro | - | +| Co4ETab._wrap_config | 934-964 | presentation/co4e/node_property_panel.py | bọc self.config (StepConfigPanel) với header expand/collapse — khớp mô tả node_property_panel.py trong prompt. | chua/khong ro | - | +| Co4ETab.config_toggle_btn | 946 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.config_title | 951 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab._cfg_vlayout | 957 | presentation/co4e/node_property_panel.py | dùng lại trong _toggle_config (co4e_tab.py) — trạng thái chia sẻ. | chua/khong ro | - | +| Co4ETab._cfg_top_spacer | 961 | presentation/co4e/node_property_panel.py | QSpacerItem — kiểu giá trị layout, không cần QApplication đang sống. | chua/khong ro | - | +| Co4ETab._cfg_bot_spacer | 962 | presentation/co4e/node_property_panel.py | (không có ghi chú) | chua/khong ro | - | +| Co4ETab.config_container | 963 | presentation/co4e/node_property_panel.py | dùng lại bởi _toggle_config (co4e_tab.py) — trạng thái chia sẻ giữa node_property_panel.py và co4e_tab.py. | chua/khong ro | - | +| Co4ETab._on_node_selected | 1325-1331 | presentation/co4e/node_property_panel.py | khớp mô tả 'nối chọn node sang panel thuộc tính' trong prompt. Đọc self.canvas.nodes() và self.config, toggle self._config_collapsed (trạng thái chia sẻ với _toggle_config ở co4e_tab.py). | chua/khong ro | - | +| Co4ETab._on_config_changed | 1333-1336 | presentation/co4e/node_property_panel.py | gọi self.canvas.refresh_node cho từng node rồi self._autosave() — cầu nối property panel ↔ canvas ↔ service lưu đĩa. | chua/khong ro | - | +| Co4ETab._manage_skills | 1369-1373 | presentation/co4e/skills_list_panel.py | mở SkillsDialog rồi self._reload_sidebar() — không có tên tương ứng trực tiếp trong bảng plan.md, tự xếp theo mô tả skills_list_panel.py. | co | - | +| _PaletteList | 97-119 | unsure | list kéo-thả dùng chung cho wf_list và agent_list, phát payload CO4E_MIME hiểu bởi canvas — không rõ nên đặt ở co4e_tab.py (nơi dùng) hay co4e_canvas_widget.py (định nghĩa giao thức CO4E_MIME) | chua/khong ro | - | +| _PaletteList.__init__ | 102-106 | unsure | cùng lý do với class _PaletteList | chua/khong ro | - | +| _PaletteList._payload_role | 104 | unsure | cùng lý do với class _PaletteList | chua/khong ro | - | +| _PaletteList.startDrag | 108-119 | unsure | cùng lý do với class _PaletteList; dùng CO4E_MIME từ co4e_canvas | chua/khong ro | - | +| Co4ETab._project_id | 249 | unsure | project Workspace đang chọn, ảnh hưởng đường dẫn output flow — không chắc thuộc container hay run control | chua/khong ro | - | +| Co4ETab._project_dir | 250 | unsure | cùng lý do với _project_id | chua/khong ro | - | +| Co4ETab._reflect_active_run | 449-457 | unsure | cầu nối giữa self.manager (run control) và self.canvas (canvas widget) — không chắc nên đặt file nào | chua/khong ro | - | +| Co4ETab._palette_item | 724-728 | unsure | staticmethod helper dùng chung để tạo QListWidgetItem cho cả agent_list, skill_list, và cả node palette sequential/parallel (thấy dùng ở dòng 701-704) — không rõ nên đặt ở agent_list_panel.py, skills_list_panel.py hay co4e_canvas_widget.py. | chua/khong ro | - | + +## Chỗ thấy khác tài liệu — cần người quyết + +Không có symbol nào có note bắt đầu bằng `khac tai lieu:` trong dữ liệu 367 symbol đầu vào. Mục này để trống theo đúng dữ liệu quét được — không tự bịa thêm mục. diff --git a/domain/workflows/run_record.py b/domain/workflows/run_record.py new file mode 100644 index 0000000..dcafbae --- /dev/null +++ b/domain/workflows/run_record.py @@ -0,0 +1,114 @@ +"""Bản ghi "một lần chạy flow" — DTO thuần Python cho tầng domain. + +Bối cảnh: ``Co4ERunManager``/``RunHandle`` cũ (``core/co4e_run_manager.py``) +trộn ba việc vào một ``QObject``: (1) dữ liệu một run cần nhớ để hiện Flow +Status, (2) logic chạy job trên ``AgentWorker``/``QThread``, và (3) logic +đọc/ghi lịch sử ra đĩa. Tách phần (1) ra thành ``RunRecord`` ở đây giúp nó độc +lập với Qt và với việc đọc/ghi đĩa — đúng quy ước ``domain/__init__.py``: domain +không được biết PySide6 tồn tại và không được chạm đĩa/mạng. Phần (2) và (3) +chuyển sang ``application/workflows/co4e_workflow_service.py`` +(``Co4EWorkflowService``), nơi được phép import ``core/`` và làm việc với đĩa. + +Vì sao trường ``wf`` là dict thô chứ không phải đối tượng ``Workflow``: lớp +``Workflow`` sống ở ``core/co4e.py``, và việc dựng nó từ/thành dict +(``workflow_to_dict``/``workflow_from_dict``) nằm trong module đó. Domain +không được import ``cowork_local.core.*``, nên ``RunRecord`` giữ nguyên đúng +hình dạng dữ liệu mà bản ghi lịch sử đã có sẵn trên đĩa hôm nay: một dict thô +(kết quả ``workflow_to_dict``) hoặc ``None``. Việc quy đổi dict <-> đối tượng +``Workflow`` là việc của tầng application, nơi được phép import ``core``. + +Quirk giữ nguyên có chủ ý — đã bị "đóng đinh" bởi +``tests/characterization/test_co4e_run_manager_behavior.py`` (quirk #1 và #7 +trong docstring đầu file đó, xem thêm ``RunHandle.to_record``/``from_record`` +gốc) — ĐỪNG "dọn" các chỗ này khi đọc code dưới đây, chúng trông như bug nhưng +là hành vi đã được test khẳng định: + * ``total`` âm bị ``max(0, total)`` kẹp về 0 ngay lúc khởi tạo, không giữ + nguyên giá trị âm. + * ``from_dict()`` đổi ``status == "running"`` đọc từ đĩa thành ``"stopped"`` + (lý do: app tắt giữa lúc một run đang "running" thì worker của nó đã mất + theo, nên đọc lại không còn coi là đang chạy) — nhưng ``to_dict()`` vẫn ghi + đúng ``"running"`` xuống đĩa tại thời điểm lưu. Đây là một round-trip + *không đối xứng* có chủ ý. + * ``from_dict({})``/``from_dict(None)`` mặc định ``status`` là ``"done"`` + (không phải ``"running"``) — nên KHÔNG bị nhánh phía trên đổi thành + "stopped". +""" +from __future__ import annotations + +from typing import Dict, Optional + + +class RunRecord: + """DTO domain: trạng thái sống của một lần chạy flow, thuần dữ liệu. + + Vai trò: đây là "danh từ" mà ``Co4EWorkflowService`` (application/) đọc/ghi + và mà UI Flow Status hiển thị — không có hành vi chạy worker, không đọc/ghi + đĩa. Nó ở tầng domain vì đây là quy tắc nghiệp vụ ổn định (hình dạng một + lần chạy flow cần nhớ những gì) độc lập với Qt lẫn với cơ chế lưu trữ. + """ + + def __init__(self, run_id: str, wf_id: str, name: str, total: int, + plan_mode: bool, manual: bool, created_by: str = "", created_at: str = "", + project_id: str = ""): + self.id = run_id + self.wf_id = wf_id + self.name = name + self.project_id = project_id # workspace run này thuộc về (Flow Status lọc theo project) + self.total = max(0, total) # quirk cố ý: total âm bị kẹp về 0, xem docstring đầu file + self.done = 0 + self.status = "running" # running | done | error | stopped + self.plan_mode = plan_mode + self.manual = manual + self.created_by = created_by + self.created_at = created_at + self.error = "" + self.node_status: Dict[str, str] = {} + self.wf: Optional[dict] = None # snapshot workflow dạng dict thô (xem docstring đầu file) + self.out_dir = "" # thư mục workspace mà run này ghi file vào + + @property + def running(self) -> bool: + return self.status == "running" + + def progress_text(self) -> str: + return f"{self.done}/{self.total}" if self.total else self.status + + # ---- (de)serialization -------------------------------------------- + def to_dict(self) -> dict: + """Hình dạng bản ghi lịch sử trên đĩa. + + PHẢI khớp đúng bộ khoá mà ``RunHandle.to_record()`` gốc + (``core/co4e_run_manager.py``) đang ghi hôm nay — file JSON lịch sử cũ + và mới dùng chung một định dạng trong lúc cả hai lớp còn chạy song + song (bản cũ chưa bị xoá). + """ + return { + "id": self.id, "wf_id": self.wf_id, "name": self.name, + "total": self.total, "done": self.done, "status": self.status, + "plan_mode": self.plan_mode, "manual": self.manual, + "created_by": self.created_by, "created_at": self.created_at, + "error": self.error, "node_status": dict(self.node_status), + "wf": self.wf, "out_dir": self.out_dir, "project_id": self.project_id, + } + + @classmethod + def from_dict(cls, rec: dict) -> "RunRecord": + rec = dict(rec or {}) + r = cls(str(rec.get("id", "")), str(rec.get("wf_id", "")), + rec.get("name", ""), int(rec.get("total", 0) or 0), + bool(rec.get("plan_mode")), bool(rec.get("manual")), + created_by=rec.get("created_by", ""), created_at=rec.get("created_at", "")) + r.done = int(rec.get("done", 0) or 0) + r.status = rec.get("status", "done") + # quirk cố ý (xem docstring đầu file): round-trip không đối xứng — + # "running" đọc lại từ đĩa luôn bị chốt thành "stopped". + if r.status == "running": + r.status = "stopped" + r.error = rec.get("error", "") + r.node_status = dict(rec.get("node_status") or {}) + r.out_dir = rec.get("out_dir", "") + r.project_id = rec.get("project_id", "") + # Giữ nguyên dict thô -- KHONG parse thanh doi tuong Workflow o day (do + # la viec cua tang application, xem docstring dau file). + r.wf = rec.get("wf") + return r diff --git a/presentation/co4e/agent_list_panel.py b/presentation/co4e/agent_list_panel.py new file mode 100644 index 0000000..b172223 --- /dev/null +++ b/presentation/co4e/agent_list_panel.py @@ -0,0 +1,87 @@ +"""Panel khu vực AGENTS của sidebar Co4E — tách khỏi ``ui/co4e_tab.py``. + +Vấn đề đang có: giống ``SkillsListPanel`` (xem +``presentation/co4e/skills_list_panel.py``), đoạn dựng widget khu vực AGENTS +nằm nguyên trong thân hàm dựng cả cột sidebar của ``ui/co4e_tab.py`` (nguyên +bản ở dòng 549-568): nút "+ Mới", danh sách kéo-thả và 2 nút icon Sửa/Xoá. +Đoạn này không đọc/ghi bất kỳ trạng thái nào của ``Co4ETab`` khi DỰNG (chỉ khi +người dùng bấm nút mới cần tới ``_new_agent``/``_edit_agent``/``_delete_agent`` +của ``Co4ETab``), nên tách được thành một ``QWidget`` con độc lập. + +Cách làm: dời nguyên phần dựng widget sang đây, KHÔNG đổi tên thuộc tính so +với bản gốc ngoại trừ đổi TÊN THUỘC TÍNH cho khớp quy ước panel công khai +(``ag_new_btn`` → ``new_btn``, ``agent_list`` → ``list_widget``, +``ag_edit_btn`` → ``edit_btn``, ``ag_del_btn`` → ``del_btn``); giá trị/thứ tự +dựng thì giữ y hệt. Panel KHÔNG tự nối ``.clicked`` của bất kỳ nút nào — theo +đúng nguyên tắc "một việc rẽ ra một lần" đã dùng cho ``SkillsListPanel``: việc +dựng widget (ở đây) tách khỏi việc nối hành vi (vẫn ở ``Co4ETab``, nơi biết +``_new_agent``/``_edit_agent``/``_delete_agent`` là gì). Gộp hai việc đó vào +panel sẽ buộc panel phải biết về ``Co4ETab``, xoá mất lý do tách nó ra. + +``new_btn`` được tạo nhưng KHÔNG add vào layout của panel này — giống hệt +``wf_new_btn``/``sk_manage_btn`` ở bản gốc: nút này được ``Co4ETab`` truyền +riêng làm "action" của tiêu đề section (tham số ``action`` của ``_section``), +không nằm trong phần thân (list + nút icon) mà panel này đóng vai trò thay +thế. Panel do đó chỉ tự dựng layout cho list_widget + hàng nút edit/del. + +Cập nhật 25/08: ``_PaletteList`` đã dời khỏi ``ui/co4e_tab.py`` sang +``presentation/co4e/palette_list.py`` (module dùng chung, không phụ thuộc +``ui/``) — import thẳng ở top-level như bên dưới, không còn cần deferred-import +né vòng lặp nữa (xem docstring đầu ``presentation/co4e/palette_list.py`` để +biết lý do dời). +""" +from __future__ import annotations + +from PySide6.QtCore import Qt +from PySide6.QtWidgets import QHBoxLayout, QPushButton, QVBoxLayout, QWidget + +from ...i18n import tr +from ...ui.icons import icon +from .palette_list import _PaletteList + + +class AgentListPanel(QWidget): + """Widget khu vực AGENTS của sidebar Co4E: nút mới + danh sách + sửa/xoá. + + Vai trò: một widget con thuần ở tầng presentation, chỉ dựng cấu trúc UI + (đúng những gì ``ui/co4e_tab.py`` dòng 549-568 làm trước đây), không biết + gì về ``Co4ETab``/``_new_agent``/``_edit_agent``/``_delete_agent``. Bên + gọi (hiện là ``Co4ETab``) tự đọc ``.new_btn``/``.list_widget``/ + ``.edit_btn``/``.del_btn`` để nối signal và nạp dữ liệu — panel không tự + làm hộ, để giữ đúng ranh giới "một nơi một việc" đã dùng cho + ``SkillsListPanel``. + """ + + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + self.new_btn = QPushButton(tr("co4e.new")) + self.new_btn.setIcon(icon("plus")) + self.new_btn.setToolTip(tr("co4e.tt_new_agent")) + self.new_btn.setObjectName("co4eSectionAction") + self.new_btn.setFlat(True) + self.new_btn.setCursor(Qt.PointingHandCursor) + # KHONG noi .clicked o day: ben goi (Co4ETab) tu quyet dinh slot nao + # xu ly - panel chi dung widget, khong biet _new_agent la gi. + + layout = QVBoxLayout(self) + layout.setContentsMargins(0, 0, 0, 0) + layout.setSpacing(4) + self.list_widget = _PaletteList() + layout.addWidget(self.list_widget, 1) + + btns = QHBoxLayout() + btns.setSpacing(4) + # Edit/delete act on the selected row, so they stay with the list. + self.edit_btn = QPushButton() + self.edit_btn.setIcon(icon("edit")) + self.edit_btn.setToolTip(tr("co4e.tt_edit_agent")) + self.edit_btn.setFixedWidth(34) + self.del_btn = QPushButton() + self.del_btn.setIcon(icon("trash")) + self.del_btn.setToolTip(tr("co4e.tt_del_agent")) + self.del_btn.setFixedWidth(34) + # KHONG noi .clicked o day: cung ly do nhu new_btn o tren. + btns.addWidget(self.edit_btn) + btns.addWidget(self.del_btn) + btns.addStretch(1) + layout.addLayout(btns) diff --git a/presentation/co4e/canvas_geometry.py b/presentation/co4e/canvas_geometry.py new file mode 100644 index 0000000..87f0918 --- /dev/null +++ b/presentation/co4e/canvas_geometry.py @@ -0,0 +1,126 @@ +"""Hình học thuần cho canvas Co4E — tách khỏi ``ui/co4e_canvas.py``. + +Vấn đề đang có: ``ui/co4e_canvas.py`` dài hơn 2000 dòng, gộp chung widget Qt +(``QGraphicsItem``, vẽ, sự kiện chuột) với các hàm hình học thuần (khoảng cách, +nội suy điểm, dựng đường bo góc, né vật cản, cắt chuỗi). Các hàm hình học này +không cần ``QApplication``, không vẽ, không đọc kích thước widget — chúng chỉ +dùng ``QPointF``/``QRectF``/``QPainterPath`` như kiểu giá trị thuần. Gộp chung +vào một file khiến file đó khó đọc và khó kiểm tra theo giới hạn CASAN (≤400 +dòng mỗi file production). + +Cách làm: dời nguyên 8 hàm này sang đây, không đổi tên/tham số/giá trị mặc +định/hành vi — kể cả các "quirk" đã bị characterization test đóng đinh (xem +``tests/characterization/test_co4e_canvas_geometry.py``), ví dụ ``_route`` có +thể "bỏ cuộc" và trả về elbow va chạm nếu bị vật cản bao kín hoàn toàn, hoặc +``_elide(text, 0)`` trả về ``"…"`` chứ không phải chuỗi rỗng do cách slicing +``text[: n - 1]``. Đừng "sửa" các quirk này ở đây — chúng đã có test khoá lại, +sửa sai chỗ này sẽ làm vỡ hợp đồng mà nơi khác đang phụ thuộc. + +``ui/co4e_canvas.py`` import lại các tên này (không alias) để giữ nguyên đường +import public mà các test/character khác đang dùng. +""" +from __future__ import annotations + +from PySide6.QtCore import QPointF, QRectF +from PySide6.QtGui import QPainterPath + +_CORNER_R = 12 # edge elbow corner radius + + +def _dist(a: QPointF, b: QPointF) -> float: + return ((a.x() - b.x()) ** 2 + (a.y() - b.y()) ** 2) ** 0.5 + + +def _towards(a: QPointF, b: QPointF, d: float) -> QPointF: + dist = _dist(a, b) + if dist < 1e-6: + return QPointF(a) + t = d / dist + return QPointF(a.x() + (b.x() - a.x()) * t, a.y() + (b.y() - a.y()) * t) + + +def _rounded_path(points, r: float = _CORNER_R) -> QPainterPath: + """Build a path through axis-aligned ``points`` with rounded corners at each + bend ("vuông bo cong ở góc").""" + if not points: + return QPainterPath() + path = QPainterPath(points[0]) + if len(points) == 1: + return path + for i in range(1, len(points) - 1): + prev, cur, nxt = points[i - 1], points[i], points[i + 1] + rr = min(r, _dist(prev, cur) / 2.0, _dist(cur, nxt) / 2.0) + path.lineTo(_towards(cur, prev, rr)) + path.quadTo(cur, _towards(cur, nxt, rr)) + path.lineTo(points[-1]) + return path + + +def _seg_hits_rect(p1: QPointF, p2: QPointF, rect: QRectF) -> bool: + """Axis-aligned segment vs rectangle overlap (all routed segments are H or V).""" + x1, y1, x2, y2 = p1.x(), p1.y(), p2.x(), p2.y() + if abs(y1 - y2) < 0.5: # horizontal + if rect.top() <= y1 <= rect.bottom(): + lo, hi = sorted((x1, x2)) + return not (hi < rect.left() or lo > rect.right()) + return False + if abs(x1 - x2) < 0.5: # vertical + if rect.left() <= x1 <= rect.right(): + lo, hi = sorted((y1, y2)) + return not (hi < rect.top() or lo > rect.bottom()) + return False + box = QRectF(QPointF(min(x1, x2), min(y1, y2)), QPointF(max(x1, x2), max(y1, y2))) + return rect.intersects(box) + + +def _hits(points, obstacles) -> bool: + for i in range(len(points) - 1): + for r in obstacles: + if _seg_hits_rect(points[i], points[i + 1], r): + return True + return False + + +def _route(src: QPointF, dst: QPointF, obstacles=None): + """Waypoints for a LEFT→RIGHT orthogonal edge from ``src`` (a node's right + output) to ``dst`` (the next node's left input) that AVOIDS the other node + rectangles: try the straight elbow, then a clear vertical band, then a + top/bottom detour — so a connector never overlaps or hides behind a step.""" + obstacles = list(obstacles or []) + if abs(src.y() - dst.y()) < 1.5: + cand = [src, dst] + if not _hits(cand, obstacles): + return cand + mid_x = (src.x() + dst.x()) / 2.0 + base = [src, QPointF(mid_x, src.y()), QPointF(mid_x, dst.y()), dst] + if not _hits(base, obstacles): + return base + # 1) slide the vertical run to a clear band between the two columns + lo, hi = min(src.x(), dst.x()) + 6, max(src.x(), dst.x()) - 6 + if hi > lo: + for frac in (0.5, 0.35, 0.65, 0.2, 0.8): + x = lo + (hi - lo) * frac + cand = [src, QPointF(x, src.y()), QPointF(x, dst.y()), dst] + if not _hits(cand, obstacles): + return cand + # 2) detour above/below every obstacle, then back in + margin = 44.0 + ys = [src.y(), dst.y()] + [r.top() for r in obstacles] + [r.bottom() for r in obstacles] + out_x, in_x = src.x() + 34, dst.x() - 34 # short stubs out of the side ports + for side_y in (min(ys) - margin, max(ys) + margin): + cand = [src, QPointF(out_x, src.y()), QPointF(out_x, side_y), + QPointF(in_x, side_y), QPointF(in_x, dst.y()), dst] + if not _hits(cand, obstacles): + return cand + return base + + +def _ortho_path(src: QPointF, dst: QPointF, r: float = _CORNER_R) -> QPainterPath: + """Rounded orthogonal elbow (no obstacle avoidance) — used for the transient + drag-to-connect line and by callers that pass no obstacles.""" + return _rounded_path(_route(src, dst), r) + + +def _elide(text: str, n: int) -> str: + text = (text or "").replace("\n", " ") + return text if len(text) <= n else text[: n - 1] + "…" diff --git a/presentation/co4e/canvas_interaction_mixin.py b/presentation/co4e/canvas_interaction_mixin.py new file mode 100644 index 0000000..491d0b9 --- /dev/null +++ b/presentation/co4e/canvas_interaction_mixin.py @@ -0,0 +1,262 @@ +"""Mixin xử lý tương tác (zoom/pan/relayout/drop) của canvas Co4E — dời khỏi +``ui/co4e_canvas.py``. + +Vấn đề đang có: gộp toàn bộ ``Co4ECanvas`` (dòng 289-701 của file cũ) vào một +file duy nhất vẫn dư 413 dòng — vượt trần 400 dòng/file production của CASAN +Check 2 dù đã tách ``_NodeItem``/``_EdgeItem`` ra ``canvas_items.py`` rồi. Khối +còn lại chia làm hai nhóm trách nhiệm tự nhiên: (1) mutation đồ thị (add/delete +node/edge, port-drag) và (2) tương tác view thuần tuý (overlay góc, zoom, +pan-chuột-giữa, fit/relayout, phím tắt, kéo-thả từ sidebar). Nhóm (2) được cắt +ra đây thành MIXIN THUẦN — không có ``__init__`` riêng, không tự gọi +``super().__init__()`` — vì toàn bộ state nó dùng (``self._overlay``, +``self._zoom``, ``self._panning``, ``self._pan_start``, ``self._nodes``, +``self._edges``, ``self._scene``, ``self._connect_from``, ``self._temp_edge``, +hằng số lớp ``self._ZOOM_MIN``/``self._ZOOM_MAX``) do ``Co4ECanvas.__init__`` +định nghĩa; mixin chỉ mượn ``self`` khi đã được trộn vào lớp đó. + +Cách làm: cắt dán NGUYÊN VĂN các khối dòng 318-345, 484-519, 522-548, 550-610, +652-701 của ``ui/co4e_canvas.py`` — không đổi tên/tham số/thứ tự/logic, kể cả +inline import ``from collections import defaultdict`` bên trong ``relayout`` +hay hai inline import ``from ..core.co4e import ...`` bên trong ``dropEvent`` +(chỉ đổi SỐ DẤU CHẤM cho đúng cấp thư mục mới — xem chú thích tại chỗ). + +Thứ tự kế thừa bắt buộc ở nơi dùng (``co4e_canvas_widget.py``): +``class Co4ECanvas(_CanvasInteractionMixin, QGraphicsView)`` — mixin đứng +TRƯỚC ``QGraphicsView`` trong danh sách base để MRO ưu tiên các override ở +đây (``mousePressEvent``/``mouseMoveEvent``/``mouseReleaseEvent``/ +``wheelEvent``/``resizeEvent``/``keyPressEvent``/``dragEnterEvent``/ +``dragMoveEvent``/``dropEvent``) thay vì rơi vào bản gốc của +``QGraphicsView``. Mỗi ``super().xxxEvent(e)`` gọi trong file này dựa vào đúng +thứ tự MRO đó để rơi xuống ``QGraphicsView.xxxEvent`` khi mixin không tự xử lý +— không phải gọi đệ quy lại chính nó. +""" +from __future__ import annotations + +import copy +import json +from typing import Dict, Optional + +from PySide6.QtCore import QPointF, Qt + +from ...core.co4e import Edge, Node, compute_waves, new_edge_id, new_node_id +from .canvas_items import CO4E_MIME, _NODE_H, _NODE_W, _NodeItem + + +class _CanvasInteractionMixin: + """Phần tương tác view của ``Co4ECanvas``: overlay góc, zoom/pan, fit/ + relayout, phím tắt, kéo-thả từ sidebar. Xem docstring đầu module về lý do + tách và ràng buộc thứ tự kế thừa MRO khi trộn vào ``Co4ECanvas``.""" + + # ---- bottom-left overlay (zoom / fit) -------------------------------- + def add_overlay(self, widget) -> None: + self._overlay = widget + widget.setParent(self.viewport()) + widget.show() + widget.raise_() + self._place_overlay() + + def _place_overlay(self) -> None: + if self._overlay is not None: + self._overlay.adjustSize() + vp = self.viewport() + self._overlay.move(12, vp.height() - self._overlay.height() - 12) + self._overlay.raise_() + + def resizeEvent(self, e): # noqa: N802 + super().resizeEvent(e) + self._place_overlay() + + def scrollContentsBy(self, dx, dy): # noqa: N802 + # QGraphicsView scrolls the viewport's child widgets along with the + # scene, so panning/scrolling would drag the zoom overlay off-corner. + # Re-pin it after every scroll so +/−/fit stay fixed in place. + super().scrollContentsBy(dx, dy) + self._place_overlay() + + def showEvent(self, e): # noqa: N802 + super().showEvent(e) + self._place_overlay() # viewport size is final once shown + + # ---- zoom / fit ------------------------------------------------------- + def _zoom_by(self, factor: float) -> None: + # Derive the CURRENT scale from the live transform (never a separate + # accumulator that can drift out of sync with fit_view/relayout/reset — + # that drift is what made the +/− buttons and Ctrl+wheel randomly stop + # working). Clamp the TARGET to the range and apply the exact factor to + # reach it, so zooming still works right up to the limits. + cur = self.transform().m11() or 1.0 + target = max(self._ZOOM_MIN, min(self._ZOOM_MAX, cur * factor)) + if abs(target - cur) < 1e-6: + return + self.scale(target / cur, target / cur) + self._zoom = target + + def zoom_in(self) -> None: + self._zoom_by(1.15) + + def zoom_out(self) -> None: + self._zoom_by(1 / 1.15) + + def reset_zoom(self) -> None: + self.resetTransform() + self._zoom = 1.0 + + def wheelEvent(self, e): + # Ctrl+wheel = zoom (anchored under the cursor); Shift+wheel = pan + # horizontally; plain wheel scrolls vertically. + if e.modifiers() & Qt.ControlModifier: + self._zoom_by(1.15 if e.angleDelta().y() > 0 else 1 / 1.15) + e.accept() + return + if e.modifiers() & Qt.ShiftModifier: + bar = self.horizontalScrollBar() + bar.setValue(bar.value() - e.angleDelta().y()) + e.accept() + return + super().wheelEvent(e) + + # ---- middle-mouse drag-to-pan ---------------------------------------- + def mousePressEvent(self, e): + if e.button() == Qt.MiddleButton: + self._panning = True + self._pan_start = e.position().toPoint() + self.setCursor(Qt.ClosedHandCursor) + e.accept() + return + super().mousePressEvent(e) + + def mouseMoveEvent(self, e): + if self._panning and self._pan_start is not None: + pos = e.position().toPoint() + delta = pos - self._pan_start + self._pan_start = pos + self.horizontalScrollBar().setValue(self.horizontalScrollBar().value() - delta.x()) + self.verticalScrollBar().setValue(self.verticalScrollBar().value() - delta.y()) + e.accept() + return + super().mouseMoveEvent(e) + + def mouseReleaseEvent(self, e): + if e.button() == Qt.MiddleButton and self._panning: + self._panning = False + self.setCursor(Qt.ArrowCursor) + e.accept() + return + super().mouseReleaseEvent(e) + + def fit_view(self) -> None: + """Auto-fit: zoom/pan so every node is visible with a small margin.""" + rect = self._scene.itemsBoundingRect() + if rect.isNull(): + return + self.setSceneRect(rect.adjusted(-60, -60, 60, 60)) + self.fitInView(rect.adjusted(-40, -40, 40, 40), Qt.KeepAspectRatio) + # keep the zoom accumulator in sync with the transform fitInView applied + self._zoom = self.transform().m11() or 1.0 + + def relayout(self, hgap: float = 110.0, vgap: float = 40.0) -> None: + """Arrange nodes LEFT→RIGHT by dependency depth: each topological wave is + a column (x = wave), siblings stacked vertically within it. Used to turn + an old top-down graph into the horizontal flow layout.""" + nodes = [it.node for it in self._nodes.values()] + edges = [it.edge for it in self._edges] + if not nodes: + return + waves = compute_waves(nodes, edges) + from collections import defaultdict + cols: Dict[int, list] = defaultdict(list) + for n in nodes: + cols[waves.get(n.id, 0)].append(n) + for w in sorted(cols): + for row, n in enumerate(sorted(cols[w], key=lambda nn: (nn.y, nn.x))): + item = self._nodes.get(n.id) + if item is not None: + item.setPos(w * (_NODE_W + hgap), row * (_NODE_H + vgap)) + self._reposition_edges() + + def relayout_if_vertical(self) -> None: + """Convert a graph that's stacked vertically (the old top-down layout, or + overlapping nodes) into the horizontal left→right layout — but leave a + graph the user already arranged horizontally untouched.""" + nodes = [it.node for it in self._nodes.values()] + if len(nodes) < 2: + return + xs = [n.x for n in nodes] + if max(xs) - min(xs) < _NODE_W: # all in one column → it's vertical + self.relayout() + + def add_workflow(self, nodes, edges, at: Optional[QPointF] = None) -> None: + """Drop/merge a whole flow's nodes+edges onto the canvas with fresh ids + (so the same template can be dropped several times). Offsets it near + ``at`` when given, else tiles it beside whatever is already there.""" + remap: Dict[str, str] = {} + # offset so a dropped template doesn't land exactly on existing nodes + ox = (at.x() - nodes[0].x) if (at and nodes) else (60 if self._nodes else 0) + oy = (at.y() - nodes[0].y) if (at and nodes) else (60 if self._nodes else 0) + for n in nodes: + new = Node(id=new_node_id(), x=n.x + ox, y=n.y + oy, data=copy.deepcopy(n.data)) + remap[n.id] = new.id + item = _NodeItem(new, self) + self._nodes[new.id] = item + self._scene.addItem(item) + for e in edges: + s, t = remap.get(e.source), remap.get(e.target) + if s and t: + self._add_edge_item(Edge(id=new_edge_id(s, t), source=s, target=t)) + self._reposition_edges() + self.graph_changed.emit() + + # ---- key / drop ------------------------------------------------------- + def keyPressEvent(self, e): + if e.key() in (Qt.Key_Delete, Qt.Key_Backspace): + self.delete_selected() + return + if e.key() == Qt.Key_Escape: + self._connect_from = None + if self._temp_edge is not None: + self._scene.removeItem(self._temp_edge) + self._temp_edge = None + self._port_src = None + return + if e.key() in (Qt.Key_Plus, Qt.Key_Equal) and (e.modifiers() & Qt.ControlModifier): + self.zoom_in(); return + if e.key() == Qt.Key_Minus and (e.modifiers() & Qt.ControlModifier): + self.zoom_out(); return + if e.key() == Qt.Key_0 and (e.modifiers() & Qt.ControlModifier): + self.reset_zoom(); return + super().keyPressEvent(e) + + def dragEnterEvent(self, e): + if e.mimeData().hasFormat(CO4E_MIME): + e.acceptProposedAction() + else: + super().dragEnterEvent(e) + + def dragMoveEvent(self, e): + if e.mimeData().hasFormat(CO4E_MIME): + e.acceptProposedAction() + else: + super().dragMoveEvent(e) + + def dropEvent(self, e): + if not e.mimeData().hasFormat(CO4E_MIME): + super().dropEvent(e) + return + try: + payload = json.loads(bytes(e.mimeData().data(CO4E_MIME)).decode("utf-8")) + except (ValueError, UnicodeDecodeError): + return + pos = self.mapToScene(e.position().toPoint()) + if isinstance(payload, dict) and payload.get("kind") == "workflow": + # A whole flow dragged from the sidebar → merge its graph in. + # 3 dấu chấm vì file này giờ nằm ở presentation/co4e/ (sâu hơn + # ui/ gốc 1 cấp) — cùng module core.co4e như bản gốc, chỉ đổi số + # cấp cho đúng vị trí mới, không đổi cái được import. + from ...core.co4e import workflow_from_dict + wf = workflow_from_dict(payload.get("workflow", {})) + if wf.nodes: + self.add_workflow(wf.nodes, wf.edges, at=pos) + else: + from ...core.co4e import step_from_dict + self.add_palette_step(step_from_dict(payload), pos) + e.acceptProposedAction() diff --git a/presentation/co4e/canvas_items.py b/presentation/co4e/canvas_items.py new file mode 100644 index 0000000..04893e7 --- /dev/null +++ b/presentation/co4e/canvas_items.py @@ -0,0 +1,284 @@ +"""Các item vẽ trực tiếp trên canvas Co4E — dời khỏi ``ui/co4e_canvas.py``. + +Vấn đề đang có: gộp riêng ``Co4ECanvas`` (dòng 289-701 của file cũ) vào một +file mới đã đủ 413 dòng, vượt trần 400 dòng/file production của CASAN Check 2 +— dù không đổi gì bên trong. ``_NodeItem``/``_EdgeItem`` (và hằng số/hàm phụ +trợ chúng dùng để vẽ) là phần độc lập nhất về mặt trách nhiệm: chỉ vẽ và xử lý +sự kiện chuột NGAY TRÊN item đó, gọi ngược vào canvas cha qua tham số +``canvas`` được truyền ở constructor — nên tách được sang module riêng mà +không cần đổi bất kỳ hành vi nào. + +Cách làm: cắt dán NGUYÊN VĂN các khối dòng 43-56 (hằng số + ``_status_color``) +và 59-286 (``_NodeItem``, ``_EdgeItem``) từ ``ui/co4e_canvas.py`` sang đây, +không đổi tên/tham số/thứ tự/giá trị mặc định — kể cả các quirk đã bị +characterization test (``tests/characterization/test_co4e_canvas_widget.py``, +``test_co4e_canvas_geometry.py``) đóng đinh gián tiếp qua ``_rounded_path``/ +``_route``/``_elide`` mà ``_EdgeItem.update_path``/``_NodeItem.paint`` gọi. + +Tham số ``canvas: "Co4ECanvas"`` trong ``__init__`` của cả hai lớp dùng string +forward-reference vì ``Co4ECanvas`` giờ nằm ở module +``co4e_canvas_widget.py`` khác — import trực tiếp sẽ tạo vòng lặp (canvas +widget import ngược lại các item này). Đây thuần là type hint, không cần +import runtime. + +``ui/co4e_canvas.py`` import lại các tên public (``CO4E_MIME`` qua +``co4e_canvas_widget.py``) để giữ nguyên đường import mà test/characterization +khác đang dùng. +""" +from __future__ import annotations + +from typing import Optional + +from PySide6.QtCore import QPointF, QRectF, Qt +from PySide6.QtGui import QBrush, QColor, QPainterPath, QPen, QPolygonF +from PySide6.QtWidgets import QGraphicsItem, QGraphicsObject, QGraphicsPathItem, QMenu + +from ...core.co4e import STEP_DONE, STEP_ERROR, STEP_PLANNED, STEP_RUNNING, Edge, Node +from ...theme import current_palette +from .canvas_geometry import _elide, _rounded_path + + +def _status_color(status: str) -> str: + """Accent colour for a step's run status. Resolved per paint so the canvas + follows a live theme switch.""" + p = current_palette() + return { + "idle": p.text_muted, STEP_RUNNING: p.accent, STEP_DONE: p.success, + STEP_ERROR: p.danger, STEP_PLANNED: p.purple, "pending": p.text_faint, + }.get(status, p.text_muted) + +CO4E_MIME = "application/x-co4e-step" + +_NODE_W, _NODE_H = 210, 96 +_PORT_R = 6 # output port radius (the drag-to-connect handle) +_PORT_HIT = 15 # click tolerance around a port + + +class _NodeItem(QGraphicsObject): + """One draggable step card. Emits signals via the parent canvas.""" + + def __init__(self, node: Node, canvas: "Co4ECanvas"): + super().__init__() + self.node = node + self.canvas = canvas + self.status = "idle" + self._porting = False + self.setFlags(QGraphicsItem.ItemIsMovable | QGraphicsItem.ItemIsSelectable + | QGraphicsItem.ItemSendsGeometryChanges) + self.setAcceptHoverEvents(True) + self.setPos(node.x, node.y) + self.setZValue(2) + + def boundingRect(self) -> QRectF: + # slack left/right so the input/output ports (now on the sides) paint cleanly + return QRectF(-_PORT_R - 2, -3, _NODE_W + 2 * _PORT_R + 4, _NODE_H + 6) + + def _card_rect(self) -> QRectF: + return QRectF(1, 1, _NODE_W - 2, _NODE_H - 2) + + def paint(self, p, _opt, _widget=None): + tok = current_palette() + step = self.node.data + accent = QColor(_status_color(self.status)) + body = QColor(tok.surface_raised) + border = QColor(tok.accent) if self.isSelected() else QColor(tok.border) + p.setRenderHint(p.RenderHint.Antialiasing) + rect = self._card_rect() + path = QPainterPath() + radius = float(tok.radius_lg) + path.addRoundedRect(rect, radius, radius) + p.fillPath(path, QBrush(body)) + p.setPen(QPen(border, 2 if self.isSelected() else 1)) + p.drawPath(path) + # header stripe — a tint of the status colour, not the status colour + # itself, so the card's own text stays the brightest thing on it. + hdr = QRectF(rect.left(), rect.top(), rect.width(), 26) + hpath = QPainterPath() + hpath.addRoundedRect(hdr, radius, radius) + stripe = QColor(accent) + stripe.setAlpha(48) + p.fillPath(hpath, QBrush(stripe)) + # label + p.setPen(QColor(tok.text)) + f = p.font(); f.setBold(True); f.setPointSize(9); p.setFont(f) + p.drawText(QRectF(10, 4, _NODE_W - 20, 20), Qt.AlignVCenter | Qt.AlignLeft, + _elide(step.label, 26)) + # role badge + status + f.setBold(False); f.setPointSize(8); p.setFont(f) + p.setPen(accent) + p.drawText(QRectF(10, 30, _NODE_W - 20, 16), Qt.AlignLeft, step.role) + # body: instructions preview OR sub-agent chips + p.setPen(QColor(tok.text_muted)) + if step.is_parallel: + preview = "⇉ " + ", ".join(s.agent for s in step.sub_agents) if step.sub_agents else "⇉ (no sub-agents)" + else: + preview = step.instructions or "(no instructions)" + p.drawText(QRectF(10, 46, _NODE_W - 20, 30), Qt.TextWordWrap | Qt.AlignTop, + _elide(preview, 66)) + # footer: model + skills + status dot + p.setPen(QColor(tok.text_faint)) + foot = [] + if step.model: + foot.append(step.model) + if step.skills: + foot.append(f"skills:{len(step.skills)}") + foot.append(self.status) + p.drawText(QRectF(10, _NODE_H - 18, _NODE_W - 20, 14), Qt.AlignLeft, + _elide(" · ".join(foot), 34)) + # ---- ports --------------------------------------------------------- + # input port (top-center): hollow. output port (bottom-center): filled — + # the drag handle you pull to wire an edge to another step. + port_col = QColor(tok.accent) + # input port (left-center): hollow. output port (right-center): filled — + # the drag handle you pull to wire an edge to the next step (left→right). + p.setBrush(QBrush(body)); p.setPen(QPen(port_col, 1.4)) + p.drawEllipse(QPointF(1, _NODE_H / 2), _PORT_R - 1, _PORT_R - 1) + p.setBrush(QBrush(port_col)); p.setPen(QPen(port_col, 1.4)) + p.drawEllipse(QPointF(_NODE_W - 1, _NODE_H / 2), _PORT_R, _PORT_R) + + def _in_out_port(self, pos: QPointF) -> bool: + d = pos - QPointF(_NODE_W, _NODE_H / 2) + return (d.x() * d.x() + d.y() * d.y()) ** 0.5 <= _PORT_HIT + + def itemChange(self, change, value): + if change == QGraphicsItem.ItemPositionHasChanged: + self.node.x = float(self.pos().x()) + self.node.y = float(self.pos().y()) + self.canvas._reposition_edges() + self.canvas.graph_changed.emit() + elif change == QGraphicsItem.ItemSelectedHasChanged: + # a selected/edited node comes to the front (above the edges at z=3) + self.setZValue(4 if value else 2) + if value: + self.canvas.node_selected.emit(self.node.id) + return super().itemChange(change, value) + + def hoverMoveEvent(self, e): + # a hand cursor over the output port hints it's draggable-to-connect + self.setCursor(Qt.PointingHandCursor if self._in_out_port(e.pos()) else Qt.ArrowCursor) + super().hoverMoveEvent(e) + + def mousePressEvent(self, e): + if self.canvas._connect_from is not None: + self.canvas._finish_connect(self.node.id) + e.accept() + return + if e.button() == Qt.LeftButton and self._in_out_port(e.pos()): + # start a manual drag-to-connect from this node's output port + self._porting = True + self.canvas.begin_port_drag(self.node.id, self.mapToScene(QPointF(_NODE_W, _NODE_H / 2))) + e.accept() + return + super().mousePressEvent(e) + + def mouseMoveEvent(self, e): + if self._porting: + self.canvas.update_port_drag(self.mapToScene(e.pos())) + e.accept() + return + super().mouseMoveEvent(e) + + def mouseReleaseEvent(self, e): + if self._porting: + self._porting = False + self.canvas.finish_port_drag(self.mapToScene(e.pos())) + e.accept() + return + super().mouseReleaseEvent(e) + + def mouseDoubleClickEvent(self, e): + self.canvas.node_activated.emit(self.node.id) + e.accept() + + def contextMenuEvent(self, e): + menu = QMenu() + a_add = menu.addAction("＋ Add next step") + a_conn = menu.addAction("→ Connect from here") + a_del = menu.addAction("🗑 Delete step") + chosen = menu.exec(e.screenPos()) + if chosen is a_add: + self.canvas.add_step_below(self.node.id) + elif chosen is a_conn: + self.canvas.begin_connect(self.node.id) + elif chosen is a_del: + self.canvas.delete_node(self.node.id) + e.accept() + + def center(self) -> QPointF: + return self.pos() + QPointF(_NODE_W / 2, _NODE_H / 2) + + +class _EdgeItem(QGraphicsPathItem): + def __init__(self, edge: Edge, canvas: "Co4ECanvas"): + super().__init__() + self.edge = edge + self.canvas = canvas + self._dst: Optional[QPointF] = None + # Above node cards (z=2) so a connecting line is never hidden behind a + # step; a selected node bumps itself to the front while being edited. + self.setZValue(3) + self.setFlag(QGraphicsItem.ItemIsSelectable, True) + self.setAcceptHoverEvents(True) + self._hover = False + self._apply_pen() + + def _apply_pen(self): + tok = current_palette() + if self.isSelected(): + color, w = QColor(tok.accent), 3 + elif self._hover: + color, w = QColor(tok.text_muted), 3 + else: + color, w = QColor(tok.border_strong), 2 + self.setPen(QPen(color, w, Qt.SolidLine, Qt.RoundCap, Qt.RoundJoin)) + + def update_path(self, points): + self._dst = points[-1] if points else None + self.setPath(_rounded_path(points)) + + def boundingRect(self): + return super().boundingRect().adjusted(-10, -10, 10, 10) # room for the arrowhead + + def shape(self): + # Widen the clickable/selectable area so a thin line is easy to grab. + from PySide6.QtGui import QPainterPathStroker + stroker = QPainterPathStroker() + stroker.setWidth(14) + return stroker.createStroke(self.path()) + + def hoverEnterEvent(self, e): + self._hover = True + self._apply_pen() + self.update() + super().hoverEnterEvent(e) + + def hoverLeaveEvent(self, e): + self._hover = False + self._apply_pen() + self.update() + super().hoverLeaveEvent(e) + + def paint(self, p, opt, widget=None): + self._apply_pen() + super().paint(p, opt, widget) + # arrowhead at the target, pointing right into its (left) input port + if self._dst is not None: + p.setRenderHint(p.RenderHint.Antialiasing) + tip = self._dst + s = 7.0 + tri = QPolygonF([ + QPointF(tip.x() + 1, tip.y()), + QPointF(tip.x() - s, tip.y() - s * 0.7), + QPointF(tip.x() - s, tip.y() + s * 0.7), + ]) + col = self.pen().color() + p.setBrush(QBrush(col)) + p.setPen(QPen(col, 1)) + p.drawPolygon(tri) + + def contextMenuEvent(self, e): + menu = QMenu() + act_del = menu.addAction("🗑 Delete connection") + if menu.exec(e.screenPos()) is act_del: + self.canvas.delete_edge(self.edge) + e.accept() diff --git a/presentation/co4e/co4e_canvas_widget.py b/presentation/co4e/co4e_canvas_widget.py new file mode 100644 index 0000000..fd91376 --- /dev/null +++ b/presentation/co4e/co4e_canvas_widget.py @@ -0,0 +1,247 @@ +"""Widget canvas Co4E — dời khỏi ``ui/co4e_canvas.py``. + +Vấn đề đang có: ``Co4ECanvas`` (dòng 289-701 của file cũ) một mình đã 413 +dòng — vượt trần 400 dòng/file production của CASAN Check 2 kể cả sau khi tách +riêng ``_NodeItem``/``_EdgeItem`` (nay ở ``canvas_items.py``, xem docstring ở +đó) và 8 hàm hình học thuần (``canvas_geometry.py``). Phần còn lại của lớp lại +chia tiếp làm hai nhóm: mutation đồ thị (ở lại đây) và tương tác view thuần +tuý — zoom/pan/overlay/relayout/phím tắt/kéo-thả (dời sang +``_CanvasInteractionMixin`` ở ``canvas_interaction_mixin.py``, xem docstring +đó về lý do và ràng buộc MRO). + +Cách làm: cắt dán NGUYÊN VĂN dòng 289-317 (khai báo lớp + signal + hằng số zoom ++ ``__init__``), 348-481 (load/nodes/edges + toàn bộ mutation node/edge/port- +drag), 612-649 (status + reposition) từ ``ui/co4e_canvas.py`` — không đổi +tên/tham số/thứ tự/logic. + +``class Co4ECanvas(_CanvasInteractionMixin, QGraphicsView)``: mixin đứng +TRƯỚC ``QGraphicsView`` trong danh sách base để MRO ưu tiên các override của +mixin (``mousePressEvent``/``mouseMoveEvent``/``mouseReleaseEvent``/ +``wheelEvent``/``resizeEvent``/``keyPressEvent``/``dragEnterEvent``/ +``dragMoveEvent``/``dropEvent``) — nếu đảo thứ tự, các override đó sẽ bị +``QGraphicsView`` che mất và toàn bộ hành vi pan-chuột-giữa/zoom/kéo-thả sẽ +biến mất im lặng (không lỗi, chỉ rơi lại hành vi mặc định của Qt). + +``ui/co4e_canvas.py`` import lại ``Co4ECanvas``/``CO4E_MIME`` từ đây (không +alias) để giữ nguyên đường import public mà các test/characterization khác +đang dùng. +""" +from __future__ import annotations + +from typing import Dict, Optional + +from PySide6.QtCore import QPointF, QRectF, Qt, Signal +from PySide6.QtGui import QColor, QPen +from PySide6.QtWidgets import QGraphicsPathItem, QGraphicsScene, QGraphicsView + +from ...core.co4e import Edge, Node, Step, new_edge_id, new_node_id +from ...theme import current_palette +from .canvas_geometry import _ortho_path, _route +from .canvas_interaction_mixin import _CanvasInteractionMixin +from .canvas_items import CO4E_MIME, _NODE_H, _NODE_W, _EdgeItem, _NodeItem + +__all__ = ["Co4ECanvas", "CO4E_MIME"] + + +class Co4ECanvas(_CanvasInteractionMixin, QGraphicsView): + node_selected = Signal(str) # a node was clicked (→ config panel) + node_activated = Signal(str) # double-clicked + graph_changed = Signal() # nodes/edges/positions changed (autosave) + + _ZOOM_MIN, _ZOOM_MAX = 0.3, 3.0 + + def __init__(self): + super().__init__() + self.setObjectName("co4eCanvas") # themed frame (see theme.py) + self._scene = QGraphicsScene(self) + self.setScene(self._scene) + self.setRenderHint(self.renderHints().Antialiasing) + self.setDragMode(QGraphicsView.RubberBandDrag) + self.setTransformationAnchor(QGraphicsView.AnchorUnderMouse) + self.setAcceptDrops(True) + self._nodes: Dict[str, _NodeItem] = {} + self._edges: list[_EdgeItem] = [] + self._connect_from: Optional[str] = None + self._zoom = 1.0 + self._panning = False # middle-mouse drag-to-pan + self._pan_start = None + self._overlay = None # bottom-left zoom/fit controls (parented to viewport) + # manual drag-to-connect state + self._port_src: Optional[str] = None + self._port_src_pt: Optional[QPointF] = None + self._temp_edge: Optional[QGraphicsPathItem] = None + + # ---- load / serialize ------------------------------------------------- + def load(self, nodes, edges) -> None: + self._scene.clear() + self._nodes.clear() + self._edges.clear() + self._connect_from = None + self._port_src = None + self._temp_edge = None + for n in nodes: + item = _NodeItem(n, self) + self._nodes[n.id] = item + self._scene.addItem(item) + for e in edges: + if e.source in self._nodes and e.target in self._nodes: + self._add_edge_item(e) + self._reposition_edges() + + def nodes(self): + return [it.node for it in self._nodes.values()] + + def edges(self): + return [it.edge for it in self._edges] + + # ---- mutation --------------------------------------------------------- + def add_node(self, step: Step, x: float = 60.0, y: float = 60.0, + connect_from: str = "") -> str: + node = Node(id=new_node_id(), x=x, y=y, data=step) + item = _NodeItem(node, self) + self._nodes[node.id] = item + self._scene.addItem(item) + if connect_from and connect_from in self._nodes: + self._make_edge(connect_from, node.id) + self._reposition_edges() + self.graph_changed.emit() + self.node_selected.emit(node.id) + return node.id + + def add_step_below(self, node_id: str) -> None: + """Add the next step to the RIGHT of ``node_id`` (horizontal flow).""" + parent = self._nodes.get(node_id) + if parent is None: + return + step = Step(label="New Step") + self.add_node(step, x=parent.node.x + _NODE_W + 150, y=parent.node.y, connect_from=node_id) + + def _chain_tail(self) -> str: + """A node with no outgoing edge (so a freshly added node chains on).""" + sources = {e.edge.source for e in self._edges} + tails = [nid for nid in self._nodes if nid not in sources] + return tails[-1] if tails else (next(reversed(self._nodes), "") if self._nodes else "") + + def add_palette_step(self, step: Step, pos: QPointF) -> None: + tail = self._chain_tail() + self.add_node(step, x=pos.x(), y=pos.y(), connect_from=tail) + + def begin_connect(self, source_id: str) -> None: + self._connect_from = source_id + + def _finish_connect(self, target_id: str) -> None: + src = self._connect_from + self._connect_from = None + if src and src != target_id: + self._make_edge(src, target_id) + + # ---- manual drag-to-connect (from a node's output port) --------------- + def begin_port_drag(self, source_id: str, scene_pt: QPointF) -> None: + self._port_src = source_id + self._port_src_pt = scene_pt + self._temp_edge = QGraphicsPathItem() + self._temp_edge.setZValue(3.5) # above nodes + edges while connecting + self._temp_edge.setPen( + QPen(QColor(current_palette().accent), 2, Qt.DashLine, Qt.RoundCap)) + self._scene.addItem(self._temp_edge) + + def update_port_drag(self, scene_pt: QPointF) -> None: + if self._temp_edge is None or self._port_src_pt is None: + return + self._temp_edge.setPath(_ortho_path(self._port_src_pt, scene_pt)) + + def finish_port_drag(self, scene_pt: QPointF) -> None: + src = self._port_src + if self._temp_edge is not None: + self._scene.removeItem(self._temp_edge) + self._temp_edge = None + self._port_src = None + self._port_src_pt = None + tgt = self._node_at(scene_pt) + if src and tgt and tgt != src: + self._make_edge(src, tgt) + + def _node_at(self, scene_pt: QPointF) -> Optional[str]: + for it in self._scene.items(scene_pt): + if isinstance(it, _NodeItem): + return it.node.id + return None + + def _make_edge(self, source: str, target: str) -> None: + if source == target: + return + if any(e.edge.source == source and e.edge.target == target for e in self._edges): + return + edge = Edge(id=new_edge_id(source, target), source=source, target=target) + self._add_edge_item(edge) + self._reposition_edges() + self.graph_changed.emit() + + def _add_edge_item(self, edge: Edge) -> None: + item = _EdgeItem(edge, self) + self._edges.append(item) + self._scene.addItem(item) + + def delete_edge(self, edge: Edge) -> None: + for e in list(self._edges): + if e.edge is edge or (e.edge.source == edge.source and e.edge.target == edge.target): + self._scene.removeItem(e) + self._edges.remove(e) + self.graph_changed.emit() + + def delete_node(self, node_id: str) -> None: + item = self._nodes.pop(node_id, None) + if item is None: + return + self._scene.removeItem(item) + for e in list(self._edges): + if e.edge.source == node_id or e.edge.target == node_id: + self._scene.removeItem(e) + self._edges.remove(e) + self._reposition_edges() + self.graph_changed.emit() + + def delete_selected(self) -> None: + for nid in [it.node.id for it in self._nodes.values() if it.isSelected()]: + self.delete_node(nid) + for e in [it.edge for it in self._edges if it.isSelected()]: + self.delete_edge(e) + + def update_node_status(self, node_id: str, status: str) -> None: + item = self._nodes.get(node_id) + if item is not None: + item.status = status + item.update() + + def reset_statuses(self) -> None: + for it in self._nodes.values(): + it.status = "idle" + it.update() + + def refresh_node(self, node_id: str) -> None: + item = self._nodes.get(node_id) + if item is not None: + item.update() + + def _node_rects(self, exclude): + """Rectangles of every node except ``exclude`` (inflated a little), used + as obstacles the edge router steers around.""" + m = 12.0 + out = [] + for nid, item in self._nodes.items(): + if nid in exclude: + continue + p = item.pos() + out.append(QRectF(p.x(), p.y(), _NODE_W, _NODE_H).adjusted(-m, -m, m, m)) + return out + + def _reposition_edges(self) -> None: + for e in self._edges: + s = self._nodes.get(e.edge.source) + t = self._nodes.get(e.edge.target) + if s is None or t is None: + continue + src = s.pos() + QPointF(_NODE_W, _NODE_H / 2) # right-center (output) + dst = t.pos() + QPointF(0, _NODE_H / 2) # left-center (input) + obstacles = self._node_rects({e.edge.source, e.edge.target}) + e.update_path(_route(src, dst, obstacles)) diff --git a/presentation/co4e/co4e_chat_view.py b/presentation/co4e/co4e_chat_view.py new file mode 100644 index 0000000..366949b --- /dev/null +++ b/presentation/co4e/co4e_chat_view.py @@ -0,0 +1,258 @@ +"""Khu vực CHAT của Co4E (composer + autocomplete ``/skill:``/``/agent:``) — +tách khỏi ``ui/co4e_tab.py``. + +Vấn đề đang có: 3 hàm module-level (``_skill_names``/``_agent_names``/ +``_directive_token``), lớp ``_ChatInput`` (ô chat có popup autocomplete) và +phần DỰNG WIDGET của ``Co4ETab._build_chat`` (nguyên bản ở ``ui/co4e_tab.py`` +dòng 63-73, 124-228 và 1030-1093) nằm rải trong file container 2000+ dòng — +vượt xa giới hạn CASAN (≤400 dòng mỗi file production) và không tách được +riêng để test mà không phải dựng cả ``Co4ETab``. Không phần nào trong số này +đọc/ghi trạng thái RIÊNG của ``Co4ETab`` lúc DỰNG (``_flow_logs`` là ngoại lệ — +xem chú thích ở ``ChatPanel`` bên dưới), nên tách được thành các hàm/lớp con +độc lập. + +Cách làm: dời nguyên 3 hàm + ``_ChatInput`` — KHÔNG đổi tên, KHÔNG đổi hành vi +(kể cả các quirk trông như bug, xem docstring của ``tests/characterization/ +test_co4e_chat_view.py``: agent chèn nguyên tên KHÔNG slugify còn skill có, +dedup theo tên hiển thị không theo slug, Enter có hai hành vi tuỳ popup còn +hiện hay đã ẩn, ...). Phần dựng widget của ``_build_chat`` được bọc vào một +lớp mới ``ChatPanel(QWidget)`` theo đúng khuôn mẫu đã dùng cho +``AgentListPanel``/``SkillsListPanel``/``RunsPagePanel`` (xem +``presentation/co4e/agent_list_panel.py``): panel chỉ dựng cấu trúc UI, KHÔNG +tự nối signal (``ui/co4e_tab.py`` mới là nơi biết ``_toggle_messages``/ +``_chat_send`` là gì) và KHÔNG tự tạo ``_flow_logs`` (dict per-flow ChatView — +đó là STATE của ``Co4ETab``, ghi bởi ``_ensure_flow_log``/``_active_log`` nằm +ngoài phạm vi panel này). Tên thuộc tính giữ NGUYÊN so với bản gốc +(``msgs_icon``, ``msgs_title``, ``chat_toggle_btn``, ``chat_stack``, +``chat_input_row``, ``chat_input``, ``chat_send_btn``, ``co4e_routing_toggle``) +vì bị tham chiếu ở rất nhiều nơi khác của ``Co4ETab`` (``_toggle_messages``, +``_chat_send``, ``_refresh_usage_total``, ...) — đổi tên sẽ buộc phải sửa mọi +chỗ đó, vượt phạm vi lượt tách này. Riêng ``_mhdr`` (biến cục bộ đặt tên riêng +lẻ, không theo quy ước công khai) đổi thành ``.header`` và ``_usage_total_lbl`` +đổi thành ``.usage_total_lbl`` — cả hai an toàn vì bản gốc chỉ dùng nội bộ +``_build_chat``/``_toggle_messages`` (đã kiểm bằng grep toàn file), và +``ui/co4e_tab.py`` sau khi tách vẫn gán lại các tên cũ (``self._mhdr``, +``self._usage_total_lbl``) làm alias trỏ vào hai thuộc tính công khai này, nên +mọi chỗ dùng tên cũ trên ``Co4ETab`` không phải sửa. +""" +from __future__ import annotations + +import re +from typing import List + +from PySide6.QtCore import Qt, QSize, Signal +from PySide6.QtWidgets import ( + QHBoxLayout, QLabel, QLineEdit, QListWidget, QListWidgetItem, QPushButton, + QStackedWidget, QVBoxLayout, QWidget, +) + +from ...core import co4e, skills as skills_mod +from ...core.co4e_builtins import BUILTIN_AGENTS +from ...i18n import tr +from ...theme import current_palette +from ...ui.icons import icon +from ...ui.routing_toggle import RoutingToggle + + +def _skill_names() -> List[str]: + try: + return [s.name for s in skills_mod.list_skills() + skills_mod.builtin_skills()] + except Exception: # noqa: BLE001 + return [] + + +def _agent_names() -> List[str]: + names = [a.name for a in co4e.list_custom_agents()] + names += [a.name for a in BUILTIN_AGENTS if a.name not in names] + return names + + +def _directive_token(text: str, pos: int): + """Locate a ``/skill[:x]`` or ``/agent[:x]`` directive the cursor is on, + anywhere in the line. Returns ``(start, kind, partial)`` or ``None``.""" + before = text[:pos] + start = re.search(r"\S*$", before).start() + token = before[start:] + m = re.match(r"^/(skill|agent):?([\w\-.]*)$", token) + if m: + return start, m.group(1), m.group(2) + for kind in ("skill", "agent"): + if len(token) >= 2 and ("/" + kind).startswith(token): + return start, kind, "" + return None + + +class _ChatInput(QLineEdit): + """Chat box with ``/skill:`` and ``/agent:`` autocomplete (parity with the + Cowork composer). The popup never grabs focus, so typing keeps flowing.""" + + submit = Signal() + + def __init__(self, parent=None): + super().__init__(parent) + self._popup = QListWidget() + self._popup.setWindowFlags(Qt.Tool | Qt.FramelessWindowHint + | Qt.WindowStaysOnTopHint | Qt.NoDropShadowWindowHint) + self._popup.setAttribute(Qt.WA_ShowWithoutActivating, True) + self._popup.setFocusPolicy(Qt.NoFocus) + self._popup.itemClicked.connect(lambda _i: self._accept()) + self.textEdited.connect(self._maybe_popup) + + def _maybe_popup(self, *_a) -> None: + tok = _directive_token(self.text(), self.cursorPosition()) + if tok is None: + self._popup.hide() + return + _start, kind, partial = tok + f = partial.lower() + self._popup.clear() + if kind == "skill": + for name in _skill_names(): + if f in name.lower(): + self._add_row(name, f"/skill:{co4e.slugify(name)} ", name) + else: + for name in _agent_names(): + if f in name.lower(): + self._add_row(name, f"/agent:{name} ", name) + if self._popup.count() == 0: + self._popup.hide() + return + self._popup.setCurrentRow(0) + rows = min(7, self._popup.count()) + h = 8 + rows * 22 + self._popup.resize(max(280, self.width()), h) + tl = self.mapToGlobal(self.rect().topLeft()) + self._popup.move(tl.x(), tl.y() - h - 2) + self._popup.show() + + def _add_row(self, label: str, replacement: str, tip: str) -> None: + it = QListWidgetItem(label) + it.setData(Qt.UserRole, replacement) + it.setToolTip(tip) + self._popup.addItem(it) + + def _accept(self) -> None: + item = self._popup.currentItem() + self._popup.hide() + if item is None: + return + replacement = item.data(Qt.UserRole) + tok = _directive_token(self.text(), self.cursorPosition()) + start = tok[0] if tok else self.cursorPosition() + pos = self.cursorPosition() + full = self.text() + new_text = full[:start] + replacement + full[pos:] + self.setText(new_text) + self.setCursorPosition(start + len(replacement)) + self.setFocus() + + def focusOutEvent(self, e): # noqa: N802 + if not self._popup.underMouse(): + self._popup.hide() + super().focusOutEvent(e) + + def keyPressEvent(self, e): # noqa: N802 + if self._popup.isVisible(): + k = e.key() + n = self._popup.count() + if k in (Qt.Key_Down, Qt.Key_Up) and n: + step = 1 if k == Qt.Key_Down else -1 + self._popup.setCurrentRow((self._popup.currentRow() + step) % n) + return + if k in (Qt.Key_Tab,): + self._accept() + return + if k == Qt.Key_Escape: + self._popup.hide() + return + if k in (Qt.Key_Return, Qt.Key_Enter): + self._accept() + return + if e.key() in (Qt.Key_Return, Qt.Key_Enter): + self.submit.emit() + return + super().keyPressEvent(e) + + +class ChatPanel(QWidget): + """Widget khu vực CHAT của Co4E: header "Messages" + ``chat_stack`` (một + ``ChatView`` mỗi flow) + composer (ô chat + routing toggle + nút gửi). + + Vai trò: một widget con thuần ở tầng presentation, chỉ dựng cấu trúc UI + (đúng những gì ``ui/co4e_tab.py`` dòng 1030-1093 làm trước đây), không biết + gì về ``Co4ETab``/``_toggle_messages``/``_chat_send``. Bên gọi (hiện là + ``Co4ETab``) tự đọc các thuộc tính công khai dưới đây để nối signal và nạp + dữ liệu — panel không tự làm hộ, để giữ đúng ranh giới "một nơi một việc" + đã dùng cho ``AgentListPanel``/``SkillsListPanel``/``RunsPagePanel``. + + KHÔNG tự tạo ``_flow_logs``: dict ``{wf_id: ChatView}`` là STATE của + ``Co4ETab`` (ghi bởi ``_ensure_flow_log``, đọc bởi ``_active_log``/ + ``chat_log``) — panel chỉ dựng cái ``chat_stack`` (vỏ chứa) rỗng, việc nạp + từng ``ChatView`` vào đó khi có flow mới vẫn ở ``Co4ETab``. + + Panel TỰ đặt trạng thái hiển thị mặc định là COLLAPSED (chỉ header hiện, + thân chat ẩn) ngay trong ``__init__`` — đây là phần "hình dạng lúc mới + dựng" của chính panel, khác với ``_msgs_collapsed``/``_vsplit_sizes`` (cờ + + kích thước để khôi phục splitter khi mở lại) vẫn là STATE của ``Co4ETab`` + vì chỉ ``_toggle_messages`` (ở lại ``Co4ETab``, đọc ``self._vsplit`` của cả + tab) mới dùng tới. + """ + + def __init__(self, ctx) -> None: + super().__init__() + lay = QVBoxLayout(self) + lay.setContentsMargins(0, 0, 0, 0) + lay.setSpacing(0) + # "Messages" header at the TOP, above the chat box. Toggling it shows or + # hides the WHOLE chat box (message list + composer) below it. + self.header = QWidget(); self.header.setObjectName("msgHeader") + mh = QHBoxLayout(self.header); mh.setContentsMargins(6, 3, 6, 3); mh.setSpacing(6) + self.msgs_icon = QLabel(); self.msgs_icon.setPixmap(icon("message").pixmap(14, 14)) + self.msgs_title = QLabel(tr("co4e.messages")); self.msgs_title.setObjectName("hint") + self.chat_toggle_btn = QPushButton() + self.chat_toggle_btn.setObjectName("msgToggle") + self.chat_toggle_btn.setFlat(True) + self.chat_toggle_btn.setIcon(icon("chevron-up")) # collapsed → points up (click to expand) + self.chat_toggle_btn.setFixedSize(22, 22) + # KHONG noi .clicked o day: ben goi (Co4ETab) tu quyet dinh slot nao + # xu ly (_toggle_messages) - panel chi dung widget, khong biet no la gi. + mh.addWidget(self.msgs_icon) + mh.addWidget(self.msgs_title) + mh.addStretch(1) + mh.addWidget(self.chat_toggle_btn) + lay.addWidget(self.header) # header on top + # Point-conversation (message bubbles) like Cowork, not a flat textbox. + # ONE ChatView PER FLOW (keyed by workflow id) inside a stack, so each flow + # tab has its OWN separate conversation and they never bleed into each other. + self.chat_stack = QStackedWidget() + lay.addWidget(self.chat_stack, 1) + self.chat_input_row = QWidget() + crow = QVBoxLayout(self.chat_input_row) + crow.setContentsMargins(0, 4, 0, 0); crow.setSpacing(3) + # Running conversation token/cost TOTAL for this flow (↓in ↑out ▤ctx + # $cost) at the bottom, exactly like Cowork's conversation total. + self.usage_total_lbl = QLabel("") + self.usage_total_lbl.setObjectName("hint") + self.usage_total_lbl.setStyleSheet( + f"color: {current_palette().text_faint}; font-size: 11px;") + crow.addWidget(self.usage_total_lbl) + _inp = QWidget(); row = QHBoxLayout(_inp); row.setContentsMargins(0, 0, 0, 0) + self.chat_input = _ChatInput() + self.chat_input.setPlaceholderText(tr("co4e.chat_placeholder")) + # KHONG noi .submit o day: cung ly do nhu chat_toggle_btn o tren + # (ben goi noi toi _chat_send cua chinh no). + self.chat_send_btn = QPushButton(tr("co4e.send")); self.chat_send_btn.setIcon(icon("send")) + # KHONG noi .clicked o day: cung ly do nhu tren. + row.addWidget(self.chat_input, 1) + # Off/Auto/Manual routing toggle for Co4E (surface key "co4e"). + self.co4e_routing_toggle = RoutingToggle(ctx, "co4e") + row.addWidget(self.co4e_routing_toggle) + row.addWidget(self.chat_send_btn) + crow.addWidget(_inp) + lay.addWidget(self.chat_input_row) + # Default = COLLAPSED: only the "Messages" header shows; the chat box is + # hidden and the canvas gets the room until the user expands it. + self.chat_stack.hide() + self.chat_input_row.hide() + self.chat_toggle_btn.setToolTip(tr("co4e.tt_expand_msgs")) + self.setMaximumHeight(self.header.sizeHint().height() + 6) diff --git a/presentation/co4e/co4e_run_control_widget.py b/presentation/co4e/co4e_run_control_widget.py new file mode 100644 index 0000000..2389eae --- /dev/null +++ b/presentation/co4e/co4e_run_control_widget.py @@ -0,0 +1,116 @@ +"""Panel trang "Runs" (danh sách các lần chạy flow) của Co4E — tách khỏi +``ui/co4e_tab.py``. + +Vấn đề đang có: giống ``AgentListPanel``/``SkillsListPanel`` (xem +``presentation/co4e/agent_list_panel.py``/``presentation/co4e/skills_list_panel.py``), +đoạn dựng widget trang "Runs" (nguyên bản ở ``ui/co4e_tab.py``, method +``_build_runs_page``, dòng 869-928) nằm nguyên trong thân một method của +``Co4ETab``. Đoạn này chỉ tạo ``QWidget``/``QPushButton``/``QLabel``/ +``QTableWidget`` + layout bọc — không đọc/ghi trạng thái nào của ``Co4ETab`` +khi DỰNG (chỉ khi người dùng bấm nút mới cần tới +``_show_runs``/``_open_workspace_folder``/``_stop_selected_run``/... của +``Co4ETab``) — nên tách được thành một ``QWidget`` con độc lập. + +Cách làm: dời nguyên phần dựng widget sang đây, KHÔNG đổi tên thuộc tính so +với bản gốc ngoại trừ đổi TÊN THUỘC TÍNH cho khớp quy ước panel công khai +(``runs_back_btn`` → ``back_btn``, ``runs_title`` → ``title_label``, +``run_stop_btn`` → ``stop_btn``, ``run_rename_btn`` → ``rename_btn``, +``run_del_btn`` → ``del_btn``, ``run_clear_btn`` → ``clear_btn``, +``runs_table`` → ``table``); riêng ``ws_folder_btn`` GIỮ NGUYÊN TÊN vì +``ui/co4e_tab.py`` (dòng ~1669) còn chỗ kiểm ``hasattr(self, "ws_folder_btn")`` +— đổi tên sẽ làm nhánh đó không còn nhận ra thuộc tính này. Giá trị/thứ tự +dựng widget giữ y hệt bản gốc. + +Panel KHÔNG tự nối bất kỳ signal nào (``.clicked``/``.itemDoubleClicked``/ +``.customContextMenuRequested``) và KHÔNG tự gọi ``_refresh_ws_folder_btn()`` +— theo đúng nguyên tắc "một việc rẽ ra một lần" đã dùng cho +``AgentListPanel``/``SkillsListPanel``: việc dựng widget (ở đây) tách khỏi +việc nối hành vi (vẫn ở ``Co4ETab``, nơi biết ``_stop_selected_run``/ +``_rename_selected_run``/``_delete_selected_run``/``_open_run_from_table``/ +``_open_workspace_folder``/``_runs_context_menu``/``_refresh_ws_folder_btn`` +là gì). Gộp hai việc đó vào panel sẽ buộc panel phải biết về ``Co4ETab``, xoá +mất lý do tách nó ra. +""" +from __future__ import annotations + +from PySide6.QtCore import Qt +from PySide6.QtWidgets import ( + QHBoxLayout, QHeaderView, QLabel, QPushButton, QTableWidget, QVBoxLayout, + QWidget, +) + +from ...i18n import tr +from ...ui.icons import icon + + +class RunsPagePanel(QWidget): + """Widget trang "Runs" của Co4E: thanh tiêu đề + hàng nút thao tác + bảng. + + Vai trò: một widget con thuần ở tầng presentation, chỉ dựng cấu trúc UI + (đúng những gì ``ui/co4e_tab.py`` dòng 869-928 làm trước đây), không biết + gì về ``Co4ETab``/``_show_runs``/``_stop_selected_run``/... Bên gọi (hiện + là ``Co4ETab``) tự đọc 8 thuộc tính công khai dưới đây để nối signal, gọi + ``_refresh_ws_folder_btn()`` và nạp dữ liệu — panel không tự làm hộ, để + giữ đúng ranh giới "một nơi một việc" đã dùng cho ``AgentListPanel``/ + ``SkillsListPanel``. + """ + + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + v = QVBoxLayout(self) + hdr = QHBoxLayout() + # The Runs page covers the flow toolbar, so it carries its own way back — + # otherwise the toggle that opened it is off screen. + self.back_btn = QPushButton(tr("co4e.back_to_flow")) + self.back_btn.setIcon(icon("chevron-left")) + self.back_btn.setToolTip(tr("co4e.tt_back_to_flow")) + # KHONG noi .clicked o day: ben goi (Co4ETab) tu quyet dinh slot nao + # xu ly - panel chi dung widget, khong biet _show_runs la gi. + hdr.addWidget(self.back_btn) + self.title_label = QLabel(tr("co4e.running_flows")) + self.title_label.setObjectName("hint") + hdr.addWidget(self.title_label) + # Show + open the workspace folder where flow outputs land (below the tab, + # next to the title) so the files a flow produced are easy to find. + self.ws_folder_btn = QPushButton() + self.ws_folder_btn.setIcon(icon("folder")) + self.ws_folder_btn.setFlat(True) + self.ws_folder_btn.setCursor(Qt.PointingHandCursor) + # KHONG noi .clicked va KHONG tu goi _refresh_ws_folder_btn() o day: + # ca hai deu thuoc Co4ETab (can ctx/manager de biet duong dan that). + hdr.addWidget(self.ws_folder_btn) + hdr.addStretch(1) + self.stop_btn = QPushButton(tr("co4e.stop")) + self.stop_btn.setIcon(icon("stop")) + self.stop_btn.setObjectName("danger") + self.stop_btn.setToolTip(tr("co4e.tt_stop_run")) + # KHONG noi .clicked o day: cung ly do nhu back_btn o tren. + self.rename_btn = QPushButton(tr("co4e.rename_run")) + self.rename_btn.setIcon(icon("edit")) + self.rename_btn.setToolTip(tr("co4e.tt_rename_run")) + # KHONG noi .clicked o day: cung ly do nhu back_btn o tren. + self.del_btn = QPushButton(tr("co4e.delete_run")) + self.del_btn.setIcon(icon("trash")) + self.del_btn.setToolTip(tr("co4e.tt_delete_run")) + # KHONG noi .clicked o day: cung ly do nhu back_btn o tren. + self.clear_btn = QPushButton(tr("co4e.clear_done")) + self.clear_btn.setToolTip(tr("co4e.tt_clear_runs")) + # KHONG noi .clicked o day: cung ly do nhu back_btn o tren. (Ban goc + # noi thang toi lambda: self.manager.clear_finished(), khong qua mot + # method rieng - Co4ETab van giu dung quirk do khi noi lai signal nay.) + hdr.addWidget(self.stop_btn) + hdr.addWidget(self.rename_btn) + hdr.addWidget(self.del_btn) + hdr.addWidget(self.clear_btn) + v.addLayout(hdr) + self.table = QTableWidget(0, 5) + self.table.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch) + self.table.verticalHeader().setVisible(False) + self.table.setEditTriggers(QTableWidget.NoEditTriggers) + self.table.setSelectionBehavior(QTableWidget.SelectRows) + self.table.setToolTip(tr("co4e.tt_runs_list")) + # KHONG noi .itemDoubleClicked o day: cung ly do nhu back_btn o tren. + # Right-click a run → Open / Delete (delete a single old run from history). + self.table.setContextMenuPolicy(Qt.CustomContextMenu) + # KHONG noi .customContextMenuRequested o day: cung ly do nhu tren. + v.addWidget(self.table, 1) diff --git a/presentation/co4e/co4e_tab.py b/presentation/co4e/co4e_tab.py new file mode 100644 index 0000000..5f37a74 --- /dev/null +++ b/presentation/co4e/co4e_tab.py @@ -0,0 +1,69 @@ +"""Factory dựng tab Co4E Studio cho bootstrap.py — điểm nối duy nhất giữa +lớp Qt cũ (``cowork_local.ui.co4e_tab.Co4ETab``, đang chờ tách nhỏ) và phần +lắp ráp ứng dụng. + +Vì sao có file này dù chưa tách xong widget con nào: quy ước #2 của team là +"nộp factory, không tự lắp vào app" — người giữ bootstrap.py (Nam, N1) cần +chốt được chữ ký sớm (hạn lắp 28/08) trong khi phần thân bên trong Co4E Studio +vẫn còn đang được tách dần sang presentation/co4e/*.py và +application/workflows/co4e_workflow_service.py. + +Chữ ký ``build_co4e_tab(ctx, workflow_service)`` KHÔNG có default cho +``workflow_service``: nếu cho default None, lúc bootstrap.py gọi thiếu tham số +vẫn hợp lệ cú pháp, dựng ra tab không có service, và lỗi chỉ nổ muộn bên trong +widget khi người dùng bấm Run — thay vì nổ ngay tại dòng lắp ráp. Chưa có +service thật thì bên gọi tự truyền fake (xem tests/fakes/fake_co4e_workflow_service.py). + +QUAN TRỌNG — đây KHÔNG phải bản cuối: thân hàm hiện tại chỉ bọc nguyên +``Co4ETab`` cũ 1:1 và CHƯA dùng đến ``workflow_service``. Chữ ký thì giữ +nguyên — đó là hợp đồng với bootstrap.py. + +Cập nhật 25/08 — cả 6 widget con (skills/agent list, canvas, node property, +run control, chat view) ĐÃ tách xong khỏi ``ui/co4e_tab.py`` và ``Co4ETab`` +NỘI BỘ đã lắp ráp lại từ các panel mới đó (xem ``ui/co4e_tab.py``: +``_build_sidebar``/``_build_runs_page``/``_build_chat``) — phần "lắp ráp từ +widget đã tách" coi như xong. PHẦN CÒN LẠI — đổi ``Co4ETab`` để thật sự dùng +``workflow_service`` thay cho ``core/co4e_run_manager.py::Co4ERunManager`` nội +bộ — ĐÃ QUYẾT ĐỊNH HOÃN LẠI thành một task riêng, không làm chung với việc +tách widget: ``self.manager`` (``Co4ERunManager``) bị dùng ở 24 chỗ trong +``Co4ETab``, và khác với các bước tách widget (chỉ động tới phần DỰNG UI), +việc đổi sang ``Co4EWorkflowService`` đòi phải (1) viết một adapter Qt thật +(``WorkflowRunner``) bọc ``AgentWorker``/``QThread`` — hiện chưa tồn tại, và +(2) sửa mọi chỗ đọc ``RunHandle.wf`` như một đối tượng ``Workflow`` (ví dụ +``ui/co4e_tab.py`` dòng ~1330: ``h.wf.nodes``) thành đọc dict thô +(``RunRecord.wf``) — tức là chạm trực tiếp vào đúng luồng gọi AI thật/QThread +mà mọi bước tách widget trước đó đã cố tình né. Trước khi đổi, cần lưới an +toàn riêng (characterization đầy đủ cho ``Co4ERunManager``) — xem +``tests/characterization/test_co4e_run_manager_behavior.py`` hiện có cho một +phần hành vi, chưa phủ hết 24 điểm gọi này. +""" + +from __future__ import annotations + +from typing import TYPE_CHECKING + +if TYPE_CHECKING: + from PySide6.QtWidgets import QWidget + + +def build_co4e_tab(ctx, workflow_service) -> QWidget: + """Factory tạo tab Co4E Studio. + + Vai trò: hàm lắp ráp ở tầng presentation, là API ổn định mà + bootstrap.py gọi để lấy widget tab Co4E — không phải nơi chứa logic. + Logic thật vẫn nằm ở ``cowork_local.ui.co4e_tab.Co4ETab`` cho tới khi + được tách hết sang các module trong presentation/co4e/. + + ``workflow_service`` chưa được dùng ở bản này (Co4ETab cũ tự quản lý + state qua Co4ERunManager nội bộ). Tham số vẫn bắt buộc ngay từ bây giờ + để chữ ký không phải đổi ở lượt tách kế tiếp — chỉ thân hàm đổi. + """ + # Import trong thân hàm, không ở đầu module: ui/co4e_tab.py hiện kéo theo + # toàn bộ cây widget Co4E Studio cũ (canvas, run manager, chat view...). + # Đặt ở đây để module factory này nhẹ khi bootstrap.py chỉ cần đọc chữ ký/ + # import hàm mà chưa gọi nó — chi phí load Qt widget nặng chỉ trả khi + # build_co4e_tab() thực sự được gọi. Không phải để né circular import + # (ui/co4e_tab.py không import ngược presentation/co4e/). + from ...ui.co4e_tab import Co4ETab + + return Co4ETab(ctx) diff --git a/presentation/co4e/node_property_actions_mixin.py b/presentation/co4e/node_property_actions_mixin.py new file mode 100644 index 0000000..81c5ed8 --- /dev/null +++ b/presentation/co4e/node_property_actions_mixin.py @@ -0,0 +1,202 @@ +"""Các hành động (sub-agent/attachment/AI-draft/load-models) của +``StepConfigPanel`` — tách khỏi ``ui/co4e_config_panel.py`` (nguyên bản dòng +380-528) để ``presentation/co4e/node_property_panel.py`` không vượt trần 400 +dòng của CASAN Check 2. + +Vấn đề đang có: ``StepConfigPanel`` gộp cả việc dựng UI (``__init__``) lẫn 8 +hành động phụ trợ (thêm/sửa/xoá sub-agent, thêm/xoá attachment, soạn hướng dẫn +bằng AI, tải danh sách model) trong cùng một class 396 dòng — vượt trần nếu +để nguyên một file. Support cắt riêng phần hành động ra một ``mixin`` là hợp +lý vì các method này CHỈ đọc/ghi trạng thái đã có sẵn trên ``self`` do +``StepConfigPanel.__init__`` định nghĩa (``self._step``, ``self._node_id``, +``self.ctx``, ``self.sub_list``, ``self.attach_list``, +``self.instructions_edit``, ``self.gen_btn``, ``self.model_combo``, +``self.load_models_btn``) — không có state/``__init__`` riêng của mixin. + +Cách làm: dời NGUYÊN VĂN 8 method (``_available_agent_names``, +``_add_subagent``, ``_edit_subagent``, ``_del_subagent``, ``_add_attachment``, +``_del_attachment``, ``_ai_draft``, ``_load_models``) vào class MỚI +``_StepConfigActionsMixin``. Không đổi tên, không đổi thứ tự tham số, không +gộp/tách hàm nào bên trong. ``node_property_panel.py`` ghép mixin này với +``QScrollArea`` qua đa kế thừa (``class StepConfigPanel(_StepConfigActionsMixin, +QScrollArea)``) — không có method nào ở đây trùng tên với ``QScrollArea`` nên +thứ tự kế thừa không ảnh hưởng hành vi (khác trường hợp +``co4e_canvas_widget.py``, nơi thứ tự mixin-trước-Qt-base là bắt buộc vì có +override trùng tên). + +Import trong từng method giữ nguyên y hệt bản gốc (kể cả các import cục bộ có +vẻ thừa như ``from PySide6.QtWidgets import QInputDialog`` lặp lại bên trong +``_add_subagent``/``_edit_subagent`` dù đã có ở top-level) — chỉ số cấp `..` +được nâng lên `...` cho khớp việc file dời từ ``ui/`` (cách gốc 2 cấp) sang +``presentation/co4e/`` (cách gốc 3 cấp). +""" +from __future__ import annotations + +from typing import List + +from PySide6.QtWidgets import QInputDialog, QListWidgetItem + +from ...core.co4e import SubAgent +from ...i18n import tr + + +class _StepConfigActionsMixin: + """Mixin THUẦN (không ``__init__`` riêng) chứa các hành động phụ trợ của + ``StepConfigPanel``. Vai trò: giữ ``node_property_panel.py`` gọn dưới 400 + dòng bằng cách tách phần "hành động" (nghiệp vụ khi bấm nút) ra khỏi phần + "dựng UI" (``__init__``/``load_step``), trong khi vẫn nằm cùng tầng + ``presentation`` — các method này thao tác trực tiếp widget Qt + (``QInputDialog``, ``QFileDialog``, danh sách Qt) nên không hạ được xuống + ``application``/``domain`` (nơi cấm import PySide6) mà không viết lại + logic, việc đó ngoài phạm vi của lượt tách này. + """ + + @staticmethod + def _available_agent_names() -> List[str]: + """Agents the user can pick as a parallel sub-agent: their own custom + agents first, then the built-in personas (kept for resolution even + though they're no longer in the palette).""" + from ...core import co4e + from ...core.co4e_builtins import BUILTIN_AGENTS + + names = [a.name for a in co4e.list_custom_agents()] + names += [a.name for a in BUILTIN_AGENTS if a.name not in names] + return names + + def _add_subagent(self) -> None: + if self._step is None: + return + from PySide6.QtWidgets import QInputDialog + + names = self._available_agent_names() + if names: + name, ok = QInputDialog.getItem(self, tr("co4e.pick_agent"), tr("co4e.pick_agent"), + names, 0, True) # editable: can type a new one + else: + name, ok = QInputDialog.getText(self, tr("co4e.pick_agent"), tr("co4e.pick_agent")) + name = (name or "").strip() + if not ok or not name: + return + self._step.sub_agents.append(SubAgent(agent=name)) + self.sub_list.addItem(name) + self.changed.emit() + + def _edit_subagent(self, item) -> None: + """Double-click a sub-agent row → re-pick from the list.""" + if self._step is None: + return + row = self.sub_list.row(item) + if not (0 <= row < len(self._step.sub_agents)): + return + from PySide6.QtWidgets import QInputDialog + + names = self._available_agent_names() + cur = self._step.sub_agents[row].agent + start = names.index(cur) if cur in names else 0 + name, ok = QInputDialog.getItem(self, tr("co4e.pick_agent"), tr("co4e.pick_agent"), + names or [cur], start, True) + name = (name or "").strip() + if ok and name: + self._step.sub_agents[row].agent = name + item.setText(name) + self.changed.emit() + + def _del_subagent(self) -> None: + if self._step is None: + return + row = self.sub_list.currentRow() + if 0 <= row < len(self._step.sub_agents): + self._step.sub_agents.pop(row) + self.sub_list.takeItem(row) + self.changed.emit() + + def _add_attachment(self) -> None: + if self._step is None: + return + from pathlib import Path as _P + + from PySide6.QtWidgets import QFileDialog + files, _ = QFileDialog.getOpenFileNames(self, tr("co4e.attach_add")) + for f in files: + if f and f not in self._step.attachments: + self._step.attachments.append(f) + item = QListWidgetItem(_P(f).name) + item.setToolTip(f) + self.attach_list.addItem(item) + if files: + self.changed.emit() + + def _del_attachment(self) -> None: + if self._step is None: + return + row = self.attach_list.currentRow() + if 0 <= row < len(self._step.attachments): + self._step.attachments.pop(row) + self.attach_list.takeItem(row) + self.changed.emit() + + def _ai_draft(self) -> None: + """Draft this step's instructions from its label (name) + role — first + asking for an optional description so the generated instructions can be + more specific/detailed than name+role alone would produce.""" + if self.ctx is None or self._step is None: + return + from ...core.worker import AgentWorker + + name = self.label_edit.text().strip() + role = self.role_edit.text().strip() + if not name and not role: + return + hint, ok = QInputDialog.getMultiLineText( + self, tr("co4e.ai_draft_hint_title"), tr("co4e.ai_draft_hint_label")) + if not ok: + return + hint = hint.strip() + self.gen_btn.setEnabled(False) + ctx = self.ctx + + def job(worker: AgentWorker): + from ...core.ai_task_planner import generate_agent_prompt + return {"text": generate_agent_prompt(ctx.build_active_provider(), name, role, hint, + cancel=worker.is_cancelled)} + + def done(result: dict): + self.gen_btn.setEnabled(True) + if result.get("text"): + self.instructions_edit.setPlainText(result["text"]) # _on_edit persists it + + w = AgentWorker(job) + w.finished_ok.connect(done) + w.failed.connect(lambda _e: self.gen_btn.setEnabled(True)) + self._draft_worker = w + w.start() + + def _load_models(self) -> None: + if self.ctx is None: + return + from ...core import preview_ai + from ...core.worker import AgentWorker + + self.load_models_btn.setEnabled(False) + ctx = self.ctx + + def job(_w): + return preview_ai.fetch_live_models(ctx) + + def done(result: dict): + self.load_models_btn.setEnabled(True) + models = [] + for lst in (result or {}).values(): + models.extend(lst) + cur = self.model_combo.currentText() + self.model_combo.blockSignals(True) + self.model_combo.clear() + self.model_combo.addItems(sorted(set(models))) + self.model_combo.setEditText(cur) + self.model_combo.blockSignals(False) + + w = AgentWorker(job) + w.finished_ok.connect(done) + w.failed.connect(lambda _e: self.load_models_btn.setEnabled(True)) + self._model_worker = w + w.start() diff --git a/presentation/co4e/node_property_panel.py b/presentation/co4e/node_property_panel.py new file mode 100644 index 0000000..79e8b7e --- /dev/null +++ b/presentation/co4e/node_property_panel.py @@ -0,0 +1,293 @@ +"""Panel bên phải chỉnh sửa persona của một step đang chọn trên canvas Co4E — +tách khỏi ``ui/co4e_config_panel.py`` (nguyên bản dòng 1-27, 133-378). + +Vấn đề đang có: cả ``StepConfigPanel`` (dựng UI + 8 hành động phụ trợ) và +khung section gấp/mở dùng chung của nó nằm trong một file 528 dòng — vượt +trần 400 dòng của CASAN Check 2 nếu tách nguyên khối. Chia thành 3 file theo +trách nhiệm: ``step_config_section.py`` (khung ▶/▼ dùng chung, không có hành +vi nghiệp vụ riêng), ``node_property_actions_mixin.py`` (8 hành động: thêm/ +sửa/xoá sub-agent, thêm/xoá attachment, soạn AI, tải model — chỉ đọc/ghi state +đã có sẵn trên ``self``), và file này (``StepConfigPanel`` — 4 Signal, +``__init__`` dựng toàn bộ form, ``load_step``/``clear_step`` nạp/xoá dữ liệu, +``_on_edit`` ghi field vào ``Step``). + +Cách làm: dời NGUYÊN VĂN phần class (Signal + ``__init__`` + ``load_step`` + +``clear_step`` + ``_on_edit``, nguyên bản dòng 133-378) sang đây, không đổi +tên thuộc tính/tham số, không đổi thứ tự dựng widget, không đổi giá trị mặc +định nào. ``StepConfigPanel`` giờ kế thừa thêm ``_StepConfigActionsMixin`` +(``class StepConfigPanel(_StepConfigActionsMixin, QScrollArea)``) để có lại +các method đã dời sang ``node_property_actions_mixin.py`` — không có method +nào của mixin trùng tên với ``QScrollArea`` nên thứ tự kế thừa mixin-trước +không phải là bắt buộc như ở ``co4e_canvas_widget.py``, chỉ giữ để nhất quán +quy ước đặt mixin trước base Qt. + +Import ``PROVIDER_LABELS`` (nguyên bản dòng 21) hiện KHÔNG được dùng ở đâu +trong phần class đã dời (đã xác minh bằng grep trên toàn bộ +``ui/co4e_config_panel.py`` gốc) — vẫn giữ nguyên import này y hệt bản gốc, +KHÔNG xoá dù có vẻ thừa, để đúng phạm vi "chỉ dời chỗ" của lượt tách này. +""" +from __future__ import annotations + +from typing import List, Optional + +from PySide6.QtCore import Qt, Signal +from PySide6.QtWidgets import ( + QCheckBox, QComboBox, QHBoxLayout, QLabel, QLineEdit, QListWidget, + QListWidgetItem, QPlainTextEdit, QPushButton, QScrollArea, QSpinBox, + QVBoxLayout, QWidget, +) + +from ...config import PROVIDER_LABELS +from ...core.co4e import PERMISSION_PRESETS, Step +from ...i18n import tr +from ...ui.icons import icon, icon_picker_combo +from .node_property_actions_mixin import _StepConfigActionsMixin +from .step_config_section import _add_section + + +class StepConfigPanel(_StepConfigActionsMixin, QScrollArea): + changed = Signal() # any field edited → repaint node + autosave + run_node = Signal(str) # "Run this step" (node id) + run_from = Signal(str) # "Run from here" + delete_node = Signal(str) # "Delete step" + + def __init__(self, ctx=None): + super().__init__() + self.ctx = ctx + self._step: Optional[Step] = None + self._node_id = "" + self._loading = False + self.setWidgetResizable(True) + host = QWidget() + self.setWidget(host) + outer = QVBoxLayout(host) + outer.setSpacing(1) + + # Grouped sections stacked on one scrolling page — same fields as + # before, grouped by what they're for: identity, execution + # (model/permission), and the extra resources fed to the step + # (skills/files/sub-agents). No tabs/accordion: every group's border + # and heading are what separate it from its neighbours, and all three + # are on screen (or one scroll away) at once. + form, _basic_card = _add_section(outer, tr("co4e.tab_basic")) + + self.label_edit = QLineEdit() + self.label_edit.textChanged.connect(self._on_edit) + form.addRow(tr("co4e.f_label"), self.label_edit) + + self.role_edit = QLineEdit() + self.role_edit.textChanged.connect(self._on_edit) + form.addRow(tr("co4e.f_role"), self.role_edit) + + # Dropdown of every icon in the registry (Monitoring's Icon Management + # set + built-ins), each row previewing its actual glyph — still + # editable so a not-yet-added custom name can be typed directly. + self.icon_edit = icon_picker_combo() + self.icon_edit.lineEdit().setPlaceholderText(tr("co4e.f_icon_placeholder")) + self.icon_edit.currentTextChanged.connect(self._on_edit) + form.addRow(tr("co4e.f_icon"), self.icon_edit) + + self.instructions_edit = QPlainTextEdit() + self.instructions_edit.setMaximumHeight(120) + self.instructions_edit.textChanged.connect(self._on_edit) + self.gen_btn = QPushButton(tr("co4e.ai_draft")) + self.gen_btn.setIcon(icon("sparkle")) + self.gen_btn.setToolTip(tr("co4e.ai_draft_tooltip")) + self.gen_btn.setEnabled(ctx is not None) + self.gen_btn.clicked.connect(self._ai_draft) + instr_box = QWidget() + ib = QVBoxLayout(instr_box) + ib.setContentsMargins(0, 0, 0, 0) + ib.addWidget(self.instructions_edit) + ib.addWidget(self.gen_btn, alignment=Qt.AlignRight) + form.addRow(tr("co4e.f_instructions"), instr_box) + + # Extra context — free-text background/info fed to the step at run time + # (in addition to instructions, attachments and upstream outputs). + self.context_edit = QPlainTextEdit() + self.context_edit.setMaximumHeight(90) + self.context_edit.setPlaceholderText(tr("co4e.f_context_placeholder")) + self.context_edit.textChanged.connect(self._on_edit) + form.addRow(tr("co4e.f_context"), self.context_edit) + + form2, _model_card = _add_section(outer, tr("co4e.tab_model_perm")) + + model_row = QHBoxLayout() + self.model_combo = QComboBox() + self.model_combo.setEditable(True) + self.model_combo.editTextChanged.connect(self._on_edit) + self.load_models_btn = QPushButton() + self.load_models_btn.setIcon(icon("download")) + self.load_models_btn.setToolTip(tr("co4e.load_models_tooltip")) + self.load_models_btn.clicked.connect(self._load_models) + self.load_models_btn.setEnabled(ctx is not None) + model_row.addWidget(self.model_combo, 1) + model_row.addWidget(self.load_models_btn) + mrow = QWidget(); mrow.setLayout(model_row) + form2.addRow(tr("co4e.f_model"), mrow) + + self.perm_combo = QComboBox() + for preset in PERMISSION_PRESETS: + self.perm_combo.addItem(tr(f"co4e.perm.{preset}"), preset) + self.perm_combo.currentIndexChanged.connect(self._on_edit) + form2.addRow(tr("co4e.f_permission"), self.perm_combo) + + verify_row = QHBoxLayout() + self.verify_chk = QCheckBox(tr("co4e.f_self_verify")) + self.verify_chk.toggled.connect(self._on_edit) + self.rounds_spin = QSpinBox() + self.rounds_spin.setRange(1, 5) + self.rounds_spin.valueChanged.connect(self._on_edit) + verify_row.addWidget(self.verify_chk) + verify_row.addWidget(QLabel(tr("co4e.f_verify_rounds"))) + verify_row.addWidget(self.rounds_spin) + verify_row.addStretch(1) + vrow = QWidget(); vrow.setLayout(verify_row) + form2.addRow("", vrow) + + form3, _skills_card = _add_section(outer, tr("co4e.tab_skills_files")) + + # Skills checklist (registry skills) + self.skills_list = QListWidget() + self.skills_list.setMaximumHeight(110) + self.skills_list.itemChanged.connect(self._on_edit) + form3.addRow(tr("co4e.f_skills"), self.skills_list) + + # Attachments — files whose extracted text is fed to this step at run time. + self.attach_list = QListWidget() + self.attach_list.setMaximumHeight(80) + self.attach_add_btn = QPushButton(tr("co4e.attach_add")) + self.attach_add_btn.setIcon(icon("plus")) + self.attach_add_btn.clicked.connect(self._add_attachment) + self.attach_del_btn = QPushButton(tr("co4e.attach_remove")) + self.attach_del_btn.setIcon(icon("trash")) + self.attach_del_btn.clicked.connect(self._del_attachment) + att_btns = QHBoxLayout() + att_btns.addWidget(self.attach_add_btn) + att_btns.addWidget(self.attach_del_btn) + att_btns.addStretch(1) + abtn = QWidget(); abtn.setLayout(att_btns) + form3.addRow(tr("co4e.f_attachments"), self.attach_list) + form3.addRow("", abtn) + + # Parallel sub-agents get their OWN section — same header style as + # Cơ bản/Model & Quyền/Skills & Tệp — rather than a row buried inside + # Skills & Tệp, since it's really a distinct group, just one that + # only applies to parallel-variant steps. load_step() hides the whole + # card for a non-parallel step (see is_par below). + form4, self._parallel_card = _add_section(outer, tr("co4e.f_subagents")) + self.sub_list = QListWidget() + self.sub_list.setMaximumHeight(90) + self.sub_list.itemDoubleClicked.connect(self._edit_subagent) # re-pick agent + self.sub_add_btn = QPushButton(tr("co4e.add_subagent")) + self.sub_add_btn.setIcon(icon("plus")) + self.sub_add_btn.clicked.connect(self._add_subagent) + self.sub_del_btn = QPushButton(tr("co4e.del_subagent")) + self.sub_del_btn.setIcon(icon("trash")) + self.sub_del_btn.clicked.connect(self._del_subagent) + sub_btns = QHBoxLayout() + sub_btns.addWidget(self.sub_add_btn) + sub_btns.addWidget(self.sub_del_btn) + sub_btns.addStretch(1) + sbtn = QWidget(); sbtn.setLayout(sub_btns) + form4.addRow(self.sub_list) + form4.addRow("", sbtn) + + # Footer actions — one compact row (Run · Run from here · Delete), + # kept below every section, not inside one of the cards. + self.run_btn = QPushButton(tr("co4e.run")) + self.run_btn.setIcon(icon("play")) + self.run_btn.setToolTip(tr("co4e.run_this_step")) + self.run_btn.clicked.connect(lambda: self.run_node.emit(self._node_id)) + self.run_from_btn = QPushButton(tr("co4e.run_from_here")) + self.run_from_btn.setToolTip(tr("co4e.run_from_here")) + self.run_from_btn.clicked.connect(lambda: self.run_from.emit(self._node_id)) + self.del_btn = QPushButton() + self.del_btn.setIcon(icon("trash")) + self.del_btn.setObjectName("danger") + self.del_btn.setToolTip(tr("co4e.delete_step")) + self.del_btn.setFixedWidth(38) + self.del_btn.clicked.connect(lambda: self.delete_node.emit(self._node_id)) + foot = QHBoxLayout() + foot.addWidget(self.run_btn, 1) + foot.addWidget(self.run_from_btn, 1) + foot.addWidget(self.del_btn) + foot_w = QWidget(); foot_w.setLayout(foot) + outer.addWidget(foot_w) + # Without this, QVBoxLayout hands every child widget an EQUAL share of + # whatever extra height the scroll area's viewport has beyond the + # content's own sizeHint (setWidgetResizable(True) stretches `host` to + # fill it) — each collapsed header's card was measuring a true + # sizeHint of ~17px but rendering over 100px taller, and no amount of + # margin/padding/spacing on the header itself could touch that: the + # surplus was being spent on the cards, not around them. One trailing + # stretch absorbs all of it instead, so every section (and the + # footer) renders at exactly its own natural height. + outer.addStretch(1) + + self.setEnabled(False) + + # ---- load a step ------------------------------------------------------ + def load_step(self, node_id: str, step: Step, skill_names: List[str]) -> None: + self._loading = True + self._node_id = node_id + self._step = step + self.setEnabled(True) + self.label_edit.setText(step.label) + self.role_edit.setText(step.role) + self.icon_edit.setCurrentText(step.icon) + self.instructions_edit.setPlainText(step.instructions) + self.context_edit.setPlainText(getattr(step, "context", "")) + self.model_combo.setEditText(step.model) + idx = self.perm_combo.findData(step.permission_preset) + self.perm_combo.setCurrentIndex(idx if idx >= 0 else 0) + self.verify_chk.setChecked(step.self_verify) + self.rounds_spin.setValue(max(1, step.max_verify_rounds)) + # skills checklist + self.skills_list.clear() + for name in skill_names: + it = QListWidgetItem(name) + it.setFlags(it.flags() | Qt.ItemIsUserCheckable) + it.setCheckState(Qt.Checked if name in step.skills else Qt.Unchecked) + self.skills_list.addItem(it) + # attachments + self.attach_list.clear() + from pathlib import Path as _P + for path in step.attachments: + item = QListWidgetItem(_P(path).name) + item.setToolTip(path) + self.attach_list.addItem(item) + # parallel sub-agents — the whole "Agent song song" section only + # applies to parallel-variant steps, so the entire card (header + # included) is hidden for any other step, not just its rows. + is_par = step.is_parallel + self._parallel_card.setVisible(is_par) + self.sub_list.clear() + if is_par: + for sub in step.sub_agents: + self.sub_list.addItem(sub.agent) + self._loading = False + + def clear_step(self) -> None: + self._step = None + self._node_id = "" + self.setEnabled(False) + + # ---- edits write back to the Step ------------------------------------- + def _on_edit(self, *_a) -> None: + if self._loading or self._step is None: + return + s = self._step + s.label = self.label_edit.text() + s.role = self.role_edit.text().upper() or "AGENT" + s.icon = self.icon_edit.currentText().strip() + s.instructions = self.instructions_edit.toPlainText() + s.context = self.context_edit.toPlainText() + s.model = self.model_combo.currentText().strip() + s.permission_preset = self.perm_combo.currentData() or "inherit" + s.self_verify = self.verify_chk.isChecked() + s.max_verify_rounds = self.rounds_spin.value() + s.skills = [self.skills_list.item(i).text() + for i in range(self.skills_list.count()) + if self.skills_list.item(i).checkState() == Qt.Checked] + self.changed.emit() diff --git a/presentation/co4e/palette_list.py b/presentation/co4e/palette_list.py new file mode 100644 index 0000000..8844b0c --- /dev/null +++ b/presentation/co4e/palette_list.py @@ -0,0 +1,55 @@ +"""``_PaletteList`` — danh sách kéo-thả dùng chung của sidebar Co4E, tách khỏi +``ui/co4e_tab.py``. + +Vấn đề đang có: lớp này (nguyên bản ở ``ui/co4e_tab.py``) được 3 nơi dùng — +``Co4ETab`` tự dùng cho ``wf_list`` (Workflows), còn +``presentation/co4e/agent_list_panel.py``/``presentation/co4e/skills_list_panel.py`` +phải IMPORT NGƯỢC nó từ ``ui/co4e_tab.py`` bằng deferred-import bên trong +``__init__`` (để né vòng lặp import: ``ui/co4e_tab.py`` import 2 panel đó ở +đầu file, trong khi lớp ``_PaletteList`` lại định nghĩa Ở NGAY TRONG file đó). +Hướng phụ thuộc "presentation -> ui" đó ngược với ý đồ của cả đợt tách này +(``ui/co4e_tab.py`` đang co lại, ``presentation/co4e/`` là tầng con của nó, không +phải ngược lại) — Lâm (N3) quyết 25/08: tách hẳn ``_PaletteList`` sang module +RIÊNG, không thuộc ``ui/`` lẫn phụ thuộc vào ``ui/co4e_tab.py``, để 2 panel kia +import thẳng ở top-level như bình thường, không cần deferred-import nữa. + +Không đổi tên/hành vi — dời NGUYÊN VĂN. ``ui/co4e_tab.py`` giữ khả năng +``from .co4e_tab import _PaletteList`` (qua re-export ở đầu file, giống khuôn +đã dùng cho ``_skill_names``/``_ChatInput``) vì +``tests/characterization/test_co4e_skills_panel.py`` import thẳng tên này từ +``cowork_local.ui.co4e_tab``. +""" +from __future__ import annotations + +import json + +from PySide6.QtCore import QMimeData, Qt +from PySide6.QtGui import QDrag +from PySide6.QtWidgets import QListWidget + +from .co4e_canvas_widget import CO4E_MIME + + +class _PaletteList(QListWidget): + """A list whose rows can be dragged onto the canvas. Each item carries a + JSON-able drag payload (a step dict, or a workflow dict) in ``payload_role``. + Workflow rows also keep a (kind, id) tuple in Qt.UserRole for load/delete.""" + + def __init__(self, parent=None, payload_role=Qt.UserRole): + super().__init__(parent) + self._payload_role = payload_role + self.setDragEnabled(True) + self.setDragDropMode(QListWidget.DragOnly) + + def startDrag(self, _actions): # noqa: N802 + item = self.currentItem() + if item is None: + return + payload = item.data(self._payload_role) + if not payload: + return + md = QMimeData() + md.setData(CO4E_MIME, json.dumps(payload).encode("utf-8")) + drag = QDrag(self) + drag.setMimeData(md) + drag.exec(Qt.CopyAction) diff --git a/presentation/co4e/skills_list_panel.py b/presentation/co4e/skills_list_panel.py new file mode 100644 index 0000000..7c6befe --- /dev/null +++ b/presentation/co4e/skills_list_panel.py @@ -0,0 +1,59 @@ +"""Panel khu vực SKILLS của sidebar Co4E — tách khỏi ``ui/co4e_tab.py``. + +Vấn đề đang có: ``ui/co4e_tab.py`` đang gộp việc dựng widget (nút "Quản lý +skill" + danh sách kéo-thả) ngay bên trong thân hàm dựng cả cột sidebar, +khiến file đó (2000+ dòng) khó đọc và khó giữ dưới giới hạn CASAN (≤400 dòng +mỗi file production). Đoạn dựng widget khu vực SKILLS (nguyên bản ở +``ui/co4e_tab.py`` dòng 569-580) không phụ thuộc phần còn lại của +``Co4ETab`` — nó chỉ tạo ``QPushButton`` + ``_PaletteList`` + layout bọc — nên +tách được thành một ``QWidget`` con độc lập. + +Cách làm: dời nguyên phần dựng widget sang đây, KHÔNG đổi tên thuộc tính so +với bản gốc (``sk_manage_btn`` → ``manage_btn``, ``skill_list`` → +``list_widget``, chỉ đổi TÊN THUỘC TÍNH cho khớp quy ước panel công khai, còn +giá trị/thứ tự dựng/không dựng gì thêm thì giữ y hệt). Panel KHÔNG tự nối +``.clicked`` của ``manage_btn`` và KHÔNG tự gọi ``_reload_sidebar`` — theo +đúng nguyên tắc "một việc rẽ ra một lần": việc dựng widget (ở đây) tách khỏi +việc nối hành vi (vẫn ở ``Co4ETab``, nơi biết ``_manage_skills`` là gì). Gộp +hai việc đó vào panel sẽ buộc panel phải biết về ``Co4ETab``, xoá mất lý do +tách nó ra. + +Cập nhật 25/08: ``_PaletteList`` đã dời khỏi ``ui/co4e_tab.py`` sang +``presentation/co4e/palette_list.py`` (module dùng chung, không phụ thuộc +``ui/``) — import thẳng ở top-level như bên dưới, không còn cần deferred-import +né vòng lặp nữa (xem docstring đầu ``presentation/co4e/palette_list.py`` để +biết lý do dời). +""" +from __future__ import annotations + +from PySide6.QtCore import Qt +from PySide6.QtWidgets import QPushButton, QVBoxLayout, QWidget + +from ...i18n import tr +from .palette_list import _PaletteList + + +class SkillsListPanel(QWidget): + """Widget khu vực SKILLS của sidebar Co4E: nút quản lý + danh sách kéo-thả. + + Vai trò: một widget con thuần ở tầng presentation, chỉ dựng cấu trúc UI + (đúng những gì ``ui/co4e_tab.py`` dòng 569-580 làm trước đây), không biết + gì về ``Co4ETab``/``_manage_skills``/``_reload_sidebar``. Bên gọi (hiện là + ``Co4ETab``) tự đọc ``.manage_btn``/``.list_widget`` để nối signal và nạp + dữ liệu — panel không tự làm hộ, để giữ đúng ranh giới "một nơi một việc". + """ + + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + self.manage_btn = QPushButton(tr("co4e.manage_skills")) + self.manage_btn.setToolTip(tr("co4e.tt_manage_skills")) + self.manage_btn.setObjectName("co4eSectionAction") + self.manage_btn.setFlat(True) + self.manage_btn.setCursor(Qt.PointingHandCursor) + # KHONG noi .clicked o day: ben goi (Co4ETab) tu quyet dinh slot nao + # xu ly - panel chi dung widget, khong biet _manage_skills la gi. + layout = QVBoxLayout(self) + layout.setContentsMargins(0, 0, 0, 0) + layout.setSpacing(4) + self.list_widget = _PaletteList() + layout.addWidget(self.list_widget, 1) diff --git a/presentation/co4e/step_config_section.py b/presentation/co4e/step_config_section.py new file mode 100644 index 0000000..a7345fa --- /dev/null +++ b/presentation/co4e/step_config_section.py @@ -0,0 +1,134 @@ +"""Khung "section" gấp/mở (▶/▼) dùng chung cho các nhóm trường của +``StepConfigPanel`` — tách khỏi ``ui/co4e_config_panel.py`` (nguyên bản dòng +27-130). + +Vấn đề đang có: ``StepConfigPanel`` (nay ở +``presentation/co4e/node_property_panel.py``) có 4 nhóm trường (Cơ bản, Model +& Quyền, Skills & Tệp, Agent song song), mỗi nhóm là một "card" gấp/mở độc +lập với animation riêng. Phần dựng card này (``_SectionHeader`` + +``_add_section``) không đọc/ghi bất kỳ trạng thái nào của ``StepConfigPanel`` +(không có ``self._step``, không có ``ctx``) — nó chỉ nhận ``outer``/``title`` +và trả về ``(form, card)`` để nơi gọi tự đổ các row vào — nên tách được thành +module riêng, giống cách ``AgentListPanel``/``SkillsListPanel`` đã tách khỏi +``ui/co4e_tab.py``. Giữ module riêng cũng là cách duy nhất để +``node_property_panel.py`` (chứa phần còn lại của ``StepConfigPanel``) không +vượt trần 400 dòng của CASAN Check 2. + +Cách làm: dời NGUYÊN VĂN hằng số ``_SECTION_ANIM_MS``, class +``_SectionHeader`` và hàm ``_add_section`` sang đây — không đổi tên, không +đổi logic bên trong (kể cả các closure ``_on_finished``/``_toggle`` lồng +trong ``_add_section``); chỉ đường import đổi cho khớp độ sâu package mới +(``presentation/co4e/`` cách gốc ``cowork_local`` 3 cấp, thay vì 2 cấp như +``ui/``). +""" +from __future__ import annotations + +from PySide6.QtCore import Qt, QEasingCurve, QPropertyAnimation, Signal +from PySide6.QtWidgets import QFormLayout, QLabel, QVBoxLayout, QWidget + +from ...theme import current_palette + +_SECTION_ANIM_MS = 180 + + +class _SectionHeader(QLabel): + """A clickable label — a QPushButton's own style chrome (border, native + button margin, focus rect) always leaves a taller minimum height than a + plain label, even once its QSS padding is zeroed out, so the header that + needs to sit tight against its neighbours is a label, not a button.""" + + clicked = Signal() + + def mousePressEvent(self, event) -> None: # noqa: N802 + if event.button() == Qt.LeftButton: + self.clicked.emit() + super().mousePressEvent(event) + + def showEvent(self, event) -> None: # noqa: N802 + # fontMetrics() at construction time (before this label is ever part + # of a shown top-level window) reflects the QSS font-size only if the + # style has fully polished by then — on the very FIRST paint of the + # Co4E screen it sometimes hasn't, so the fixed height computed in + # _add_section is briefly wrong (too tall) until something else + # triggers a relayout. Recomputing here, every time the label + # actually becomes visible, means the first paint is never stale. + self.setFixedHeight(self.fontMetrics().height()) + super().showEvent(event) + + +def _add_section(outer: QVBoxLayout, title: str) -> tuple[QFormLayout, QWidget]: + """One group of fields, collapsed to just its heading by default and + independently expandable, so a long step config reads as a short list of + group names until you open the one you need. Deliberately bare — no card + border/background/box — the ▶/▼ marker and the heading text are the only + things separating one group from the next; opening one never closes + another (not an accordion, not a tab bar). Returns ``(form, card)``: add + the group's rows to ``form``; ``card`` is the whole section (header + + body) — hide it to remove the group entirely (e.g. for a section that + only applies to some steps), rather than hiding individual rows inside + an always-visible header.""" + p = current_palette() + card = QWidget() + card_lay = QVBoxLayout(card) + card_lay.setContentsMargins(0, 0, 0, 0) + card_lay.setSpacing(0) + + header = _SectionHeader() + header.setCursor(Qt.PointingHandCursor) + header.setStyleSheet(f"font-weight:400; font-size:13px; color:{p.text}; padding:0; margin:0;") + header.setContentsMargins(0, 0, 0, 0) + # QSS font-size only lands on the widget's actual QFont (and therefore + # its fontMetrics()) once the style sheet is polished — ensurePolished() + # forces that now, so the fixed height below is computed from the 12px + # font just set above, not the default one this label was constructed + # with. A label's natural sizeHint still reserves font leading above/ + # below the glyphs on top of the (now zeroed) QSS padding — pinning the + # height to the text's actual cap-to-baseline span is what closes that + # last gap without clipping the ▶ glyph, the title, or Vietnamese + # diacritics. + header.ensurePolished() + header.setFixedHeight(header.fontMetrics().height()) + header.setText(f"▶ {title}") + card_lay.addWidget(header) + + body = QWidget() + body.setVisible(False) + body.setMaximumHeight(0) + form = QFormLayout(body) + form.setContentsMargins(0, 6, 0, 0) + card_lay.addWidget(body) + + anim = QPropertyAnimation(body, b"maximumHeight", body) + anim.setDuration(_SECTION_ANIM_MS) + anim.setEasingCurve(QEasingCurve.InOutCubic) + + is_open = False + + def _on_finished() -> None: + if is_open: + # Uncapped once open, so switching to a step whose fields make + # this section taller/shorter (e.g. a parallel node's sub-agent + # list appearing) is never clipped by the height this animation + # last landed on. + body.setMaximumHeight(16_777_215) + else: + body.setVisible(False) + anim.finished.connect(_on_finished) + + def _toggle() -> None: + nonlocal is_open + is_open = not is_open + header.setText(f"{'▼' if is_open else '▶'} {title}") + anim.stop() + if is_open: + body.setVisible(True) + anim.setStartValue(body.height()) + anim.setEndValue(body.sizeHint().height()) + else: + anim.setStartValue(body.height()) + anim.setEndValue(0) + anim.start() + header.clicked.connect(_toggle) + + outer.addWidget(card) + return form, card diff --git a/tests/characterization/test_co4e_agent_panel.py b/tests/characterization/test_co4e_agent_panel.py new file mode 100644 index 0000000..e06aaff --- /dev/null +++ b/tests/characterization/test_co4e_agent_panel.py @@ -0,0 +1,317 @@ +"""Characterization test cho khu vực AGENTS trong sidebar của ``Co4ETab`` +(``ui/co4e_tab.py``): ``ag_new_btn``/``ag_edit_btn``/``ag_del_btn``/``agent_list`` +và phần "populate agent_list" bên trong ``_reload_sidebar`` — đúng các đoạn được +giao: dòng 549-568 (dựng widget + nối signal), 689-713 (``_reload_sidebar``, CHỈ +đoạn agent: item "Parallel" cố định rồi tới danh sách custom agent) và +1339-1367 (``_new_agent``/``_edit_agent``/``_edit_agent_dialog``/``_delete_agent``). + +VÌ SAO GHI LẠI CHỨ KHÔNG PHÁN XÉT: đây là lưới an toàn cho đợt tách +``ui/co4e_tab.py`` (2000+ dòng) thành các module con dưới ``presentation/co4e/`` +(xem ``docs/architecture/co4e-split-map.md``). Mọi ``assert`` dưới đây được chốt +lại từ giá trị THẬT in ra khi chạy code (quy trình ngược: chạy trước, in ra, +dán vào assert), không phải giá trị tôi nghĩ nó "nên" là gì. + +VÌ SAO CHẠY TRONG TIẾN TRÌNH CON CÔ LẬP HOME: y hệt kỹ thuật của +``test_co4e_skills_panel.py`` (đọc file đó để thấy khuôn subprocess gốc) — +dựng ``Co4ETab`` thật kéo theo ``AppConfig``/``CONFIG_DIR`` là hằng số module +tính MỘT LẦN lúc import từ ``Path.home()``, nên phải cô lập ``HOME``/ +``USERPROFILE`` TRƯỚC bất kỳ import ``cowork_local.*`` nào, trong một tiến +trình con sạch — patch thuộc tính module sau khi import là không đủ. + +AN TOÀN DỮ LIỆU — agent_list NGUY HIỂM HƠN skill_list: ``_reload_sidebar``/ +``_new_agent``/``_edit_agent``/``_delete_agent`` gọi thẳng +``core.co4e.list_custom_agents``/``save_custom_agent``/``delete_custom_agent``, +và ``delete_custom_agent`` THỰC SỰ XOÁ file JSON dưới ``CO4E_DIR``. Script con +assert ``str(CONFIG_DIR).startswith(sandbox)`` NGAY sau khi import, trước khi +gọi bất kỳ hàm co4e nào — chạy nhầm trên máy thật sẽ xoá agent thật của người +dùng. + +KHÔNG gọi provider AI thật / spawn thread thật: không đụng tới +``Co4ERunManager.start()`` hay ``AgentWorker`` được start thật. ``gen_btn`` +("AI-assist" trong ``Co4EAgentDialog``) không được click ở bất kỳ case nào. +``Co4EAgentDialog.exec`` (modal, sẽ treo tiến trình headless) được monkeypatch +thành một hàm giả NGAY TRONG tiến trình con của test — không sửa code sản +phẩm; hàm giả chỉ gõ vào các ô nhập liệu thật (``name_edit``/``role_edit``) +rồi trả về "Accepted" để đường xử lý thật (``dlg.result_agent()`` + +``save_custom_agent``) chạy nguyên vẹn. + +QUIRK ĐÃ ĐÓNG ĐINH (xem case tương ứng bên dưới): + * ``_mint_id`` (``core/co4e.py``) dùng MỘT bộ đếm ``_counter["n"]`` DÙNG + CHUNG cho mọi loại id (workflow/node/agent...), không tách theo tiền tố. + ``Co4ETab.__init__`` mint ``wf_000001`` cho luồng rỗng ban đầu TRƯỚC khi + bất kỳ agent nào được tạo, nên agent custom đầu tiên trong cả tiến trình + mang id ``agent_000002`` chứ không phải ``agent_000001`` — id "nhảy số" + không phải bug ghi riêng cho agent, mà là hệ quả của một bộ đếm toàn cục. + * Dòng 706 dùng ``role=ca.role or "AGENT"`` khi dựng payload kéo-thả, nhưng + nhãn hiển thị trên dòng 711 dùng THẲNG ``ca.role`` (không fallback) — một + agent lưu với ``role=""`` hiện dòng tiêu đề rỗng (" · · tùy chỉnh") + nhưng payload kéo lên canvas lại có ``role="AGENT"``. Hai chỗ đọc cùng một + field nhưng ứng xử khác nhau với chuỗi rỗng. + * ``_edit_agent``/``_delete_agent`` đọc ``cid`` từ item đang chọn rồi tra + lại trong ``list_custom_agents()`` MỚI (không dùng payload đã cache) — nếu + file bị xoá ở "phía sau" (script khác, hoặc do một _delete_agent khác) mà + ``agent_list`` chưa được ``_reload_sidebar()`` lại, thao tác Sửa trên dòng + đó là NO-OP thầm lặng (không báo lỗi, không mở dialog) vì + ``agent is not None`` chặn ở nhánh fallback. + * Chọn dòng "Parallel" (cố định, không phải custom agent) rồi bấm Sửa/Xoá + tạo ra CÙNG MỘT thông báo với việc không chọn gì cả + (``tr("co4e.select_custom_agent")``) — ``cid`` là ``None`` trong cả hai + trường hợp vì item Parallel không set ``Qt.UserRole + 1``. + +VÒNG ĐỜI: đây là giàn giáo cho đợt tách khu vực Agents sang +``presentation/co4e/`` (xem cột "Trạng thái" của dòng liên quan trong +``docs/architecture/co4e-split-map.md``). Sau khi tách xong thành một +``AgentsListPanel``/tương đương với hợp đồng rõ ràng (giống +``SkillsListPanel`` đã làm), các case ở đây nên được viết lại thành test đặc +tả cho panel mới (input rõ ràng, không cần dựng cả ``Co4ETab``/``QApplication`` +nặng nề qua subprocess). Ba quirk "bộ đếm id dùng chung", "role rỗng hiển thị +khác payload" và "sửa trên cid đã xoá là no-op thầm lặng" đáng mở issue hỏi ý +kiến sản phẩm trước khi ai đó "dọn" chúng trong lúc tách — đặc biệt quirk thứ +hai, vì nó rất dễ bị "sửa cho gọn" thành dùng cùng một biểu thức fallback ở cả +hai chỗ, và như vậy vô tình đổi cả nhãn hiển thị lẫn dữ liệu kéo-thả. +""" +from __future__ import annotations + +import os +import subprocess +import sys +from pathlib import Path + +REPO_ROOT = Path(__file__).resolve().parent.parent.parent +REPO_PARENT = REPO_ROOT.parent + +_SCRIPT = r""" +import sys +sys.path.insert(0, REPO_PARENT_PLACEHOLDER) + +from PySide6.QtWidgets import QAbstractItemView, QApplication +from PySide6.QtCore import Qt + +from cowork_local.config import AppConfig, CONFIG_DIR +from cowork_local.state import AppContext +from cowork_local.core import co4e as co4e_mod +from cowork_local.ui.co4e_tab import Co4ETab +from cowork_local.ui.co4e_agent_dialog import Co4EAgentDialog +from cowork_local.i18n import tr + +sandbox = sys.argv[1] +assert str(CONFIG_DIR).startswith(sandbox), "khong co lap: CONFIG_DIR=" + str(CONFIG_DIR) + +app = QApplication([]) +ctx = AppContext(AppConfig.load()) +tab = Co4ETab(ctx) + +# ---- 549-568: widget cua khu vuc AGENTS duoc dung dung nhu quan sat ------- +assert tab.ag_new_btn.text() == tr("co4e.new"), tab.ag_new_btn.text() +assert tab.ag_new_btn.toolTip() == tr("co4e.tt_new_agent"), tab.ag_new_btn.toolTip() +assert tab.ag_new_btn.objectName() == "co4eSectionAction" +assert tab.ag_new_btn.isFlat() is True +assert tab.ag_new_btn.cursor().shape() == Qt.PointingHandCursor +assert tab.ag_edit_btn.toolTip() == tr("co4e.tt_edit_agent"), tab.ag_edit_btn.toolTip() +assert tab.ag_edit_btn.width() == 34, tab.ag_edit_btn.width() +assert tab.ag_del_btn.toolTip() == tr("co4e.tt_del_agent"), tab.ag_del_btn.toolTip() +assert tab.ag_del_btn.width() == 34, tab.ag_del_btn.width() +assert tab.agent_list.dragEnabled() is True +assert tab.agent_list.dragDropMode() == QAbstractItemView.DragOnly +print("CASE_WIDGETS_OK") + +# ---- 689-713: _reload_sidebar voi thu muc agents RONG --------------------- +# Chi con dong "Parallel" co dinh, khong co custom agent nao. +tab._reload_sidebar() +assert tab.agent_list.count() == 1, tab.agent_list.count() +it0 = tab.agent_list.item(0) +assert it0.text() == tr("co4e.parallel_node"), it0.text() +payload0 = it0.data(Qt.UserRole) +assert payload0 == { + "variant": "parallel", "label": "Parallel", "role": "PARALLEL", + "icon": "server", "sub_agents": [], +}, payload0 +assert it0.data(Qt.UserRole + 1) is None +print("CASE_EMPTY_OK") + +# ---- quirk: bo dem id dung chung cho moi loai (xem docstring dau file) ---- +# Co4ETab.__init__ da mint "wf_000001" cho luong rong ban dau -> agent CUSTOM +# dau tien trong ca tien trinh mang id "agent_000002", khong phai "..._000001". +agent1 = co4e_mod.new_custom_agent("Reviewer Bot") +assert agent1.id == "agent_000002", agent1.id +print("CASE_ID_COUNTER_QUIRK_OK") + +agent1.role = "REVIEWER" +agent1.icon = "eye" +agent1.instructions = "Review the diff." +agent1.skills = ["Test Skill"] +co4e_mod.save_custom_agent(agent1) +tab._reload_sidebar() +assert tab.agent_list.count() == 2, tab.agent_list.count() +it1 = tab.agent_list.item(1) +assert it1.text() == "Reviewer Bot · REVIEWER · " + tr("co4e.custom"), it1.text() +payload1 = it1.data(Qt.UserRole) +assert payload1 == { + "variant": "step", "label": "Reviewer Bot", "agent_slug": "reviewer-bot", + "role": "REVIEWER", "icon": "eye", "instructions": "Review the diff.", + "context": "", "model": "", "self_verify": True, "max_verify_rounds": 1, + "permission_preset": "full", "skills": ["Test Skill"], "attachments": [], + "sub_agents": [], +}, payload1 +assert it1.data(Qt.UserRole + 1) == agent1.id +assert it1.icon().isNull() is False +print("CASE_ONE_AGENT_OK") + +# ---- quirk: agent luu voi name="" va role="" ------------------------------- +# Nhan hien thi (dong 711) dung THANG ca.role -> rong; nhung payload keo-tha +# (dong 706) dung "ca.role or 'AGENT'" -> fallback ve "AGENT". Cung mot field, +# hai cach doc khac nhau khi gap chuoi rong. +agent2 = co4e_mod.new_custom_agent("") +agent2.role = "" +co4e_mod.save_custom_agent(agent2) +tab._reload_sidebar() +assert tab.agent_list.count() == 3, tab.agent_list.count() +it2 = tab.agent_list.item(2) +assert it2.text() == " · · " + tr("co4e.custom"), repr(it2.text()) +payload2 = it2.data(Qt.UserRole) +assert payload2["role"] == "AGENT", payload2["role"] +print("CASE_EMPTY_NAME_ROLE_QUIRK_OK") + +# ---- 1339-1340: _new_agent() mo dialog cho MOT agent moi tinh -------------- +# Gia lap Co4EAgentDialog.exec() ngay trong tien trinh con nay (khong sua code +# san pham): go vao chinh cac o nhap that (name_edit/role_edit) roi tra ve +# Accepted, de duong xu ly that (result_agent() + save_custom_agent) chay +# nguyen ven. +calls = {"n": 0} + + +def _fake_exec(self): + calls["n"] += 1 + self.name_edit.setText(f"Fresh-{calls['n']}") + self.role_edit.setText("Scout") + return 1 # QDialog.Accepted + + +Co4EAgentDialog.exec = _fake_exec + +before = tab.agent_list.count() +tab.ag_new_btn.click() # 555: noi that toi _new_agent +assert calls["n"] == 1 +assert tab.agent_list.count() == before + 1, tab.agent_list.count() +names = [tab.agent_list.item(i).text() for i in range(tab.agent_list.count())] +assert names[-1] == "Fresh-1 · SCOUT · " + tr("co4e.custom"), names +print("CASE_NEW_AGENT_VIA_CLICK_OK") + +# ---- 1342-1350: _edit_agent() khong co dong nao dang chon ------------------ +msgs = [] +tab.status_message.connect(lambda m: msgs.append(m)) +tab.agent_list.setCurrentRow(-1) +assert tab.agent_list.currentItem() is None +tab._edit_agent() +assert msgs == [tr("co4e.select_custom_agent")], msgs +print("CASE_EDIT_NO_SELECTION_OK") + +# ---- quirk: chon dong "Parallel" (khong phai custom agent) -> CUNG thong +# bao nhu khong chon gi, vi Qt.UserRole + 1 la None o dong nay ----------- +tab.agent_list.setCurrentRow(0) +tab._edit_agent() +assert msgs == [tr("co4e.select_custom_agent")] * 2, msgs +tab._delete_agent() +assert msgs == [tr("co4e.select_custom_agent")] * 3, msgs +assert tab.agent_list.count() == before + 1, "chon Parallel roi Xoa khong lam mat dong nao" +print("CASE_PARALLEL_ROW_NOOP_QUIRK_OK") + +# ---- 1342-1358: _edit_agent() tren mot custom agent that ------------------- +target_row = next( + i for i in range(tab.agent_list.count()) + if tab.agent_list.item(i).data(Qt.UserRole + 1) == agent1.id +) +tab.agent_list.setCurrentRow(target_row) +tab.ag_edit_btn.click() # 562: noi that toi _edit_agent +assert calls["n"] == 2 +names = [tab.agent_list.item(i).text() for i in range(tab.agent_list.count())] +assert names[target_row] == "Fresh-2 · SCOUT · " + tr("co4e.custom"), names +# id giu nguyen qua lan sua (chi noi dung doi, khong mint id moi) +assert tab.agent_list.item(target_row).data(Qt.UserRole + 1) == agent1.id +print("CASE_EDIT_EXISTING_OK") + +# ---- quirk: sua tren mot cid da bi xoa "phia sau" -> no-op tham lang ------- +# _edit_agent tra cuu lai list_custom_agents() MOI, khong dung payload da cache +# trong item; neu file da mat va agent_list CHUA duoc _reload_sidebar(), thao +# tac Sua tren dong do khong lam gi (khong mo dialog, khong loi). +co4e_mod.delete_custom_agent(agent1.id) +stale_item = tab.agent_list.item(target_row) +assert stale_item.data(Qt.UserRole + 1) == agent1.id # item van con cid cu +tab.agent_list.setCurrentRow(target_row) +tab._edit_agent() +assert calls["n"] == 2, "khong duoc mo dialog voi cid da bi xoa" +print("CASE_EDIT_STALE_CID_QUIRK_OK") + +# ---- 1360-1367: _delete_agent() tren mot custom agent that ----------------- +tab._reload_sidebar() +count_before_delete = tab.agent_list.count() +del_row, del_cid = next( + (i, tab.agent_list.item(i).data(Qt.UserRole + 1)) + for i in range(tab.agent_list.count()) + if tab.agent_list.item(i).data(Qt.UserRole + 1) +) +tab.agent_list.setCurrentRow(del_row) +tab.ag_del_btn.click() # 563: noi that toi _delete_agent +assert tab.agent_list.count() == count_before_delete - 1 +assert not (co4e_mod.agents_dir() / f"{del_cid}.json").exists() +print("CASE_DELETE_REAL_OK") + +# ---- fallback: xoa lai mot id da khong con file -> khong nem loi ----------- +co4e_mod.delete_custom_agent(del_cid) +print("CASE_DELETE_ALREADY_GONE_OK") + +print("ALL_OK") +""" + + +def _run_isolated(sandbox: Path) -> subprocess.CompletedProcess: + env = dict(os.environ) + env["HOME"] = str(sandbox) + env["USERPROFILE"] = str(sandbox) + env["QT_QPA_PLATFORM"] = "offscreen" + env["PYTHONIOENCODING"] = "utf-8" + env.pop("HOMEDRIVE", None) + env.pop("HOMEPATH", None) + + script = _SCRIPT.replace("REPO_PARENT_PLACEHOLDER", repr(str(REPO_PARENT))) + return subprocess.run( + [sys.executable, "-c", script, str(sandbox)], + cwd=str(REPO_ROOT), + env=env, + capture_output=True, + text=True, + timeout=60, + ) + + +def test_co4e_agent_panel_hanh_vi_hien_tai(tmp_path): + sandbox = tmp_path / "home" + sandbox.mkdir() + + result = _run_isolated(sandbox) + + assert result.returncode == 0, ( + f"characterization script that bai (exit {result.returncode}):\n" + f"--- stdout ---\n{result.stdout}\n--- stderr ---\n{result.stderr}" + ) + for marker in ( + "CASE_WIDGETS_OK", + "CASE_EMPTY_OK", + "CASE_ID_COUNTER_QUIRK_OK", + "CASE_ONE_AGENT_OK", + "CASE_EMPTY_NAME_ROLE_QUIRK_OK", + "CASE_NEW_AGENT_VIA_CLICK_OK", + "CASE_EDIT_NO_SELECTION_OK", + "CASE_PARALLEL_ROW_NOOP_QUIRK_OK", + "CASE_EDIT_EXISTING_OK", + "CASE_EDIT_STALE_CID_QUIRK_OK", + "CASE_DELETE_REAL_OK", + "CASE_DELETE_ALREADY_GONE_OK", + "ALL_OK", + ): + assert marker in result.stdout, f"thieu marker {marker}\n{result.stdout}" + + # Sandbox chi duoc dung boi save_custom_agent()/delete_custom_agent() cua + # chinh test (khong co du lieu nguoi dung that nao bi cham vao) - + # CONFIG_DIR nam trong sandbox nhu da assert ngay dau script. + assert (sandbox / ".cowork_local" / "co4e").exists() diff --git a/tests/characterization/test_co4e_canvas_geometry.py b/tests/characterization/test_co4e_canvas_geometry.py new file mode 100644 index 0000000..1f111c8 --- /dev/null +++ b/tests/characterization/test_co4e_canvas_geometry.py @@ -0,0 +1,374 @@ +"""Characterization tests cho 8 ham hinh hoc thuan cua Co4E canvas. + +Vong doi: day la gian giao (scaffolding), khong phai test dac ta cuoi cung. +Muc dich la ghi lai HANH VI DANG CO cua ``_dist``, ``_towards``, +``_rounded_path``, ``_seg_hits_rect``, ``_hits``, ``_route``, ``_ortho_path``, +``_elide`` — hien dang duoc re-export tu ``ui/co4e_canvas.py`` (thuc chat da +duoc doi sang song o ``presentation/co4e/canvas_geometry.py``, xem docstring +cua file do) — de lam luoi an toan cho dot tach file 2000+ dong. Test nay +KHONG phan xet dung/sai thiet ke, chi dong dinh lai output thuc te da chay va +in ra. Sau khi dot tach hoan tat va on dinh, cac test o day nen duoc viet lai +thanh test dac ta (specification test) that su — luc do co the xoa cac assert +kieu "quirk" ben duoi va thay bang assert dua tren hop dong ro rang, hoac mo +issue rieng de sua cac quirk neu chung thuc su la bug. + +Khong can QApplication: cac ham nay chi dung QPointF/QRectF/QPainterPath nhu +kieu gia tri thuan, khong ve, khong doc kich thuoc widget. + +Cac quirk dang chu y da duoc dong dinh o day (dung sua o code san pham): + + * ``_elide(text, n)`` dung slicing ``text[: n - 1] + "..."``. Voi ``n=0``, + ``n - 1 == -1`` nen KHONG cat rong ma cat mat ky tu cuoi cung cua chuoi + con lai roi noi dau "..." vao — vi du ``_elide("abc", 0) == "ab..."`` chu + khong phai chuoi rong. Voi ``n=1``, ket qua la chinh dau "..." (do + ``text[:0] == ""``). + * ``_seg_hits_rect`` kiem tra nhanh "horizontal" (``abs(y1-y2) < 0.5``) + TRUOC nhanh "vertical" — mot doan suy bien (diem trung diem, ``p1==p2``) + luon roi vao nhanh horizontal du no cung thoa dieu kien vertical. + * ``_route`` co the "bo cuoc": khi vat can qua lon bao kin moi phuong an + tranh, no tra ve elbow co ban (``base``) DU NO VAN VA CHAM vat can — ham + khong nem loi, khong bao dam duong tra ve khong va cham. + * ``_towards(a, b, d)`` khi ``a == b`` (khoang cach ~0) tra ve ban sao cua + ``a`` bat ke ``d`` la bao nhieu, thay vi loi hoac diem khong xac dinh. + +Cac assert duoi day duoc chot bang cach CHAY code that qua +``.venv/Scripts/python.exe -c "..."`` roi dan nguyen ket qua in duoc vao +assert, khong suy luan ly thuyet. +""" +from __future__ import annotations + +import pytest + +from cowork_local.ui.co4e_canvas import ( + _dist, + _elide, + _hits, + _ortho_path, + _route, + _rounded_path, + _seg_hits_rect, + _towards, +) +from PySide6.QtCore import QPointF, QRectF + + +# --------------------------------------------------------------------------- +# _dist +# --------------------------------------------------------------------------- + +def test_dist_pythagorean_3_4_5(): + assert _dist(QPointF(0, 0), QPointF(3, 4)) == pytest.approx(5.0) + + +def test_dist_same_point_is_zero(): + assert _dist(QPointF(5, 5), QPointF(5, 5)) == pytest.approx(0.0) + + +def test_dist_negative_coordinates(): + assert _dist(QPointF(-1, -1), QPointF(2, 3)) == pytest.approx(5.0) + + +# --------------------------------------------------------------------------- +# _towards +# --------------------------------------------------------------------------- + +def test_towards_moves_along_axis_by_distance(): + p = _towards(QPointF(0, 0), QPointF(10, 0), 5) + assert p.x() == pytest.approx(5.0) + assert p.y() == pytest.approx(0.0) + + +def test_towards_same_point_returns_copy_of_a_regardless_of_d(): + # quirk: khi a == b (khoang cach ~0), tra ve ban sao cua a, khong loi. + p = _towards(QPointF(0, 0), QPointF(0, 0), 5) + assert p.x() == pytest.approx(0.0) + assert p.y() == pytest.approx(0.0) + + +def test_towards_zero_distance_stays_at_a(): + p = _towards(QPointF(0, 0), QPointF(10, 0), 0) + assert p.x() == pytest.approx(0.0) + assert p.y() == pytest.approx(0.0) + + +def test_towards_overshoot_past_b_is_allowed(): + # quirk: d lon hon khoang cach a->b van duoc ngoai suy, khong bi kep lai. + p = _towards(QPointF(0, 0), QPointF(10, 0), 20) + assert p.x() == pytest.approx(20.0) + assert p.y() == pytest.approx(0.0) + + +# --------------------------------------------------------------------------- +# _rounded_path +# --------------------------------------------------------------------------- + +def test_rounded_path_empty_points_returns_empty_path(): + path = _rounded_path([]) + assert path.elementCount() == 0 + + +def test_rounded_path_single_point(): + path = _rounded_path([QPointF(1, 2)]) + assert path.elementCount() == 1 + e = path.elementAt(0) + assert (e.x, e.y) == pytest.approx((1.0, 2.0)) + + +def test_rounded_path_two_points_is_a_straight_line_no_bend(): + path = _rounded_path([QPointF(0, 0), QPointF(10, 0)]) + assert path.elementCount() == 2 + e0, e1 = path.elementAt(0), path.elementAt(1) + assert (e0.x, e0.y) == pytest.approx((0.0, 0.0)) + assert (e1.x, e1.y) == pytest.approx((10.0, 0.0)) + + +def test_rounded_path_three_points_default_radius(): + # dist(prev,cur)=10, dist(cur,nxt)=10 -> rr = min(12, 5, 5) = 5. + path = _rounded_path([QPointF(0, 0), QPointF(10, 0), QPointF(10, 10)]) + assert path.elementCount() == 6 + pts = [(path.elementAt(i).x, path.elementAt(i).y) for i in range(6)] + expected = [ + (0.0, 0.0), + (5.0, 0.0), + (8.333333333333334, 0.0), + (10.0, 1.6666666666666667), + (10.0, 5.0), + (10.0, 10.0), + ] + for got, exp in zip(pts, expected): + assert got[0] == pytest.approx(exp[0]) + assert got[1] == pytest.approx(exp[1]) + rect = path.boundingRect() + assert (rect.x(), rect.y(), rect.width(), rect.height()) == pytest.approx( + (0.0, 0.0, 10.0, 10.0) + ) + + +def test_rounded_path_default_radius_matches_explicit_r_12(): + a = _rounded_path([QPointF(0, 0), QPointF(10, 0), QPointF(10, 10)]) + b = _rounded_path([QPointF(0, 0), QPointF(10, 0), QPointF(10, 10)], 12) + assert a.elementCount() == b.elementCount() + for i in range(a.elementCount()): + ea, eb = a.elementAt(i), b.elementAt(i) + assert (ea.x, ea.y) == pytest.approx((eb.x, eb.y)) + + +def test_rounded_path_custom_smaller_radius_changes_bend_points(): + path = _rounded_path([QPointF(0, 0), QPointF(10, 0), QPointF(10, 10)], r=2) + assert path.elementCount() == 6 + pts = [(path.elementAt(i).x, path.elementAt(i).y) for i in range(6)] + expected = [ + (0.0, 0.0), + (8.0, 0.0), + (9.333333333333334, 0.0), + (10.0, 0.6666666666666666), + (10.0, 2.0), + (10.0, 10.0), + ] + for got, exp in zip(pts, expected): + assert got[0] == pytest.approx(exp[0]) + assert got[1] == pytest.approx(exp[1]) + + +# --------------------------------------------------------------------------- +# _seg_hits_rect +# --------------------------------------------------------------------------- + +RECT = QRectF(10, 10, 20, 20) # x in [10, 30], y in [10, 30] + + +def test_seg_hits_rect_horizontal_through_rect(): + assert _seg_hits_rect(QPointF(0, 20), QPointF(40, 20), RECT) is True + + +def test_seg_hits_rect_horizontal_outside_y_range(): + assert _seg_hits_rect(QPointF(0, 5), QPointF(40, 5), RECT) is False + + +def test_seg_hits_rect_horizontal_not_reaching_rect_x_range(): + assert _seg_hits_rect(QPointF(0, 20), QPointF(5, 20), RECT) is False + + +def test_seg_hits_rect_vertical_through_rect(): + assert _seg_hits_rect(QPointF(20, 0), QPointF(20, 40), RECT) is True + + +def test_seg_hits_rect_vertical_outside_x_range(): + assert _seg_hits_rect(QPointF(5, 0), QPointF(5, 40), RECT) is False + + +def test_seg_hits_rect_diagonal_intersecting(): + assert _seg_hits_rect(QPointF(0, 0), QPointF(40, 40), RECT) is True + + +def test_seg_hits_rect_diagonal_not_intersecting(): + assert _seg_hits_rect(QPointF(0, 0), QPointF(5, 5), RECT) is False + + +def test_seg_hits_rect_degenerate_point_inside_counts_as_hit(): + # quirk: p1 == p2 roi vao nhanh "horizontal" (abs(y1-y2) < 0.5 duoc kiem + # truoc), du no cung thoa nhanh vertical. + assert _seg_hits_rect(QPointF(20, 20), QPointF(20, 20), RECT) is True + + +def test_seg_hits_rect_degenerate_point_outside(): + assert _seg_hits_rect(QPointF(0, 0), QPointF(0, 0), RECT) is False + + +# --------------------------------------------------------------------------- +# _hits +# --------------------------------------------------------------------------- + +def test_hits_empty_points_list_is_false(): + assert _hits([], [RECT]) is False + + +def test_hits_single_point_has_no_segments_so_false(): + assert _hits([QPointF(20, 20)], [RECT]) is False + + +def test_hits_no_obstacles_default_behaviour_false(): + assert _hits([QPointF(0, 20), QPointF(40, 20)], []) is False + + +def test_hits_true_when_segment_crosses_obstacle(): + assert _hits([QPointF(0, 20), QPointF(40, 20)], [RECT]) is True + + +def test_hits_false_when_segment_misses_obstacle(): + assert _hits([QPointF(0, 5), QPointF(40, 5)], [RECT]) is False + + +# --------------------------------------------------------------------------- +# _route +# --------------------------------------------------------------------------- + +def test_route_same_y_no_obstacles_is_straight_line(): + r = _route(QPointF(0, 0), QPointF(100, 0)) + pts = [(p.x(), p.y()) for p in r] + assert pts == pytest.approx([(0.0, 0.0), (100.0, 0.0)]) + + +def test_route_default_obstacles_none_matches_explicit_none(): + # tham so mac dinh: goi khong truyen obstacles == truyen None tuong minh. + r_default = _route(QPointF(0, 0), QPointF(100, 0)) + r_explicit = _route(QPointF(0, 0), QPointF(100, 0), None) + pts_default = [(p.x(), p.y()) for p in r_default] + pts_explicit = [(p.x(), p.y()) for p in r_explicit] + assert pts_default == pytest.approx(pts_explicit) + + +def test_route_different_y_no_obstacles_is_mid_x_elbow(): + r = _route(QPointF(0, 0), QPointF(100, 50)) + pts = [(p.x(), p.y()) for p in r] + assert pts == pytest.approx( + [(0.0, 0.0), (50.0, 0.0), (50.0, 50.0), (100.0, 50.0)] + ) + + +def test_route_same_y_with_obstacle_falls_back_to_detour(): + # obstacle nam giua duong thang mid_x va cung chan luon dai vertical band + # (obstacle qua rong so voi khoang cach 2 diem) -> _route roi xuong nhanh + # detour tren/duoi (margin 44) thay vi elbow don gian. + obstacle_mid = QRectF(40, -10, 20, 20) # phu y=0 tai x trong [40, 60] + r = _route(QPointF(0, 0), QPointF(100, 0), [obstacle_mid]) + pts = [(p.x(), p.y()) for p in r] + assert pts == pytest.approx( + [ + (0.0, 0.0), + (34.0, 0.0), + (34.0, -54.0), + (66.0, -54.0), + (66.0, 0.0), + (100.0, 0.0), + ] + ) + # duong tra ve nay khong con va cham obstacle da cho. + assert _hits(r, [obstacle_mid]) is False + + +def test_route_gives_up_and_returns_colliding_base_when_fully_boxed_in(): + # quirk: neu vat can qua lon, bao kin moi phuong an tranh (vertical band + # va detour tren/duoi deu khong thoat), _route "bo cuoc" va tra ve elbow + # co ban (base) DU NO VAN VA CHAM vat can — khong nem loi, khong dam bao + # duong tra ve la an toan. + huge = QRectF(-1000, -1000, 3000, 3000) + r = _route(QPointF(0, 0), QPointF(100, 50), [huge]) + pts = [(p.x(), p.y()) for p in r] + assert pts == pytest.approx( + [(0.0, 0.0), (50.0, 0.0), (50.0, 50.0), (100.0, 50.0)] + ) + assert _hits(r, [huge]) is True + + +# --------------------------------------------------------------------------- +# _ortho_path +# --------------------------------------------------------------------------- + +def test_ortho_path_straight_case_element_count(): + op = _ortho_path(QPointF(0, 0), QPointF(100, 0)) + assert op.elementCount() == 2 + + +def test_ortho_path_elbow_case_element_count_and_bounds(): + op = _ortho_path(QPointF(0, 0), QPointF(100, 50)) + assert op.elementCount() == 10 + rect = op.boundingRect() + assert (rect.x(), rect.y(), rect.width(), rect.height()) == pytest.approx( + (0.0, 0.0, 100.0, 50.0) + ) + + +def test_ortho_path_default_radius_is_corner_r_12(): + a = _ortho_path(QPointF(0, 0), QPointF(100, 50)) + b = _ortho_path(QPointF(0, 0), QPointF(100, 50), 12) + assert a.elementCount() == b.elementCount() + for i in range(a.elementCount()): + ea, eb = a.elementAt(i), b.elementAt(i) + assert (ea.x, ea.y) == pytest.approx((eb.x, eb.y)) + + +# --------------------------------------------------------------------------- +# _elide +# --------------------------------------------------------------------------- + +def test_elide_short_text_under_limit_is_unchanged(): + assert _elide("hello", 10) == "hello" + + +def test_elide_text_exactly_at_limit_is_unchanged(): + assert _elide("abc", 3) == "abc" + + +def test_elide_long_text_is_cut_with_ellipsis_and_total_len_equals_n(): + result = _elide("hello world this is long", 10) + assert result == "hello wor…" + assert len(result) == 10 + + +def test_elide_newlines_are_replaced_with_spaces(): + assert _elide("line1\nline2", 20) == "line1 line2" + + +def test_elide_empty_string_stays_empty(): + assert _elide("", 10) == "" + + +def test_elide_none_is_treated_as_empty_string(): + assert _elide(None, 10) == "" + + +def test_elide_n_zero_quirk_slices_off_last_char_not_empty(): + # quirk: text[: n - 1] voi n=0 la text[:-1], KHONG phai cat rong. Voi + # chuoi "abc" (len 3 > 0) ket qua la "ab" + dau "..." = "ab...". + assert _elide("abc", 0) == "ab…" + + +def test_elide_n_one_quirk_result_is_just_ellipsis(): + # quirk: voi n=1, text[:0] == "" nen ket qua chi con dau "...". + assert _elide("abc", 1) == "…" + + +def test_elide_n_larger_than_text_length_boundary(): + # len("abcd") = 4 > 3 nen van bi cat, dung == thi khong cat. + assert _elide("abcd", 3) == "ab…" diff --git a/tests/characterization/test_co4e_canvas_widget.py b/tests/characterization/test_co4e_canvas_widget.py new file mode 100644 index 0000000..d91a373 --- /dev/null +++ b/tests/characterization/test_co4e_canvas_widget.py @@ -0,0 +1,842 @@ +"""Characterization test cho ``Co4ECanvas`` (``ui/co4e_canvas.py``, dòng +289-701) — KHÔNG bao gồm ``_NodeItem``/``_EdgeItem`` (hai lớp đó chỉ vẽ, đã +được phủ gián tiếp bởi ``tests/characterization/test_co4e_canvas_geometry.py`` +qua ``_rounded_path``/``_route``/``_elide`` mà ``_EdgeItem.update_path``/ +``_NodeItem.paint`` dùng). + +VÒNG ĐỜI: đây là giàn giáo (scaffolding), KHÔNG phải đặc tả cuối cùng. Mục +đích DUY NHẤT là lưới an toàn cho đợt tách ``ui/co4e_canvas.py`` (2000+ dòng +cả file, xem ``docs/architecture/co4e-split-map.md``) — 8 hàm hình học thuần +đã dời sang ``presentation/co4e/canvas_geometry.py`` rồi (xem test cùng tên); +đợt sau nhiều khả năng sẽ động vào chính ``Co4ECanvas`` (tách thành +``_NodeItem``/``_EdgeItem`` module riêng, hoặc tách state machine +connect/port-drag ra khỏi lớp view). Khi việc tách phần này hoàn tất và ổn +định, các test ở đây nên được viết lại thành test đặc tả (specification test) +cho lớp/API mới; quirk nào liệt kê dưới đây nên có issue riêng nếu ai đó muốn +"dọn" chúng — ĐỪNG tự sửa code sản phẩm để "dọn" quirk khi đọc thấy test này. + +CÁCH CHỐT ASSERT: mọi giá trị dưới đây lấy bằng cách CHẠY code thật (script +``_PROBE_SCRIPT`` bên dưới, qua ``.venv/Scripts/python.exe``, giống hệt lệnh ở +cuối file) rồi dán NGUYÊN VĂN JSON in được vào assert — không suy luận lý +thuyết. + +AN TOÀN DỮ LIỆU: ``Co4ECanvas`` tự nó KHÔNG chạm đĩa/mạng (khác +``Co4ETab``/``Co4ERunManager``) — nhưng import ``cowork_local.config`` (qua +chuỗi import ``cowork_local.ui.co4e_canvas`` -> ``..core.co4e`` -> +``..config``) vẫn tính ``CONFIG_DIR`` từ ``Path.home()`` một lần lúc module +nạp. Để không rủi ro và để chạy trong TIẾN TRÌNH CON riêng (tránh xung đột +``QApplication`` singleton với các test khác đã/sẽ tạo app trong cùng lượt +chạy pytest), toàn bộ probe chạy qua ``subprocess`` với ``HOME``/ +``USERPROFILE`` trỏ vào một ``tmp_path`` sandbox ĐẶT TRƯỚC khi script import +bất kỳ thứ gì thuộc ``cowork_local`` (đúng kỹ thuật +``tools/capture_screens.py::_isolate_home()``: đặt ``USERPROFILE``/``HOME``, +xoá ``HOMEDRIVE``/``HOMEPATH``), và ``QT_QPA_PLATFORM=offscreen`` được đặt +TRƯỚC khi import PySide6 (đúng khuôn ``tools/check_co4e.py`` dòng 22+40-42). +Một assert ngay trong tiến trình con chốt ``CONFIG_DIR`` nằm trong sandbox +trước khi làm gì khác (kiểu ``tools/check_co4e.py:47``). + +KHÔNG spawn thread/gọi provider thật: ``Co4ECanvas`` không có method nào dựng +``QThread``/gọi AI — mọi method characterize ở đây (``add_node``, +``begin_port_drag``/``finish_port_drag``, ``delete_*``, ``zoom_*``, +``relayout*``, ``add_workflow``, ``dropEvent``...) chỉ thao tác trên +``QGraphicsScene``/dict nội bộ, gọi trực tiếp không cần seed job nào. + +CẦN QApplication: các method characterize ở đây dựng ``QGraphicsScene``/ +``QGraphicsItem`` thật, đọc ``transform()``, tạo ``QDropEvent`` — không phải +kiểu giá trị thuần như ``_dist``/``_towards`` (khác +``test_co4e_canvas_geometry.py``, không cần app). + +QUIRK ĐÃ ĐÓNG ĐINH (xem case tương ứng bên dưới — ĐỪNG "dọn" các chỗ này khi +tách, chúng trông như bug nhưng là hành vi đang chạy thật hôm nay): + * ``_finish_connect(target_id)`` với ``target_id == connect_from`` hiện tại + (tự nối vào chính nó) bị bỏ qua HOÀN TOÀN im lặng — không tạo cạnh, không + báo lỗi — nhưng ``_connect_from`` VẪN bị reset về ``None`` (chế độ connect + kết thúc dù không nối được gì). + * ``_make_edge`` chống trùng cạnh CÙNG source+target (kể cả khi gọi lại qua + ``finish_port_drag`` lần hai với cùng cặp) nhưng KHÔNG chống cạnh ngược + hướng (target->source) — hàm không kiểm tra chiều ngược, chỉ kiểm tra + đúng chiều đã cho. + * ``delete_edge(edge)`` gọi ``graph_changed.emit()`` VÔ ĐIỀU KIỆN, kể cả khi + không có item nào khớp để xoá (ví dụ gọi lại lần hai với cùng đối tượng + ``Edge`` đã bị xoá trước đó) — không có "removed count" nào được kiểm tra + trước khi emit. + * ``delete_node`` với id không tồn tại trả về sớm (``item is None: return``) + TRƯỚC dòng emit — nên KHÔNG phát ``graph_changed`` trong trường hợp này, + khác hẳn ``delete_edge`` ở trên. + * ``delete_selected()`` chạy 2 vòng lặp riêng (xoá node trước, xoá cạnh + sau) — nếu một node bị xoá đã kéo theo xoá cả các cạnh nối tới nó (qua + ``delete_node``), thì vòng lặp cạnh thứ hai KHÔNG còn thấy các cạnh đó + nữa (chúng đã biến mất khỏi ``self._edges`` trước khi vòng lặp cạnh chạy + tới), nên chỉ những cạnh CÒN SỐNG và đang selected riêng mới bị xoá thêm. + * ``_zoom_by`` khi đã chạm biên (``_ZOOM_MIN``/``_ZOOM_MAX``) và gọi + ``zoom_in()``/``zoom_out()`` thêm lần nữa: hiệu ứng là no-op tuyệt đối — + không gọi ``self.scale()``, không đổi ``self._zoom`` — vì + ``abs(target - cur) < 1e-6`` chặn sớm. 20 lần ``zoom_in()`` liên tiếp từ + 1.0 chạm trần 3.0 sau đúng 7 lần, 13 lần còn lại là no-op. + * ``add_workflow(nodes, edges, at=None)``: offset áp dụng cho batch mới phụ + thuộc vào canvas ĐÃ có node hay chưa TẠI THỜI ĐIỂM GỌI — batch đầu tiên + (canvas rỗng) giữ nguyên toạ độ gốc (offset 0,0); batch thứ hai (canvas đã + có node từ batch trước) bị dịch (60, 60) dù truyền cùng ``nodes``/``edges`` + y hệt lần đầu. ``at`` được cho tường minh thì luôn thắng offset ngầm này. + * ``add_workflow`` bỏ qua ÂM THẦM mọi cạnh mà một đầu (source hoặc target) + không nằm trong danh sách ``nodes`` đang được thả — không lỗi, không log, + cạnh đó biến mất khỏi kết quả. + * ``dropEvent`` với payload JSON hỏng (không parse được) hoặc payload + workflow rỗng (``wf.nodes`` rỗng) đều là NO-OP HOÀN TOÀN im lặng — không + thêm node nào, không báo lỗi, không exception nào lộ ra ngoài. + * ``dropEvent`` gọi ``self.mapToScene(...)`` trên một view CHƯA từng + ``show()``/resize — toạ độ scene kết quả (đóng đinh trong + ``s11_step_drop_pos``) là quirk của việc mapToScene phụ thuộc viewport mặc + định lúc chưa hiển thị, KHÔNG phải toạ độ "50, 60" người ta tưởng sẽ thấy; + nếu đợt tách sau show canvas trước khi test tương tự, số này sẽ đổi và đó + là dấu hiệu ĐÚNG cần cập nhật lại giá trị đóng đinh, không phải lỗi. + +Lệnh thủ công đã dùng để chốt các con số trên (quy trình ngược, xem cuối +file để chạy lại nếu cần chốt lại sau khi code đổi có chủ đích). +""" +from __future__ import annotations + +import json +import os +import subprocess +import sys +from pathlib import Path + +import pytest + +REPO_ROOT = Path(__file__).resolve().parent.parent.parent +REPO_PARENT = REPO_ROOT.parent + +_PROBE_SCRIPT = r""" +import json +import os +import sys +from pathlib import Path + +sandbox = sys.argv[1] +repo_parent = sys.argv[2] +sys.path.insert(0, repo_parent) + +os.environ["QT_QPA_PLATFORM"] = "offscreen" +for var in ("USERPROFILE", "HOME"): + os.environ[var] = sandbox +os.environ.pop("HOMEDRIVE", None) +os.environ.pop("HOMEPATH", None) + +from PySide6.QtCore import QByteArray, QMimeData, QPointF, Qt +from PySide6.QtGui import QDropEvent +from PySide6.QtWidgets import QApplication + +app = QApplication([]) + +from cowork_local.config import AppConfig, CONFIG_DIR +assert str(Path(sandbox).resolve()) in str(CONFIG_DIR.resolve()), ( + "khong co lap: CONFIG_DIR=" + str(CONFIG_DIR)) + +from cowork_local.core.co4e import Edge, Node, Step, Workflow, workflow_to_dict +from cowork_local.ui.co4e_canvas import CO4E_MIME, Co4ECanvas, _NODE_H, _NODE_W + +result = {} + +# --- Section 1: add_node ---------------------------------------------------- +c1 = Co4ECanvas() +sel_calls = [] +c1.node_selected.connect(lambda nid: sel_calls.append(nid)) +changed = {"n": 0} +c1.graph_changed.connect(lambda: changed.__setitem__("n", changed["n"] + 1)) + +nid1 = c1.add_node(Step(label="A")) +result["s1_nid1"] = nid1 +result["s1_nid1_pos"] = [c1._nodes[nid1].node.x, c1._nodes[nid1].node.y] +result["s1_after_nid1_edges"] = len(c1._edges) +result["s1_sel_calls_after_1"] = list(sel_calls) +result["s1_changed_after_1"] = changed["n"] + +nid2 = c1.add_node(Step(label="B"), x=10, y=20, connect_from=nid1) +result["s1_nid2"] = nid2 +result["s1_nid2_pos"] = [c1._nodes[nid2].node.x, c1._nodes[nid2].node.y] +result["s1_after_nid2_edges"] = [(e.edge.source, e.edge.target, e.edge.id) for e in c1._edges] +result["s1_sel_calls_after_2"] = list(sel_calls) +result["s1_changed_after_2"] = changed["n"] + +nid3 = c1.add_node(Step(label="C"), connect_from="does-not-exist") +result["s1_nid3"] = nid3 +result["s1_after_nid3_edges_count"] = len(c1._edges) + +# --- Section 2: add_step_below ----------------------------------------------- +before_count = len(c1._nodes) +c1.add_step_below("nope-does-not-exist") +result["s2_missing_parent_nodes_unchanged"] = len(c1._nodes) == before_count + +c1.add_step_below(nid2) +new_ids = [nid for nid in c1._nodes if nid not in (nid1, nid2, nid3)] +result["s2_new_node_ids"] = new_ids +new_id = new_ids[0] +result["s2_new_node_pos"] = [c1._nodes[new_id].node.x, c1._nodes[new_id].node.y] +result["s2_edge_nid2_to_new"] = any( + e.edge.source == nid2 and e.edge.target == new_id for e in c1._edges +) + +# --- Section 3: _chain_tail --------------------------------------------------- +result["s3_tail_current_state"] = c1._chain_tail() + +c_empty = Co4ECanvas() +result["s3_tail_empty_canvas"] = c_empty._chain_tail() + +c_single = Co4ECanvas() +single_id = c_single.add_node(Step(label="Solo")) +result["s3_tail_single_node_no_edges"] = c_single._chain_tail() + +# --- Section 4: add_palette_step ---------------------------------------------- +tail_before = c1._chain_tail() +new_pal_id = c1.add_palette_step(Step(label="D"), QPointF(500, 500)) +result["s4_add_palette_step_return"] = new_pal_id +newest_ids = [nid for nid in c1._nodes if nid not in (nid1, nid2, nid3, new_id)] +result["s4_new_ids"] = newest_ids +pal_id = newest_ids[0] +result["s4_pos"] = [c1._nodes[pal_id].node.x, c1._nodes[pal_id].node.y] +result["s4_tail_before"] = tail_before +result["s4_edge_from_tail_to_new"] = any( + e.edge.source == tail_before and e.edge.target == pal_id for e in c1._edges +) + +# --- Section 5: begin_connect / _finish_connect -------------------------------- +c2 = Co4ECanvas() +a2 = c2.add_node(Step(label="A")) +b2 = c2.add_node(Step(label="B")) +result["s5_initial_edges"] = len(c2._edges) + +c2.begin_connect(a2) +result["s5_connect_from_after_begin"] = c2._connect_from +c2._finish_connect(a2) # self-connect +result["s5_connect_from_after_self_finish"] = c2._connect_from +result["s5_edges_after_self_finish"] = len(c2._edges) + +c2.begin_connect(a2) +c2._finish_connect(b2) +result["s5_connect_from_after_finish_ab"] = c2._connect_from +result["s5_edges_after_finish_ab"] = [(e.edge.source, e.edge.target) for e in c2._edges] + +c2._finish_connect(a2) # no active connect (src None) +result["s5_edges_after_finish_with_no_active_connect"] = len(c2._edges) + +# --- Section 6: begin_port_drag / update / finish / _node_at / _make_edge dedup - +c3 = Co4ECanvas() +p3 = c3.add_node(Step(label="P"), x=0, y=0) +q3 = c3.add_node(Step(label="Q"), x=400, y=0) +result["s6_scene_items_before_drag"] = len(c3._scene.items()) + +p_item = c3._nodes[p3] +src_pt = p_item.pos() + QPointF(_NODE_W, _NODE_H / 2) +c3.begin_port_drag(p3, src_pt) +result["s6_port_src_after_begin"] = c3._port_src +result["s6_temp_edge_in_scene_after_begin"] = c3._temp_edge in c3._scene.items() + +mid_pt = QPointF(200, 100) +c3.update_port_drag(mid_pt) +result["s6_temp_edge_path_elements_after_update"] = c3._temp_edge.path().elementCount() + +q_hit_pt = c3._nodes[q3].pos() + QPointF(50, 50) # inside Q's card +node_at_q = c3._node_at(q_hit_pt) +result["s6_node_at_hit_point"] = node_at_q +empty_pt = QPointF(-500, -500) +result["s6_node_at_empty_point"] = c3._node_at(empty_pt) + +c3.finish_port_drag(q_hit_pt) +result["s6_port_src_after_finish"] = c3._port_src +result["s6_temp_edge_after_finish"] = c3._temp_edge +result["s6_edges_after_finish"] = [(e.edge.source, e.edge.target) for e in c3._edges] + +c3.begin_port_drag(p3, src_pt) +c3.finish_port_drag(q_hit_pt) +result["s6_edges_after_duplicate_drag"] = len(c3._edges) + +c3.begin_port_drag(p3, src_pt) +c3.finish_port_drag(empty_pt) +result["s6_edges_after_finish_over_empty_space"] = len(c3._edges) +result["s6_port_src_after_empty_finish"] = c3._port_src + +# --- Section 7: delete_edge / delete_node / delete_selected -------------------- +c4 = Co4ECanvas() +a4 = c4.add_node(Step(label="A"), x=0, y=0) +b4 = c4.add_node(Step(label="B"), x=300, y=0, connect_from=a4) +c4_ = c4.add_node(Step(label="C"), x=600, y=0, connect_from=b4) +d4 = c4.add_node(Step(label="D"), x=900, y=0, connect_from=c4_) +result["s7_initial_edges"] = [(e.edge.source, e.edge.target) for e in c4._edges] + +edge_ab = next(e.edge for e in c4._edges if e.edge.source == a4 and e.edge.target == b4) +changed4 = {"n": 0} +c4.graph_changed.connect(lambda: changed4.__setitem__("n", changed4["n"] + 1)) + +c4.delete_edge(edge_ab) +result["s7_edges_after_delete_ab"] = [(e.edge.source, e.edge.target) for e in c4._edges] +result["s7_changed_after_delete_ab"] = changed4["n"] + +c4.delete_edge(edge_ab) +result["s7_changed_after_delete_ab_again"] = changed4["n"] +result["s7_edges_after_delete_ab_again"] = len(c4._edges) + +result["s7_delete_node_missing_returns_early"] = c4.delete_node("no-such-node") is None +result["s7_changed_after_delete_missing_node"] = changed4["n"] + +c4._nodes[c4_].setSelected(True) +c4.delete_selected() +result["s7_nodes_after_delete_selected"] = sorted(c4._nodes.keys()) +result["s7_edges_after_delete_selected"] = [(e.edge.source, e.edge.target) for e in c4._edges] + +# --- Section 8: zoom ----------------------------------------------------------- +c5 = Co4ECanvas() +result["s8_initial_m11"] = c5.transform().m11() +result["s8_initial_zoom_attr"] = c5._zoom + +c5.zoom_in() +result["s8_m11_after_1_zoom_in"] = c5.transform().m11() +result["s8_zoom_attr_after_1_zoom_in"] = c5._zoom + +m11_series = [] +for _ in range(20): + c5.zoom_in() + m11_series.append(round(c5.transform().m11(), 6)) +result["s8_m11_series_zoom_in_x20_more"] = m11_series +result["s8_zoom_attr_after_many_zoom_in"] = c5._zoom + +before_m11 = c5.transform().m11() +c5.zoom_in() +result["s8_m11_unchanged_when_already_at_cap"] = c5.transform().m11() == before_m11 + +c5.reset_zoom() +result["s8_m11_after_reset"] = c5.transform().m11() +result["s8_zoom_attr_after_reset"] = c5._zoom + +m11_series_out = [] +for _ in range(30): + c5.zoom_out() + m11_series_out.append(round(c5.transform().m11(), 6)) +result["s8_m11_series_zoom_out_x30"] = m11_series_out +result["s8_zoom_attr_after_many_zoom_out"] = c5._zoom + +# --- Section 9: relayout / relayout_if_vertical -------------------------------- +c6 = Co4ECanvas() +c6.relayout() +result["s9_relayout_empty_ok"] = True + +a6 = c6.add_node(Step(label="A"), x=0, y=0) +b6 = c6.add_node(Step(label="B"), x=0, y=150, connect_from=a6) +c6_ = c6.add_node(Step(label="C"), x=0, y=300, connect_from=b6) +result["s9_vertical_before"] = { + a6: [c6._nodes[a6].pos().x(), c6._nodes[a6].pos().y()], + b6: [c6._nodes[b6].pos().x(), c6._nodes[b6].pos().y()], + c6_: [c6._nodes[c6_].pos().x(), c6._nodes[c6_].pos().y()], +} +c6.relayout_if_vertical() +result["s9_vertical_after_relayout_if_vertical"] = { + a6: [c6._nodes[a6].pos().x(), c6._nodes[a6].pos().y()], + b6: [c6._nodes[b6].pos().x(), c6._nodes[b6].pos().y()], + c6_: [c6._nodes[c6_].pos().x(), c6._nodes[c6_].pos().y()], +} + +c7 = Co4ECanvas() +a7 = c7.add_node(Step(label="A"), x=0, y=0) +b7 = c7.add_node(Step(label="B"), x=500, y=50, connect_from=a7) +result["s9_horizontal_before"] = { + a7: [c7._nodes[a7].pos().x(), c7._nodes[a7].pos().y()], + b7: [c7._nodes[b7].pos().x(), c7._nodes[b7].pos().y()], +} +c7.relayout_if_vertical() +result["s9_horizontal_after_relayout_if_vertical"] = { + a7: [c7._nodes[a7].pos().x(), c7._nodes[a7].pos().y()], + b7: [c7._nodes[b7].pos().x(), c7._nodes[b7].pos().y()], +} + +c8 = Co4ECanvas() +a8 = c8.add_node(Step(label="Solo"), x=0, y=0) +c8.relayout_if_vertical() +result["s9_single_node_after_relayout_if_vertical"] = [ + c8._nodes[a8].pos().x(), c8._nodes[a8].pos().y() +] + +# --- Section 10: add_workflow --------------------------------------------------- +c9 = Co4ECanvas() +src_nodes = [ + Node(id="src1", x=0.0, y=0.0, data=Step(label="X")), + Node(id="src2", x=200.0, y=0.0, data=Step(label="Y")), +] +src_edges = [Edge(id="e1", source="src1", target="src2")] + +c9.add_workflow(src_nodes, src_edges, at=None) +first_batch_ids = sorted(c9._nodes.keys()) +result["s10_first_batch_ids"] = first_batch_ids +result["s10_first_batch_positions"] = { + nid: [c9._nodes[nid].pos().x(), c9._nodes[nid].pos().y()] for nid in first_batch_ids +} +result["s10_first_batch_edges"] = [(e.edge.source, e.edge.target) for e in c9._edges] + +c9.add_workflow(src_nodes, src_edges, at=None) +second_batch_ids = sorted(set(c9._nodes.keys()) - set(first_batch_ids)) +result["s10_second_batch_ids"] = second_batch_ids +result["s10_second_batch_positions"] = { + nid: [c9._nodes[nid].pos().x(), c9._nodes[nid].pos().y()] for nid in second_batch_ids +} +result["s10_total_edges_after_second_call"] = len(c9._edges) + +c9.add_workflow(src_nodes, src_edges, at=QPointF(1000, 1000)) +third_batch_ids = sorted( + set(c9._nodes.keys()) - set(first_batch_ids) - set(second_batch_ids) +) +result["s10_third_batch_ids"] = third_batch_ids +result["s10_third_batch_positions"] = { + nid: [c9._nodes[nid].pos().x(), c9._nodes[nid].pos().y()] for nid in third_batch_ids +} + +c10 = Co4ECanvas() +edges_unknown_target = [Edge(id="ex", source="src1", target="unknown")] +c10.add_workflow(src_nodes, edges_unknown_target, at=None) +result["s10_edges_with_unknown_target_dropped"] = len(c10._edges) +result["s10_nodes_still_added_despite_bad_edge"] = len(c10._nodes) + +# --- Section 11: dropEvent ------------------------------------------------------ +_mime_keepalive = [] # QDropEvent only stores a pointer to the QMimeData; the +# Python wrapper must be kept alive for the event's lifetime or mimeData() +# comes back as a dangling/base QObject (hit exactly this while writing the probe). + + +def make_drop_event(payload_bytes, fmt, pos): + mime = QMimeData() + if fmt is not None: + mime.setData(fmt, QByteArray(payload_bytes)) + _mime_keepalive.append(mime) + return QDropEvent(pos, Qt.CopyAction, mime, Qt.NoButton, Qt.NoModifier) + + +c11 = Co4ECanvas() +step_payload = json.dumps({"label": "Dropped Step", "role": "AGENT"}).encode("utf-8") +ev1 = make_drop_event(step_payload, CO4E_MIME, QPointF(50, 60)) +c11.dropEvent(ev1) +result["s11_step_drop_nodes_count"] = len(c11._nodes) +only_id = next(iter(c11._nodes)) +result["s11_step_drop_label"] = c11._nodes[only_id].node.data.label +result["s11_step_drop_pos"] = [c11._nodes[only_id].pos().x(), c11._nodes[only_id].pos().y()] + +wf_payload_dict = { + "kind": "workflow", + "workflow": workflow_to_dict( + Workflow(id="wfX", name="WF", nodes=[Node(id="wn1", x=0.0, y=0.0, data=Step(label="WFNode"))]) + ), +} +ev2 = make_drop_event(json.dumps(wf_payload_dict).encode("utf-8"), CO4E_MIME, QPointF(10, 10)) +before_wf_drop = len(c11._nodes) +c11.dropEvent(ev2) +result["s11_workflow_drop_added_nodes"] = len(c11._nodes) - before_wf_drop + +empty_wf_payload = { + "kind": "workflow", + "workflow": workflow_to_dict(Workflow(id="wfEmpty", name="Empty", nodes=[], edges=[])), +} +ev3 = make_drop_event(json.dumps(empty_wf_payload).encode("utf-8"), CO4E_MIME, QPointF(10, 10)) +before_empty_drop = len(c11._nodes) +c11.dropEvent(ev3) +result["s11_empty_workflow_drop_is_noop"] = len(c11._nodes) == before_empty_drop + +ev4 = make_drop_event(b"{not valid json", CO4E_MIME, QPointF(10, 10)) +before_bad_json = len(c11._nodes) +c11.dropEvent(ev4) +result["s11_bad_json_drop_is_noop_no_crash"] = len(c11._nodes) == before_bad_json + +ev5 = make_drop_event(b"whatever", "text/plain", QPointF(10, 10)) +before_wrong_fmt = len(c11._nodes) +c11.dropEvent(ev5) +result["s11_wrong_mime_format_is_noop_no_crash"] = len(c11._nodes) == before_wrong_fmt + +print(json.dumps(result, sort_keys=True)) +print("PROBE_OK") +""" + + +@pytest.fixture(scope="module") +def probe_result(tmp_path_factory): + """Chạy ``_PROBE_SCRIPT`` một lần cho cả module trong TIẾN TRÌNH CON, trả + về dict JSON đã in được. Test riêng lẻ chỉ đọc lại dict này — không dựng + lại canvas cho mỗi assert.""" + sandbox = tmp_path_factory.mktemp("co4e-canvas-widget-home") + + env = dict(os.environ) + env["HOME"] = str(sandbox) + env["USERPROFILE"] = str(sandbox) + env["QT_QPA_PLATFORM"] = "offscreen" + env.pop("HOMEDRIVE", None) + env.pop("HOMEPATH", None) + + result = subprocess.run( + [sys.executable, "-c", _PROBE_SCRIPT, str(sandbox), str(REPO_PARENT)], + cwd=str(REPO_ROOT), + env=env, + capture_output=True, + text=True, + timeout=60, + ) + assert result.returncode == 0, ( + f"probe co4e canvas widget that bai (exit {result.returncode}):\n" + f"--- stdout ---\n{result.stdout}\n--- stderr ---\n{result.stderr}" + ) + assert "PROBE_OK" in result.stdout, result.stdout + + json_line = result.stdout.strip().splitlines()[-2] + return json.loads(json_line) + + +# --------------------------------------------------------------------------- +# Section 1: add_node +# --------------------------------------------------------------------------- + +def test_add_node_default_pos_and_no_edge_without_connect_from(probe_result): + assert probe_result["s1_nid1"] == "node_000001" + assert probe_result["s1_nid1_pos"] == pytest.approx([60.0, 60.0]) + assert probe_result["s1_after_nid1_edges"] == 0 + + +def test_add_node_emits_node_selected_and_graph_changed(probe_result): + # add_node emits graph_changed rồi node_selected — 1 lần add_node "trơn" + # (không connect_from hợp lệ) vẫn tính là 2 lần graph_changed: một từ + # add_node, một từ _reposition_edges gọi ngầm bên trong add_node? Số thực + # tế chốt được là 2 sau lần add_node đầu tiên. + assert probe_result["s1_changed_after_1"] == 2 + assert probe_result["s1_sel_calls_after_1"] == ["node_000001"] + + +def test_add_node_with_valid_connect_from_creates_edge_with_deterministic_id(probe_result): + assert probe_result["s1_nid2"] == "node_000002" + assert probe_result["s1_nid2_pos"] == pytest.approx([10.0, 20.0]) + assert probe_result["s1_after_nid2_edges"] == [ + ["node_000001", "node_000002", "e_node_000001__node_000002"], + ] + assert probe_result["s1_changed_after_2"] == 5 + assert probe_result["s1_sel_calls_after_2"] == ["node_000001", "node_000002"] + + +def test_add_node_with_unknown_connect_from_is_silently_skipped(probe_result): + # quirk: connect_from khong ton tai trong _nodes -> khong tao canh, khong + # loi, node van duoc them binh thuong. + assert probe_result["s1_nid3"] == "node_000003" + assert probe_result["s1_after_nid3_edges_count"] == 1 + + +# --------------------------------------------------------------------------- +# Section 2: add_step_below +# --------------------------------------------------------------------------- + +def test_add_step_below_missing_parent_is_noop(probe_result): + assert probe_result["s2_missing_parent_nodes_unchanged"] is True + + +def test_add_step_below_places_new_node_to_the_right_and_connects(probe_result): + # parent (nid2) o (10, 20); node moi o (10 + _NODE_W(210) + 150, 20) = (370, 20). + assert probe_result["s2_new_node_ids"] == ["node_000004"] + assert probe_result["s2_new_node_pos"] == pytest.approx([370.0, 20.0]) + assert probe_result["s2_edge_nid2_to_new"] is True + + +# --------------------------------------------------------------------------- +# Section 3: _chain_tail +# --------------------------------------------------------------------------- + +def test_chain_tail_picks_last_inserted_node_without_outgoing_edge(probe_result): + # trang thai luc nay: nid1->nid2->new(node_000004); nid3 dung mot minh. + # tails (theo thu tu chen) = [nid3, new] -> tails[-1] = new. + assert probe_result["s3_tail_current_state"] == "node_000004" + + +def test_chain_tail_empty_canvas_returns_empty_string(probe_result): + assert probe_result["s3_tail_empty_canvas"] == "" + + +def test_chain_tail_single_node_with_no_edges_is_itself(probe_result): + assert probe_result["s3_tail_single_node_no_edges"] == "node_000005" + + +# --------------------------------------------------------------------------- +# Section 4: add_palette_step +# --------------------------------------------------------------------------- + +def test_add_palette_step_returns_none_unlike_add_node(probe_result): + # quirk: add_palette_step KHONG tra ve id node moi (khac add_node) - no + # goi self.add_node(...) nhung khong return ket qua cua no. + assert probe_result["s4_add_palette_step_return"] is None + + +def test_add_palette_step_uses_pos_directly_and_chains_from_tail(probe_result): + assert probe_result["s4_tail_before"] == "node_000004" + assert probe_result["s4_new_ids"] == ["node_000006"] + assert probe_result["s4_pos"] == pytest.approx([500.0, 500.0]) + assert probe_result["s4_edge_from_tail_to_new"] is True + + +# --------------------------------------------------------------------------- +# Section 5: begin_connect / _finish_connect +# --------------------------------------------------------------------------- + +def test_begin_connect_sets_pending_source(probe_result): + assert probe_result["s5_connect_from_after_begin"] == "node_000007" + + +def test_finish_connect_self_target_quirk_resets_state_but_makes_no_edge(probe_result): + # quirk: target_id == connect_from (tu noi minh vao minh) bi bo qua im + # lang, KHONG tao canh, nhung _connect_from van duoc reset ve None. + assert probe_result["s5_connect_from_after_self_finish"] is None + assert probe_result["s5_edges_after_self_finish"] == 0 + + +def test_finish_connect_valid_pair_creates_edge_and_resets_state(probe_result): + assert probe_result["s5_connect_from_after_finish_ab"] is None + assert probe_result["s5_edges_after_finish_ab"] == [["node_000007", "node_000008"]] + + +def test_finish_connect_with_no_active_connect_is_noop(probe_result): + assert probe_result["s5_edges_after_finish_with_no_active_connect"] == 1 + + +# --------------------------------------------------------------------------- +# Section 6: begin_port_drag / update_port_drag / finish_port_drag / _node_at +# --------------------------------------------------------------------------- + +def test_begin_port_drag_adds_temp_edge_item_to_scene(probe_result): + assert probe_result["s6_scene_items_before_drag"] == 2 + assert probe_result["s6_port_src_after_begin"] == "node_000009" + assert probe_result["s6_temp_edge_in_scene_after_begin"] is True + + +def test_update_port_drag_sets_elbow_path_on_temp_edge(probe_result): + # P o (0,0)->cong o (210,48); dich toi (200,100) khac y -> nhanh elbow + # cua _ortho_path (10 element, khop voi test_co4e_canvas_geometry.py). + assert probe_result["s6_temp_edge_path_elements_after_update"] == 10 + + +def test_node_at_hits_node_under_point_and_none_when_empty(probe_result): + assert probe_result["s6_node_at_hit_point"] == "node_000010" + assert probe_result["s6_node_at_empty_point"] is None + + +def test_finish_port_drag_creates_edge_and_clears_temp_state(probe_result): + assert probe_result["s6_port_src_after_finish"] is None + assert probe_result["s6_temp_edge_after_finish"] is None + assert probe_result["s6_edges_after_finish"] == [["node_000009", "node_000010"]] + + +def test_make_edge_dedups_same_source_target_pair(probe_result): + # quirk: keo lai dung cap p->q lan hai khong tao canh trung. + assert probe_result["s6_edges_after_duplicate_drag"] == 1 + + +def test_finish_port_drag_over_empty_space_adds_no_edge_and_clears_state(probe_result): + assert probe_result["s6_edges_after_finish_over_empty_space"] == 1 + assert probe_result["s6_port_src_after_empty_finish"] is None + + +# --------------------------------------------------------------------------- +# Section 7: delete_edge / delete_node / delete_selected +# --------------------------------------------------------------------------- + +def test_delete_edge_removes_matching_item_and_emits_graph_changed(probe_result): + assert probe_result["s7_initial_edges"] == [ + ["node_000011", "node_000012"], + ["node_000012", "node_000013"], + ["node_000013", "node_000014"], + ] + assert probe_result["s7_edges_after_delete_ab"] == [ + ["node_000012", "node_000013"], + ["node_000013", "node_000014"], + ] + assert probe_result["s7_changed_after_delete_ab"] == 1 + + +def test_delete_edge_called_again_on_already_removed_edge_still_emits(probe_result): + # quirk: khong co "removed count" guard - goi lai voi Edge da bi xoa van + # phat graph_changed, du khong con item nao khop de xoa. + assert probe_result["s7_changed_after_delete_ab_again"] == 2 + assert probe_result["s7_edges_after_delete_ab_again"] == 2 + + +def test_delete_node_missing_id_returns_early_without_emitting(probe_result): + # quirk: khac delete_edge o tren - delete_node voi id khong ton tai return + # SOM (truoc dong emit), nen KHONG phat graph_changed trong truong hop nay. + assert probe_result["s7_delete_node_missing_returns_early"] is True + assert probe_result["s7_changed_after_delete_missing_node"] == 2 + + +def test_delete_selected_node_cascades_its_edges_before_edge_loop_runs(probe_result): + # quirk: xoa node c4_ (id thu 3, "node_000013") keo theo xoa ca 2 canh noi + # toi no (b->c va c->d) NGAY trong vong lap xoa node; vong lap xoa canh + # (rieng, cho canh dang selected) sau do khong con thay 2 canh nay nua. + assert probe_result["s7_nodes_after_delete_selected"] == [ + "node_000011", "node_000012", "node_000014", + ] + assert probe_result["s7_edges_after_delete_selected"] == [] + + +# --------------------------------------------------------------------------- +# Section 8: _zoom_by / zoom_in / zoom_out / reset_zoom +# --------------------------------------------------------------------------- + +def test_zoom_in_once_scales_by_1_15(probe_result): + assert probe_result["s8_initial_m11"] == pytest.approx(1.0) + assert probe_result["s8_initial_zoom_attr"] == pytest.approx(1.0) + assert probe_result["s8_m11_after_1_zoom_in"] == pytest.approx(1.15) + assert probe_result["s8_zoom_attr_after_1_zoom_in"] == pytest.approx(1.15) + + +def test_zoom_in_clamps_at_max_after_7_steps_from_1_0(probe_result): + # quirk: tran _ZOOM_MAX=3.0 dat duoc sau dung 7 lan zoom_in() lien tiep tu + # 1.0 (1 lan da tinh o test truoc + 6 lan trong series nay); 13 lan con + # lai trong series 20 lan la no-op tuyet doi (gia tri dung yen o 3.0). + expected = [ + 1.3225, 1.520875, 1.749006, 2.011357, 2.313061, 2.66002, 3.0, + 3.0, 3.0, 3.0, 3.0, 3.0, 3.0, 3.0, 3.0, 3.0, 3.0, 3.0, 3.0, 3.0, + ] + assert probe_result["s8_m11_series_zoom_in_x20_more"] == pytest.approx(expected) + assert probe_result["s8_zoom_attr_after_many_zoom_in"] == pytest.approx(3.0) + + +def test_zoom_in_at_cap_is_exact_noop(probe_result): + assert probe_result["s8_m11_unchanged_when_already_at_cap"] is True + + +def test_reset_zoom_returns_to_1_0_regardless_of_prior_zoom(probe_result): + assert probe_result["s8_m11_after_reset"] == pytest.approx(1.0) + assert probe_result["s8_zoom_attr_after_reset"] == pytest.approx(1.0) + + +def test_zoom_out_clamps_at_min_after_8_steps_from_1_0(probe_result): + # quirk: san _ZOOM_MIN=0.3 dat duoc sau dung 8 lan zoom_out() lien tiep tu + # 1.0; 22 lan con lai trong series 30 lan la no-op (dung yen o 0.3). + expected = [ + 0.869565, 0.756144, 0.657516, 0.571753, 0.497177, 0.432328, 0.375937, + 0.326902, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, + 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, + ] + assert probe_result["s8_m11_series_zoom_out_x30"] == pytest.approx(expected, abs=1e-5) + assert probe_result["s8_zoom_attr_after_many_zoom_out"] == pytest.approx(0.3) + + +# --------------------------------------------------------------------------- +# Section 9: relayout / relayout_if_vertical +# --------------------------------------------------------------------------- + +def test_relayout_on_empty_canvas_is_a_safe_noop(probe_result): + assert probe_result["s9_relayout_empty_ok"] is True + + +def test_relayout_if_vertical_reflows_a_stacked_chain_left_to_right(probe_result): + # 3 node xep doc cung x=0 (chenh lech < _NODE_W=210) -> duoc coi la + # "vertical" -> relayout() sap lai theo wave: cot 0/1/2 x = w*(210+110). + assert probe_result["s9_vertical_before"] == { + "node_000015": pytest.approx([0.0, 0.0]), + "node_000016": pytest.approx([0.0, 150.0]), + "node_000017": pytest.approx([0.0, 300.0]), + } + assert probe_result["s9_vertical_after_relayout_if_vertical"] == { + "node_000015": pytest.approx([0.0, 0.0]), + "node_000016": pytest.approx([320.0, 0.0]), + "node_000017": pytest.approx([640.0, 0.0]), + } + + +def test_relayout_if_vertical_leaves_already_horizontal_graph_untouched(probe_result): + # chenh lech x (500) >= _NODE_W(210) -> khong duoc coi la "vertical" -> + # relayout_if_vertical() khong dong gi toi vi tri da xep, du no khong + # thang hang theo luoi wave. + before = probe_result["s9_horizontal_before"] + after = probe_result["s9_horizontal_after_relayout_if_vertical"] + assert after == before + assert after == { + "node_000018": pytest.approx([0.0, 0.0]), + "node_000019": pytest.approx([500.0, 50.0]), + } + + +def test_relayout_if_vertical_with_fewer_than_2_nodes_is_noop(probe_result): + assert probe_result["s9_single_node_after_relayout_if_vertical"] == pytest.approx( + [0.0, 0.0] + ) + + +# --------------------------------------------------------------------------- +# Section 10: add_workflow +# --------------------------------------------------------------------------- + +def test_add_workflow_first_batch_on_empty_canvas_keeps_original_positions(probe_result): + # quirk: offset ngam ("60 neu self._nodes khac rong") kiem tra TRANG THAI + # canvas LUC GOI, khong phai lien quan gi den tham so `at`. Canvas rong + # luc goi -> offset (0,0) -> toa do y het nodes goc. + ids = probe_result["s10_first_batch_ids"] + assert len(ids) == 2 + positions = probe_result["s10_first_batch_positions"] + assert positions[ids[0]] == pytest.approx([0.0, 0.0]) + assert positions[ids[1]] == pytest.approx([200.0, 0.0]) + assert probe_result["s10_first_batch_edges"] == [[ids[0], ids[1]]] + + +def test_add_workflow_second_batch_same_args_gets_implicit_60_60_offset(probe_result): + # quirk: goi lai add_workflow VOI CUNG nodes/edges (khong at) nhung canvas + # gio da co node tu lan truoc -> offset ngam (60, 60) duoc ap dung, id moi + # hoan toan khac (fresh new_node_id moi lan). + ids = probe_result["s10_second_batch_ids"] + positions = probe_result["s10_second_batch_positions"] + assert positions[ids[0]] == pytest.approx([60.0, 60.0]) + assert positions[ids[1]] == pytest.approx([260.0, 60.0]) + assert probe_result["s10_total_edges_after_second_call"] == 2 + + +def test_add_workflow_with_explicit_at_overrides_implicit_offset(probe_result): + ids = probe_result["s10_third_batch_ids"] + positions = probe_result["s10_third_batch_positions"] + assert positions[ids[0]] == pytest.approx([1000.0, 1000.0]) + assert positions[ids[1]] == pytest.approx([1200.0, 1000.0]) + + +def test_add_workflow_silently_drops_edges_with_unknown_endpoint(probe_result): + assert probe_result["s10_edges_with_unknown_target_dropped"] == 0 + assert probe_result["s10_nodes_still_added_despite_bad_edge"] == 2 + + +# --------------------------------------------------------------------------- +# Section 11: dropEvent +# --------------------------------------------------------------------------- + +def test_drop_event_step_payload_adds_node_with_dropped_label(probe_result): + assert probe_result["s11_step_drop_nodes_count"] == 1 + assert probe_result["s11_step_drop_label"] == "Dropped Step" + # quirk: view chua tung show()/resize khi dropEvent chay -> mapToScene tra + # ve toa do phu thuoc kich thuoc viewport MAC DINH cua QGraphicsView chua + # hien, KHONG phai (50, 60) nhu vi tri tha ban dau - dong dinh dung so da + # chay ra duoc, khong suy doan. + assert probe_result["s11_step_drop_pos"] == pytest.approx([-269.0, -179.0]) + + +def test_drop_event_workflow_payload_merges_its_nodes(probe_result): + assert probe_result["s11_workflow_drop_added_nodes"] == 1 + + +def test_drop_event_empty_workflow_payload_is_a_silent_noop(probe_result): + # quirk: workflow rong (wf.nodes == []) khong lam gi ca - `if wf.nodes:` + # false nen add_workflow khong duoc goi, khong loi, khong node moi. + assert probe_result["s11_empty_workflow_drop_is_noop"] is True + + +def test_drop_event_invalid_json_payload_is_a_silent_noop(probe_result): + # quirk: except (ValueError, UnicodeDecodeError): return - khong nem loi + # ra ngoai, khong e.acceptProposedAction() nao duoc goi trong nhanh nay. + assert probe_result["s11_bad_json_drop_is_noop_no_crash"] is True + + +def test_drop_event_wrong_mime_format_falls_back_to_base_class_noop(probe_result): + assert probe_result["s11_wrong_mime_format_is_noop_no_crash"] is True + + +# --------------------------------------------------------------------------- +# Lenh thu cong da dung de chot cac gia tri JSON o tren (quy trinh nguoc): +# +# .venv/Scripts/python.exe -c "" +# +# voi la mot thu muc rong duoc gan vao HOME/USERPROFILE TRUOC khi +# script import bat ky thu gi thuoc cowork_local, va la thu muc +# cha cua repo (de "import cowork_local" hoat dong dung nhu conftest.py lam). +# --------------------------------------------------------------------------- diff --git a/tests/characterization/test_co4e_chat_view.py b/tests/characterization/test_co4e_chat_view.py new file mode 100644 index 0000000..6e0b493 --- /dev/null +++ b/tests/characterization/test_co4e_chat_view.py @@ -0,0 +1,474 @@ +"""Characterization test cho khu vực CHAT của ``Co4ETab`` (``ui/co4e_tab.py``). + +BỌC HAI PHẦN ĐỘC LẬP (đúng phạm vi được giao cho lượt này — KHÔNG động tới gì +khác): + + (A) ``class _ChatInput(QLineEdit)`` (dòng 139-228) + 3 hàm module-level nó + dùng: ``_skill_names`` (63-67), ``_agent_names`` (70-73), + ``_directive_token`` (124-136). Đây là ô chat có autocomplete + ``/skill:``/``/agent:`` (popup gợi ý, phím mũi tên/Tab/Enter/Escape). + (B) phần DỰNG WIDGET của ``Co4ETab._build_chat`` (dòng 1030-1093) — header + "Messages" + ``chat_stack`` + composer (ô chat + routing toggle + nút + gửi). KHÔNG bao gồm ``_toggle_messages`` (1095-1127) — hàm đó vẫn ở lại + ``Co4ETab`` và không được test ở đây. + +VÌ SAO GHI LẠI CHỨ KHÔNG PHÁN XÉT: đây là lưới an toàn cho đợt tách +``ui/co4e_tab.py`` (2000+ dòng) sang ``presentation/co4e/co4e_chat_view.py``. +Đợt này CHƯA tạo file production đó — chỉ chụp ảnh hành vi hiện tại của khu +vực chat để đợt tách sau có bằng chứng "trước/sau giống nhau". Mọi ``assert`` +dưới đây được chốt lại từ giá trị THẬT in ra khi chạy code (quy trình ngược: +chạy trước, in kết quả, dán vào assert) — không phải giá trị suy luận trước. + +VÌ SAO CHẠY TRONG TIẾN TRÌNH CON CÔ LẬP HOME: giống hệt kỹ thuật của +``tests/characterization/test_co4e_skills_panel.py``/``test_co4e_agent_panel.py``. +``_ChatInput._maybe_popup`` gọi ``_skill_names()``/``_agent_names()``, và +``_skill_names()`` đọc thật từ ``core/skills.py::SKILLS_DIR`` (hằng số module +tính MỘT LẦN lúc import, từ ``CONFIG_DIR = Path.home() / ".cowork_local"``). +Muốn đổi ``Path.home()`` phải đặt ``USERPROFILE``/``HOME`` TRƯỚC bất kỳ +import ``cowork_local.*`` nào, nên toàn bộ phần dựng ``QApplication`` + +``Co4ETab``/``_ChatInput`` chạy trong MỘT tiến trình con sạch (giống +``tools/capture_screens.py::_isolate_home()``), không phải trong tiến trình +pytest chính (nơi ``cowork_local`` rất có thể đã bị import từ trước bởi một +test khác, khiến việc patch ``os.environ`` sau đó vô nghĩa). + +KHÔNG gọi AI/QThread thật: cả (A) và (B) không đụng ``Co4ERunManager``/ +``AgentWorker``/``ChatView`` thật đi gửi tin — (B) chỉ dựng widget rồi thay +``_chat_send``/``_toggle_messages`` bằng stub đếm lệnh gọi (Co4ETab thật cần +``self.ctx``, ``self._chat_send``, ``self._toggle_messages`` đã tồn tại vì +``_build_chat`` nối ``.clicked``/``.submit`` tới chúng ngay trong hàm — gọi +``Co4ETab._build_chat(fake_self)`` như một hàm KHÔNG bị ràng buộc (unbound), +với ``fake_self`` là một object tối giản chỉ có ``ctx`` + 2 stub đó, để không +phải dựng toàn bộ ``Co4ETab``/canvas/sidebar nặng nề). + +QUIRK ĐÃ ĐÓNG ĐINH (xem case tương ứng bên dưới): + * ``/agent:`` chèn NGUYÊN TÊN agent (có thể chứa dấu cách, ví dụ + "Business Analyst") vào ô chat, KHÔNG slugify — trong khi ``/skill:`` + chèn ``co4e.slugify(name)`` (không dấu cách). Hai directive cùng cú pháp + nhưng xử lý tên khác nhau; một khi đã chèn, chuỗi "/agent:Business Analyst " + có dấu cách nên ``_directive_token`` không còn coi phần sau dấu cách là + thuộc token đó nữa (regex partial dùng ``[\\w\\-.]*``, không nhận dấu cách). + * Autocomplete kích hoạt từ khi gõ mới 2 ký tự ("/a" hoặc "/sk"), TRƯỚC khi + có dấu ``:`` — nhánh fallback trong ``_directive_token`` khớp theo tiền tố + của ``"/skill"``/``"/agent"`` với ``partial=""``, nên popup hiện TOÀN BỘ + danh sách skill/agent ngay từ 2 ký tự, không phải danh sách rỗng. + * Khi popup ĐANG hiện có ít nhất 1 dòng, phím Enter/Return CHỌN dòng đó + (``_accept``) và KHÔNG emit ``submit`` — ngược với khi popup ẩn, Enter emit + ``submit`` để gửi tin. Cùng một phím, hai hành vi khác nhau tuỳ trạng thái + popup. + * Phím Down/Up trên popup dùng modulo (``(row + step) % n``) nên vòng lặp: + từ dòng cuối bấm Down quay về dòng đầu, từ dòng đầu bấm Up quay về dòng + cuối — không dừng ở biên như nhiều danh sách khác. + * ``_accept()`` khi popup không có dòng nào được chọn (ẩn, rỗng) là no-op + tuyệt đối — không đổi text, không đổi con trỏ, không ném lỗi. + * ``_agent_names()`` không loại trùng theo slug mà theo TÊN HIỂN THỊ: một + custom agent trùng tên với một agent built-in (ví dụ "Business Analyst") + "thắng" — built-in cùng tên bị lọc khỏi danh sách (custom agents được đưa + vào trước, built-in chỉ thêm nếu tên chưa có). + * ``_skill_names()`` bọc try/except quanh toàn bộ ``list_skills() + + builtin_skills()`` và trả về ``[]`` một cách im lặng khi lỗi — autocomplete + ``/skill:`` khi đó chỉ đơn giản không hiện popup, không có thông báo lỗi. + +VÒNG ĐỜI: đây là giàn giáo cho đợt tách khu vực CHAT (``ui/co4e_tab.py`` dòng +139-228 + phần dựng widget 1030-1093) sang +``presentation/co4e/co4e_chat_view.py``. Sau khi tách xong, các case ở phần +(A) nên viết lại thành test đặc tả cho ``_ChatInput``/hàm module độc lập +(không cần subprocess/QApplication nặng nếu module mới không còn đọc đĩa lúc +import), còn phần (B) nên viết lại thành test đặc tả cho widget composer mới +(input rõ ràng: ctx giả + 2 callback, không cần dựng qua ``Co4ETab`` gốc). +Quirk "agent không slugify nhưng skill có" và quirk "dedup theo tên hiển thị" +đáng mở issue hỏi ý kiến sản phẩm trước khi ai đó "dọn" chúng trong lúc tách — +rất dễ bị coi là bug và "sửa" nhầm trong khi đây là hành vi đang chạy thật. +""" +from __future__ import annotations + +import os +import subprocess +import sys +from pathlib import Path + +REPO_ROOT = Path(__file__).resolve().parent.parent.parent +REPO_PARENT = REPO_ROOT.parent + +_SCRIPT = r""" +import json +import sys +sys.path.insert(0, REPO_PARENT_PLACEHOLDER) + +from PySide6.QtWidgets import QApplication, QListWidget +from PySide6.QtCore import Qt, QEvent +from PySide6.QtGui import QKeyEvent + +from cowork_local.config import AppConfig, CONFIG_DIR +from cowork_local.state import AppContext +from cowork_local.core import co4e, skills as skills_mod +from cowork_local.core.co4e_builtins import BUILTIN_AGENTS +from cowork_local.ui.co4e_tab import ( + Co4ETab, _ChatInput, _directive_token, _skill_names, _agent_names, +) +from cowork_local.i18n import tr + +sandbox = sys.argv[1] +assert str(CONFIG_DIR).startswith(sandbox), "khong co lap: CONFIG_DIR=" + str(CONFIG_DIR) + +app = QApplication([]) +ctx = AppContext(AppConfig.load()) + +# ===================================================================== +# PHAN A1: _directive_token (124-136) - ham thuan, khong dung Qt/dia +# ===================================================================== +cases = [ + ("/skill:", 7, (0, "skill", "")), + ("/skill:abc", 11, (0, "skill", "abc")), + ("/agent", 6, (0, "agent", "")), + ("/agent:", 7, (0, "agent", "")), + ("/sk", 3, (0, "skill", "")), + ("/a", 2, (0, "agent", "")), + ("/", 1, None), + ("", 0, None), + ("hello", 5, None), + ("hello /agent:bob", 17, (6, "agent", "bob")), + ("hello /agent:bob", 10, (6, "agent", "")), + ("/skill:ab cd", 9, (0, "skill", "ab")), + ("/skill:ab cd", 12, None), + ("//skill", 7, None), +] +for text, pos, expected in cases: + got = _directive_token(text, pos) + assert got == expected, (text, pos, got, expected) +print("CASE_DIRECTIVE_TOKEN_OK") + +# ===================================================================== +# PHAN A2: _skill_names / _agent_names - doc dia thong qua sandbox +# ===================================================================== +assert not skills_mod.SKILLS_DIR.exists(), skills_mod.SKILLS_DIR +assert _skill_names() == [] +builtin_only = _agent_names() +assert builtin_only == [a.name for a in BUILTIN_AGENTS], builtin_only +assert len(builtin_only) == 19, len(builtin_only) +print("CASE_EMPTY_DISK_NAMES_OK") + +# quirk: custom agent TRUNG TEN voi built-in -> built-in bi loc, khong con 2 ban +co4e.AGENTS_DIR.mkdir(parents=True, exist_ok=True) +(co4e.AGENTS_DIR / "a1.json").write_text( + json.dumps({"id": "a1", "name": "Business Analyst", "role": "AGENT"}), + encoding="utf-8") +(co4e.AGENTS_DIR / "a2.json").write_text( + json.dumps({"id": "a2", "name": "My Custom Agent", "role": "AGENT"}), + encoding="utf-8") +mixed = _agent_names() +assert mixed[:2] == ["Business Analyst", "My Custom Agent"], mixed[:2] +assert mixed.count("Business Analyst") == 1, mixed +assert len(mixed) == 20, len(mixed) # 19 built-in - 1 trung ten + 2 custom +print("CASE_AGENT_NAME_DEDUP_QUIRK_OK") + +skills_mod.SKILLS_DIR.mkdir(parents=True, exist_ok=True) +(skills_mod.SKILLS_DIR / "s1.json").write_text(json.dumps({ + "name": "Viet Test", "description": "d", "instructions": "content", "enabled": True, +}), encoding="utf-8") +assert _skill_names() == ["Viet Test"], _skill_names() +print("CASE_SKILL_NAMES_AFTER_CREATE_OK") + +# ===================================================================== +# PHAN A3: _ChatInput - popup autocomplete + phim tat +# ===================================================================== +ci = _ChatInput() +assert hasattr(ci, "submit") +assert ci._popup.focusPolicy() == Qt.NoFocus +assert ci._popup.windowFlags() == ( + Qt.Tool | Qt.FramelessWindowHint | Qt.WindowStaysOnTopHint + | Qt.NoDropShadowWindowHint) +print("CASE_CHATINPUT_CTOR_OK") + +# go "/skill:vi" -> 1 dong goi y, replacement da slugify + khoang trang cuoi +ci.setText("/skill:vi") +ci.setCursorPosition(len("/skill:vi")) +ci._maybe_popup() +assert ci._popup.count() == 1, ci._popup.count() +row0 = ci._popup.item(0) +assert row0.text() == "Viet Test", row0.text() +assert row0.data(Qt.UserRole) == "/skill:viet-test ", row0.data(Qt.UserRole) +assert row0.toolTip() == "Viet Test", row0.toolTip() +assert ci._popup.isVisible() is True +# quirk: chieu rong popup = max(280, chieu rong o chat) - khong co gia tri co dinh +assert ci._popup.width() == max(280, ci.width()), (ci._popup.width(), ci.width()) +assert ci._popup.height() == 8 + 1 * 22, ci._popup.height() # 1 dong -> 30px +print("CASE_SKILL_POPUP_SLUGIFIED_OK") + +# quirk: /agent: CHEN NGUYEN TEN (co dau cach), KHONG slugify +ci.setText("/agent:business") +ci.setCursorPosition(len("/agent:business")) +ci._maybe_popup() +assert ci._popup.count() == 1, ci._popup.count() +row_a = ci._popup.item(0) +assert row_a.text() == "Business Analyst", row_a.text() +assert row_a.data(Qt.UserRole) == "/agent:Business Analyst ", row_a.data(Qt.UserRole) +print("CASE_AGENT_POPUP_NOT_SLUGIFIED_QUIRK_OK") + +# quirk: goi "/a" (2 ky tu, chua co dau :) da kich hoat popup agent VOI partial rong +# -> hien TOAN BO danh sach agent, khong phai danh sach rong +ci.setText("/a") +ci.setCursorPosition(2) +ci._maybe_popup() +assert ci._popup.count() == len(_agent_names()), (ci._popup.count(), len(_agent_names())) +print("CASE_TWO_CHAR_PREFIX_TRIGGERS_FULL_LIST_QUIRK_OK") + +# khong khop skill nao -> popup an, count 0 +ci.setText("/skill:khongtontai") +ci.setCursorPosition(len("/skill:khongtontai")) +ci._maybe_popup() +assert ci._popup.isVisible() is False, ci._popup.isVisible() +assert ci._popup.count() == 0, ci._popup.count() +print("CASE_NO_MATCH_HIDES_POPUP_OK") + +# khong phai directive -> an popup (du popup dang duoc show truoc do) +ci._popup.show() +ci.setText("hello") +ci.setCursorPosition(5) +ci._maybe_popup() +assert ci._popup.isVisible() is False +print("CASE_NON_DIRECTIVE_HIDES_POPUP_OK") + +# _accept() thay the token bang replacement + dat lai con tro +ci.setText("/skill:vi") +ci.setCursorPosition(len("/skill:vi")) +ci._maybe_popup() +ci._accept() +assert ci.text() == "/skill:viet-test ", ci.text() +assert ci.cursorPosition() == len("/skill:viet-test "), ci.cursorPosition() +assert ci._popup.isVisible() is False +print("CASE_ACCEPT_REPLACES_TOKEN_OK") + +# quirk: _accept() khi khong co dong nao duoc chon -> no-op tuyet doi +ci._popup.clear() +ci._popup.hide() +ci.setText("hello world") +ci.setCursorPosition(5) +ci._accept() +assert ci.text() == "hello world", ci.text() +assert ci.cursorPosition() == 5, ci.cursorPosition() +print("CASE_ACCEPT_NOOP_WHEN_NO_ITEM_QUIRK_OK") + +# Enter voi popup AN -> emit submit (gui tin) +submitted = [] +ci.submit.connect(lambda: submitted.append(1)) +ci._popup.hide() +ci.keyPressEvent(QKeyEvent(QEvent.KeyPress, Qt.Key_Return, Qt.NoModifier)) +assert submitted == [1], submitted +print("CASE_ENTER_SUBMITS_WHEN_POPUP_HIDDEN_OK") + +# quirk: Enter voi popup DANG HIEN (co dong) -> accept, KHONG submit +ci.setText("/skill:vi") +ci.setCursorPosition(len("/skill:vi")) +ci._maybe_popup() +assert ci._popup.isVisible() is True and ci._popup.count() == 1 +submitted.clear() +ci.keyPressEvent(QKeyEvent(QEvent.KeyPress, Qt.Key_Return, Qt.NoModifier)) +assert ci.text() == "/skill:viet-test ", ci.text() +assert submitted == [], submitted +print("CASE_ENTER_ACCEPTS_INSTEAD_OF_SUBMIT_WHEN_POPUP_VISIBLE_QUIRK_OK") + +# quirk: Down/Up dung modulo -> vong lap qua bien +(skills_mod.SKILLS_DIR / "s2.json").write_text(json.dumps({ + "name": "Second Skill", "description": "", "instructions": "x", "enabled": True, +}), encoding="utf-8") +ci.setText("/skill:") +ci.setCursorPosition(len("/skill:")) +ci._maybe_popup() +assert ci._popup.count() == 2, ci._popup.count() +assert ci._popup.currentRow() == 0 +ci.keyPressEvent(QKeyEvent(QEvent.KeyPress, Qt.Key_Down, Qt.NoModifier)) +assert ci._popup.currentRow() == 1 +ci.keyPressEvent(QKeyEvent(QEvent.KeyPress, Qt.Key_Down, Qt.NoModifier)) +assert ci._popup.currentRow() == 0, ci._popup.currentRow() # vong lai dau +ci.keyPressEvent(QKeyEvent(QEvent.KeyPress, Qt.Key_Up, Qt.NoModifier)) +assert ci._popup.currentRow() == 1, ci._popup.currentRow() # vong ve cuoi +print("CASE_UP_DOWN_WRAP_AROUND_QUIRK_OK") + +# Escape an popup +ci.keyPressEvent(QKeyEvent(QEvent.KeyPress, Qt.Key_Escape, Qt.NoModifier)) +assert ci._popup.isVisible() is False +print("CASE_ESCAPE_HIDES_POPUP_OK") + +# Tab cung accept (giong Enter khi popup hien) +ci.setText("/skill:vi") +ci.setCursorPosition(len("/skill:vi")) +ci._maybe_popup() +ci.keyPressEvent(QKeyEvent(QEvent.KeyPress, Qt.Key_Tab, Qt.NoModifier)) +assert ci.text() == "/skill:viet-test ", ci.text() +print("CASE_TAB_ACCEPTS_OK") + +# ===================================================================== +# PHAN B: Co4ETab._build_chat (1030-1093) - CHI phan dung widget, +# KHONG bao gom _toggle_messages (o lai Co4ETab, khong test o day) +# ===================================================================== +calls = [] + + +class _FakeCo4ETab: + ctx = ctx + + def _toggle_messages(self): + calls.append("toggle") + + def _chat_send(self): + calls.append("send") + + +fake = _FakeCo4ETab() +w = Co4ETab._build_chat(fake) # goi nhu ham khong rang buoc, khong dung Co4ETab thuc + +# DA CAP NHAT sau khi tach "Chat View" (xem +# presentation/co4e/co4e_chat_view.py): _build_chat gio tra ve mot ChatPanel +# (subclass QWidget dung trong presentation/co4e/co4e_chat_view.py) thay vi +# mot QWidget tran - van la mot QWidget that su (layout/cac widget con van +# nguyen), chi ten class cu the doi (cung khuon mau da dung cho +# RunsPagePanel, xem test_co4e_runs_page.py::test_runs_table_is_parented_into_the_returned_widget). +assert type(w).__name__ == "ChatPanel" +assert w is fake._chat_widget +assert w.layout().contentsMargins().left() == 0 +assert w.layout().spacing() == 0 +assert w.layout().count() == 3, w.layout().count() +child_types = [w.layout().itemAt(i).widget().objectName() or type(w.layout().itemAt(i).widget()).__name__ + for i in range(w.layout().count())] +assert child_types == ["msgHeader", "QStackedWidget", "QWidget"], child_types +print("CASE_BUILD_CHAT_TOP_LAYOUT_OK") + +# ---- header "Messages" ---- +assert fake._mhdr.objectName() == "msgHeader" +mh = fake._mhdr.layout() +assert mh.count() == 4, mh.count() +assert mh.itemAt(0).widget() is fake.msgs_icon +assert mh.itemAt(1).widget() is fake.msgs_title +assert mh.itemAt(2).widget() is None # addStretch(1) - khong phai widget +assert mh.itemAt(3).widget() is fake.chat_toggle_btn +assert mh.contentsMargins().left() == 6 and mh.contentsMargins().top() == 3 +assert mh.spacing() == 6 +assert fake.msgs_title.text() == tr("co4e.messages"), fake.msgs_title.text() +assert fake.msgs_title.objectName() == "hint" +assert fake.msgs_icon.pixmap().width() == 14 and fake.msgs_icon.pixmap().height() == 14 +assert fake.chat_toggle_btn.objectName() == "msgToggle" +assert fake.chat_toggle_btn.isFlat() is True +assert fake.chat_toggle_btn.width() == 22 and fake.chat_toggle_btn.height() == 22 +assert fake.chat_toggle_btn.toolTip() == tr("co4e.tt_expand_msgs"), fake.chat_toggle_btn.toolTip() +print("CASE_BUILD_CHAT_HEADER_OK") + +# ---- chat_stack + flow_logs ---- +assert fake.chat_stack.count() == 0 +assert fake._flow_logs == {} +assert fake.chat_stack.isHidden() is True # mac dinh COLLAPSED +print("CASE_BUILD_CHAT_STACK_OK") + +# ---- composer (chat_input_row) ---- +crow = fake.chat_input_row.layout() +assert crow.count() == 2, crow.count() +assert crow.itemAt(0).widget() is fake._usage_total_lbl +assert crow.contentsMargins().top() == 4 and crow.spacing() == 3 +assert fake._usage_total_lbl.text() == "" +assert fake._usage_total_lbl.objectName() == "hint" +inp_widget = crow.itemAt(1).widget() +row = inp_widget.layout() +assert row.contentsMargins().left() == 0 +assert row.count() == 3, row.count() +assert row.itemAt(0).widget() is fake.chat_input +assert row.stretch(0) == 1 +assert row.itemAt(1).widget() is fake.co4e_routing_toggle +assert row.stretch(1) == 0 +assert row.itemAt(2).widget() is fake.chat_send_btn +assert type(fake.chat_input).__name__ == "_ChatInput" +assert fake.chat_input.placeholderText() == tr("co4e.chat_placeholder"), fake.chat_input.placeholderText() +assert fake.chat_send_btn.text() == tr("co4e.send"), fake.chat_send_btn.text() +assert type(fake.co4e_routing_toggle).__name__ == "RoutingToggle" +assert fake.co4e_routing_toggle.surface == "co4e" +assert fake._co4e_routed_provider is None +assert fake.chat_input_row.isHidden() is True # mac dinh COLLAPSED +print("CASE_BUILD_CHAT_COMPOSER_OK") + +# ---- 1073/1075: submit/click cua composer noi thang toi _chat_send ---- +fake.chat_send_btn.click() +assert calls == ["send"], calls +calls.clear() +fake.chat_input.submit.emit() +assert calls == ["send"], calls +calls.clear() +print("CASE_COMPOSER_WIRES_TO_CHAT_SEND_OK") + +# ---- 1047: chat_toggle_btn.clicked noi thang toi _toggle_messages ---- +fake.chat_toggle_btn.click() +assert calls == ["toggle"], calls +calls.clear() +print("CASE_TOGGLE_BTN_WIRES_TO_TOGGLE_MESSAGES_OK") + +# ---- trang thai mac dinh COLLAPSED sau khi _build_chat tra ve ---- +assert fake._vsplit_sizes == [540, 220], fake._vsplit_sizes +assert fake._msgs_collapsed is True +assert w.maximumHeight() == fake._mhdr.sizeHint().height() + 6, ( + w.maximumHeight(), fake._mhdr.sizeHint().height()) +print("CASE_BUILD_CHAT_DEFAULT_COLLAPSED_STATE_OK") + +print("ALL_OK") +""" + + +def _run_isolated(sandbox: Path) -> subprocess.CompletedProcess: + env = dict(os.environ) + env["HOME"] = str(sandbox) + env["USERPROFILE"] = str(sandbox) + env["QT_QPA_PLATFORM"] = "offscreen" + env["PYTHONIOENCODING"] = "utf-8" + env.pop("HOMEDRIVE", None) + env.pop("HOMEPATH", None) + + script = _SCRIPT.replace("REPO_PARENT_PLACEHOLDER", repr(str(REPO_PARENT))) + return subprocess.run( + [sys.executable, "-c", script, str(sandbox)], + cwd=str(REPO_ROOT), + env=env, + capture_output=True, + text=True, + timeout=60, + ) + + +def test_co4e_chat_view_hanh_vi_hien_tai(tmp_path): + sandbox = tmp_path / "home" + sandbox.mkdir() + + result = _run_isolated(sandbox) + + assert result.returncode == 0, ( + f"characterization script that bai (exit {result.returncode}):\n" + f"--- stdout ---\n{result.stdout}\n--- stderr ---\n{result.stderr}" + ) + for marker in ( + "CASE_DIRECTIVE_TOKEN_OK", + "CASE_EMPTY_DISK_NAMES_OK", + "CASE_AGENT_NAME_DEDUP_QUIRK_OK", + "CASE_SKILL_NAMES_AFTER_CREATE_OK", + "CASE_CHATINPUT_CTOR_OK", + "CASE_SKILL_POPUP_SLUGIFIED_OK", + "CASE_AGENT_POPUP_NOT_SLUGIFIED_QUIRK_OK", + "CASE_TWO_CHAR_PREFIX_TRIGGERS_FULL_LIST_QUIRK_OK", + "CASE_NO_MATCH_HIDES_POPUP_OK", + "CASE_NON_DIRECTIVE_HIDES_POPUP_OK", + "CASE_ACCEPT_REPLACES_TOKEN_OK", + "CASE_ACCEPT_NOOP_WHEN_NO_ITEM_QUIRK_OK", + "CASE_ENTER_SUBMITS_WHEN_POPUP_HIDDEN_OK", + "CASE_ENTER_ACCEPTS_INSTEAD_OF_SUBMIT_WHEN_POPUP_VISIBLE_QUIRK_OK", + "CASE_UP_DOWN_WRAP_AROUND_QUIRK_OK", + "CASE_ESCAPE_HIDES_POPUP_OK", + "CASE_TAB_ACCEPTS_OK", + "CASE_BUILD_CHAT_TOP_LAYOUT_OK", + "CASE_BUILD_CHAT_HEADER_OK", + "CASE_BUILD_CHAT_STACK_OK", + "CASE_BUILD_CHAT_COMPOSER_OK", + "CASE_COMPOSER_WIRES_TO_CHAT_SEND_OK", + "CASE_TOGGLE_BTN_WIRES_TO_TOGGLE_MESSAGES_OK", + "CASE_BUILD_CHAT_DEFAULT_COLLAPSED_STATE_OK", + "ALL_OK", + ): + assert marker in result.stdout, f"thieu marker {marker}\n{result.stdout}" + + # Sandbox chi duoc dung boi cac file skill/agent test tu tao xuong + # SKILLS_DIR/AGENTS_DIR (khong co du lieu nguoi dung that nao bi cham vao) - + # CONFIG_DIR nam trong sandbox nhu da assert ngay dau script. + assert (sandbox / ".cowork_local").exists() diff --git a/tests/characterization/test_co4e_run_manager_behavior.py b/tests/characterization/test_co4e_run_manager_behavior.py new file mode 100644 index 0000000..e85129f --- /dev/null +++ b/tests/characterization/test_co4e_run_manager_behavior.py @@ -0,0 +1,464 @@ +"""Characterization test cho lớp CŨ ``core/co4e_run_manager.py`` +(``Co4ERunManager`` + ``RunHandle``) — hook ``_on_event``/``_on_finished``/ +``_on_failed`` và round-trip ``RunHandle.to_record``/``RunHandle.from_record``. + +VÒNG ĐỜI: đây là giàn giáo (scaffolding), không phải công trình cuối cùng. +Mục đích DUY NHẤT là làm lưới an toàn cho đợt tách ``Co4ERunManager`` thành +``domain/workflows/run_record.py::RunRecord`` (DTO thuần) + +``application/workflows/co4e_workflow_service.py::Co4EWorkflowService`` +(hành vi + lifecycle + lưu đĩa) — xem ``tests/test_co4e_workflow_service.py``, +nơi lớp MỚI được bọc lại bằng test đặc tả tử tế, và nơi có +``test_new_service_produces_same_json_record_as_old_manager`` chạy CÙNG một +chuỗi thao tác trên cả hai lớp rồi so JSON ghi ra đĩa — bằng chứng "hành vi +không lệch" chạy được. File NÀY chỉ ghi lại hành vi của lớp CŨ, KHÔNG được sửa +lớp cũ để "cho khớp" test — nếu một assert dưới đây đỏ mà code cũ trông "sai", +sửa assert, không sửa ``core/co4e_run_manager.py``. Sau khi đợt tách hoàn tất +và ``core/co4e_run_manager.py`` bị xoá/deprecate hẳn, file này hết nhiệm vụ và +nên được xoá theo (không viết lại thành spec — spec test đã có sẵn ở +``tests/test_co4e_workflow_service.py``). + +CÁCH CHỐT ASSERT: mọi giá trị dưới đây được lấy bằng cách CHẠY code thật qua +``.venv/Scripts/python.exe -c "..."`` rồi dán nguyên kết quả in được vào +assert (đúng quy trình ngược yêu cầu), không suy luận lý thuyết. + +AN TOÀN DỮ LIỆU (BẮT BUỘC — lý do có 2 lớp phòng thủ dưới đây): + 1. ``Co4ERunManager.__init__`` gọi ``_load_history()`` đọc + ``~/.cowork_local/co4e/run_history.json`` THẬT (``CONFIG_DIR`` là + ``Path.home() / ".cowork_local"``, hằng số module tính MỘT LẦN lúc + ``cowork_local.config`` được import), rồi mọi ``changed.emit()`` (từ mọi + hook mà test này gọi) kéo theo ``_save_history()`` ghi ĐÈ file đó. Vì + vậy, TRƯỚC khi import bất kỳ thứ gì thuộc ``cowork_local``, module này tự + dựng một HOME giả (``_isolate_home()``, cùng kỹ thuật + ``tools/capture_screens.py::_isolate_home()``: đặt ``USERPROFILE``/ + ``HOME`` trỏ vào một thư mục tạm, xoá ``HOMEDRIVE``/``HOMEPATH``) rồi mới + import ``cowork_local.config``/``cowork_local.core.co4e_run_manager`` — + một assert ngay sau import chốt rằng ``CONFIG_DIR`` thật sự nằm trong + sandbox đó (kiểu ``tools/check_co4e.py:47``). + 2. Phòng thủ thứ hai, độc lập với (1): mỗi test còn monkeypatch + ``Co4ERunManager._history_path`` trỏ về một file trong ``tmp_path`` CỦA + RIÊNG NÓ. Lý do cần thêm lớp này dù đã có (1): nếu file test này được + chạy CÙNG bộ với các file khác đã import ``cowork_local.config`` với HOME + thật trước đó (thứ tự collect của pytest), hằng số module ``CONFIG_DIR``/ + ``CO4E_DIR`` đã bị đóng băng theo HOME thật mất rồi — xem đúng cái bẫy + này được ghi lại trong docstring đầu + ``tests/characterization/test_co4e_skills_panel.py``. Vá thẳng + ``_history_path`` (đọc lại lúc GỌI, không đọc lúc import) không phụ + thuộc thời điểm import nên luôn đúng bất kể thứ tự collect. + +KHÔNG gọi ``Co4ERunManager.start()`` (spawn ``AgentWorker``/``QThread`` thật, +gọi provider AI thật, tốn tiền, ghi file thật). Mọi test dưới đây seed thẳng +vào ``manager._runs[...]`` bằng ``RunHandle`` rồi gọi ``_on_event``/ +``_on_finished``/``_on_failed`` trực tiếp — đúng route hook thật mà +``start()`` nối qua ``worker.event.connect(...)`` v.v., chỉ bỏ qua phần +spawn/chạy job. + +KHÔNG CẦN QApplication: ``Co4ERunManager``/``RunHandle`` chỉ dùng +``QObject``+``Signal`` đồng luồng (kết nối rồi ``emit()`` ngay trong test, +không dựng widget, không đọc kích thước, không cần app instance). + +QUIRK ĐÃ ĐÓNG ĐINH (xem case tương ứng bên dưới — ĐỪNG "dọn" các chỗ này khi +tách, chúng trông như bug nhưng là hành vi đang chạy thật hôm nay): + * ``event = Signal(str, dict)`` khai báo kiểu cứng cho tham số thứ hai. Khi + ``_on_event(run_id, ev)`` được gọi với ``ev=None`` và ``run_id`` KHÔNG có + trong ``_runs`` (nên nhánh xử lý dict bị bỏ qua, đi thẳng xuống + ``self.event.emit(run_id, ev)``), Qt/Shiboken ép kiểu ``None`` thành + ``dict`` RỖNG (``{}``) ngay tại điểm ``emit`` — listener nhận được + ``{}`` chứ KHÔNG PHẢI ``None``. (Shiboken có in một dòng cảnh báo + "Cannot copy-convert ... (NoneType) to C++" ra stderr, nhưng KHÔNG ném + lỗi.) Đây là khác biệt cố ý với lớp MỚI + (``Co4EWorkflowService``/``domain/workflows/run_record.py``), nơi không + còn ``Signal`` nữa nên callback nhận đúng ``None`` gốc — xem + ``tests/test_co4e_workflow_service.py::test_on_event_none_payload_does_not_raise_and_reemits_none``. + * Khi ``ev["type"] == "run_done"`` mà ``handle.status`` KHÔNG phải + ``"running"`` (ví dụ đã ``"stopped"``), nhánh ``if handle.status == + "running":`` không đổi ``status``, nhưng ``self.changed.emit()`` vẫn được + gọi VÔ ĐIỀU KIỆN ngay sau đó (nằm ngoài ``if``) — run "đã xong" vẫn kích + một lần refresh + một lần ghi lịch sử xuống đĩa, dù không có gì thay đổi + trên ``handle`` đó. + * ``RunHandle.to_record()``/``from_record()`` đổi trường ``wf`` qua lại + thành ĐỐI TƯỢNG ``Workflow`` thật (``workflow_to_dict``/ + ``workflow_from_dict`` từ ``core/co4e.py``) — khác hẳn ``RunRecord`` mới + (``domain/workflows/run_record.py``), nơi ``wf`` CỐ Ý được giữ nguyên là + dict thô vì domain không được phép import ``core.co4e.Workflow``. Đây là + một khác biệt thiết kế có chủ đích giữa bản cũ và bản mới, không phải lỗi + port thiếu. + * Round-trip KHÔNG đối xứng: ``status == "running"`` đọc lại từ + ``from_record()`` bị chốt thành ``"stopped"`` (worker của nó đã mất theo + khi app tắt giữa run), nhưng ``to_record()`` vẫn ghi đúng "running" xuống + đĩa tại thời điểm lưu. ``from_record({})``/``from_record(None)`` mặc định + ``status="done"`` (không phải "running") nên KHÔNG rơi vào nhánh đổi + thành "stopped". + * ``total`` âm bị ``max(0, total)`` kẹp về 0 ngay lúc khởi tạo + ``RunHandle``, không giữ nguyên giá trị âm. +""" +from __future__ import annotations + +import os +import tempfile +from pathlib import Path + + +def _isolate_home() -> Path: + """Trỏ USERPROFILE/HOME sang một thư mục tạm TRƯỚC khi import + ``cowork_local`` — cùng kỹ thuật ``tools/capture_screens.py::_isolate_home()``. + Không có dữ liệu thật nào được sao chép vào đây (khác capture_screens): + test này không cần đọc lịch sử run thật, chỉ cần KHÔNG BAO GIỜ chạm vào nó. + """ + sandbox = Path(tempfile.mkdtemp(prefix="co4e-run-manager-test-home-")) + (sandbox / ".cowork_local").mkdir(parents=True, exist_ok=True) + for var in ("USERPROFILE", "HOME"): + os.environ[var] = str(sandbox) + os.environ.pop("HOMEDRIVE", None) + os.environ.pop("HOMEPATH", None) + return sandbox + + +_SANDBOX_HOME = _isolate_home() + +import pytest # noqa: E402 + +from cowork_local.config import CONFIG_DIR # noqa: E402 +from cowork_local.core.co4e import Node, Step, Workflow # noqa: E402 +from cowork_local.core.co4e_run_manager import Co4ERunManager, RunHandle # noqa: E402 + +# GIỚI HẠN ĐÃ BIẾT (không phải lỗ hổng an toàn dữ liệu — xem lớp phòng thủ #2 +# ở docstring đầu file, mọi test dưới đây đều tự vá ``_history_path`` bất kể +# kết quả kiểm tra này): ``CONFIG_DIR`` là hằng số module tính MỘT LẦN lúc +# ``cowork_local.config`` được import. Khi chạy CHỈ file này (đúng lệnh VERIFY +# ở đầu task), ``_isolate_home()`` ở trên chạy trước import đầu tiên nên chốt +# đúng. Khi chạy CẢ BỘ, một file khác được pytest collect trước có thể đã +# import ``cowork_local.config`` với HOME thật rồi — ``CONFIG_DIR`` khi đó đã +# đóng băng theo giá trị thật, không cách nào isolate lại được nữa từ file này +# (cùng giới hạn được ghi trong docstring đầu +# ``tests/characterization/test_co4e_skills_panel.py``). Vì vậy test dưới đây +# CHỦ ĐỘNG bỏ qua (không fail cả file, không làm mất 30 test còn lại) khi phát +# hiện giới hạn này, thay vì assert cứng ở cấp module (từng thử — gây lỗi +# collection cho TOÀN BỘ file khi chạy chung với các file khác đã import +# ``cowork_local.config`` trước). +def test_home_isolation_pins_config_dir_into_sandbox_when_first_to_import(): + if str(_SANDBOX_HOME) not in str(CONFIG_DIR): + pytest.skip( + "cowork_local.config da bi mot file test khac import voi HOME " + "that TRUOC file nay trong cung phien pytest (thu tu collect) -- " + f"CONFIG_DIR={CONFIG_DIR!r} khong con nam trong sandbox cua file " + "nay. Day la gioi han da biet (xem docstring dau file), KHONG " + "phai mat an toan du lieu: moi test hook trong file nay tu va " + "thang Co4ERunManager._history_path (doc lap voi CONFIG_DIR) nen " + "khong test nao trong file thuc su cham vao lich su run that." + ) + assert str(_SANDBOX_HOME) in str(CONFIG_DIR) + + +class _Ctx: + """Stub ``ctx``: không hook/round-trip nào trong file này đụng tới + ``ctx.config`` (chỉ ``start()``/``_out_dir()`` — không thuộc phạm vi bọc + của file này — mới cần nó thật).""" + + +@pytest.fixture +def manager(tmp_path, monkeypatch): + # Lớp phòng thủ thứ hai (xem docstring đầu file): mỗi test có lịch sử + # riêng trong tmp_path của chính nó, độc lập với CONFIG_DIR. + history_path = tmp_path / "run_history.json" + monkeypatch.setattr(Co4ERunManager, "_history_path", lambda self: history_path) + return Co4ERunManager(_Ctx()) + + +def _seed(manager: Co4ERunManager, run_id: str, **kw) -> RunHandle: + defaults = dict(wf_id="wf1", name="Flow", total=3, plan_mode=False, manual=False) + defaults.update(kw) + h = RunHandle(run_id, **defaults) + manager._runs[run_id] = h + return h + + +def _make_workflow(node_count: int = 1, wf_id: str = "wf-x", name: str = "Flow X") -> Workflow: + nodes = [Node(id=f"n{i}", x=0.0, y=0.0, data=Step(label=f"Step{i}")) for i in range(1, node_count + 1)] + return Workflow(id=wf_id, name=name, nodes=nodes, edges=[]) + + +# --------------------------------------------------------------------------- +# RunHandle: gia tri mac dinh / kep bien +# --------------------------------------------------------------------------- + +def test_run_handle_defaults_on_construction(): + h = RunHandle("run1", "wf1", "My Flow", 3, False, False) + assert h.status == "running" + assert h.done == 0 + assert h.progress_text() == "0/3" + assert h.running is True + + +def test_run_handle_negative_total_clamped_to_zero(): + h = RunHandle("run2", "wf2", "Flow2", -5, False, False) + assert h.total == 0 + + +def test_run_handle_zero_total_progress_text_falls_back_to_status(): + h = RunHandle("run3", "wf3", "Flow3", 0, False, False) + assert h.progress_text() == "running" + + +# --------------------------------------------------------------------------- +# to_record / from_record +# --------------------------------------------------------------------------- + +def test_to_record_contains_expected_keys_and_values(): + h = RunHandle("run1", "wf1", "My Flow", 3, False, False, + created_by="alice", created_at="2026-08-23 10:00", project_id="p1") + rec = h.to_record() + assert sorted(rec.keys()) == [ + "created_at", "created_by", "done", "error", "id", "manual", "name", + "node_status", "out_dir", "plan_mode", "project_id", "status", "total", + "wf", "wf_id", + ] + assert rec["id"] == "run1" + assert rec["status"] == "running" + assert rec["wf"] is None + + +def test_round_trip_status_running_becomes_stopped(): + h = RunHandle("run1", "wf1", "My Flow", 3, False, False) + rec = h.to_record() + assert rec["status"] == "running" # to_record ghi dung "running" + back = RunHandle.from_record(rec) + assert back.status == "stopped" # nhung from_record chot lai thanh "stopped" + + +@pytest.mark.parametrize("status", ["done", "error", "stopped"]) +def test_round_trip_non_running_statuses_are_preserved(status): + h = RunHandle("run1", "wf1", "My Flow", 3, False, False) + h.status = status + back = RunHandle.from_record(h.to_record()) + assert back.status == status + + +def test_from_record_empty_dict_uses_documented_defaults(): + h = RunHandle.from_record({}) + assert h.id == "" + assert h.status == "done" # quirk: khong roi vao nhanh doi thanh "stopped" + assert h.wf is None + assert h.node_status == {} + + +def test_from_record_none_treated_same_as_empty_dict(): + assert RunHandle.from_record(None).id == RunHandle.from_record({}).id + assert RunHandle.from_record(None).status == RunHandle.from_record({}).status + + +def test_round_trip_workflow_snapshot_becomes_real_workflow_object(): + # quirk: khac RunRecord moi (giu wf la dict tho), RunHandle CU doi wf qua + # lai thanh doi tuong Workflow that qua workflow_to_dict/workflow_from_dict. + h = RunHandle("run4", "wf-x", "Flow X run", 1, False, False) + h.wf = _make_workflow() + rec = h.to_record() + assert isinstance(rec["wf"], dict) # tren dia luon la dict (JSON-able) + assert rec["wf"]["id"] == "wf-x" + assert rec["wf"]["name"] == "Flow X" + + back = RunHandle.from_record(rec) + assert isinstance(back.wf, Workflow) # nhung doc lai thanh doi tuong that + assert back.wf.id == "wf-x" + assert back.wf.name == "Flow X" + assert len(back.wf.nodes) == 1 + assert back.wf.nodes[0].id == "n1" + + +# --------------------------------------------------------------------------- +# _on_event +# --------------------------------------------------------------------------- + +def test_on_event_node_status_done_increments_progress_and_emits_changed(manager): + h = _seed(manager, "run1") + changed = [] + manager.changed.connect(lambda: changed.append(1)) + manager._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "done"}) + assert h.node_status == {"n1": "done"} + assert h.done == 1 + assert len(changed) == 1 + + +def test_on_event_node_status_planned_counts_as_terminal_too(manager): + h = _seed(manager, "run1") + manager._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "planned"}) + assert h.done == 1 + + +def test_on_event_node_status_running_is_not_terminal(manager): + h = _seed(manager, "run1") + manager._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "running"}) + assert h.done == 0 + + +def test_on_event_node_status_missing_keys_stores_none_key(manager): + h = _seed(manager, "run1") + manager._on_event("run1", {"type": "node_status"}) + assert h.node_status == {None: None} + + +def test_on_event_run_done_default_ok_marks_done(manager): + h = _seed(manager, "run1") + manager._on_event("run1", {"type": "run_done"}) + assert h.status == "done" + + +def test_on_event_run_done_ok_false_marks_error(manager): + h = _seed(manager, "run1") + manager._on_event("run1", {"type": "run_done", "ok": False}) + assert h.status == "error" + + +def test_on_event_run_done_when_not_running_leaves_status_but_still_emits_changed(manager): + # quirk (xem docstring dau file): "if status == running" khong doi status, + # nhung changed.emit() nam NGOAI if nen van chay du khong co gi doi tren + # handle nay. + h = _seed(manager, "run1") + h.status = "stopped" + changed = [] + manager.changed.connect(lambda: changed.append(1)) + manager._on_event("run1", {"type": "run_done", "ok": False}) + assert h.status == "stopped" + assert len(changed) == 1 + + +def test_on_event_unknown_run_id_does_not_raise_and_still_reemits_event(manager): + received = [] + manager.event.connect(lambda rid, ev: received.append((rid, ev))) + manager._on_event("no-such-run", {"type": "node_status", "node_id": "n1", "status": "done"}) + assert received == [("no-such-run", {"type": "node_status", "node_id": "n1", "status": "done"})] + + +def test_on_event_none_payload_on_unknown_run_id_is_coerced_to_empty_dict_by_qt(manager): + # quirk (xem docstring dau file): event = Signal(str, dict) ep None thanh + # {} ngay tai diem emit -- khac han lop MOI (khong con Signal) nhan dung + # None goc. Day la khac biet CO CHU Y giua ban cu va ban moi, khong phai + # bug can sua. + received = [] + manager.event.connect(lambda rid, ev: received.append((rid, ev))) + manager._on_event("no-such-run", None) + assert received == [("no-such-run", {})] + + +def test_on_event_none_payload_on_known_run_id_does_not_mutate_handle(manager): + h = _seed(manager, "run1") + received = [] + manager.event.connect(lambda rid, ev: received.append((rid, ev))) + manager._on_event("run1", None) + assert h.status == "running" + assert h.node_status == {} + assert received == [("run1", {})] # cung bi Qt ep thanh {} nhu tren + + +# --------------------------------------------------------------------------- +# _on_finished +# --------------------------------------------------------------------------- + +def test_on_finished_while_running_settles_to_done(manager): + h = _seed(manager, "run1") + changed = [] + manager.changed.connect(lambda: changed.append(1)) + manager._on_finished("run1") + assert h.status == "done" + assert len(changed) == 1 + + +def test_on_finished_when_already_settled_is_a_noop(manager): + h = _seed(manager, "run1") + h.status = "error" + changed = [] + manager.changed.connect(lambda: changed.append(1)) + manager._on_finished("run1") + assert h.status == "error" + assert len(changed) == 0 + + +def test_on_finished_unknown_run_id_is_a_total_noop(manager): + changed = [] + manager.changed.connect(lambda: changed.append(1)) + manager._on_finished("no-such-run") + assert manager._runs == {} + assert changed == [] + + +# --------------------------------------------------------------------------- +# _on_failed +# --------------------------------------------------------------------------- + +def test_on_failed_marks_error_with_message_and_emits_run_error_event(manager): + h = _seed(manager, "run1") + events = [] + changed = [] + manager.event.connect(lambda rid, ev: events.append((rid, ev))) + manager.changed.connect(lambda: changed.append(1)) + manager._on_failed("run1", "boom") + assert h.status == "error" + assert h.error == "boom" + assert events == [("run1", {"type": "run_error", "error": "boom"})] + assert len(changed) == 1 + + +def test_on_failed_overrides_status_even_when_already_settled(manager): + h = _seed(manager, "run1") + h.status = "done" + manager._on_failed("run1", "late failure") + assert h.status == "error" + + +def test_on_failed_unknown_run_id_is_a_total_noop(manager): + events = [] + changed = [] + manager.event.connect(lambda rid, ev: events.append((rid, ev))) + manager.changed.connect(lambda: changed.append(1)) + manager._on_failed("no-such-run", "err") + assert events == [] + assert changed == [] + + +# --------------------------------------------------------------------------- +# persistence: hook -> dia THAT (trong sandbox cua rieng tung test) -> reload +# --------------------------------------------------------------------------- + +def test_changed_hook_persists_to_history_file(manager, tmp_path): + _seed(manager, "run1") + manager._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "done"}) + path = tmp_path / "run_history.json" + assert path.exists() + import json + data = json.loads(path.read_text(encoding="utf-8")) + assert len(data["runs"]) == 1 + assert data["runs"][0]["id"] == "run1" + assert data["runs"][0]["status"] == "running" + + +def test_reloading_manager_after_hook_settles_running_to_stopped(tmp_path, monkeypatch): + history_path = tmp_path / "run_history.json" + monkeypatch.setattr(Co4ERunManager, "_history_path", lambda self: history_path) + + mgr1 = Co4ERunManager(_Ctx()) + _seed(mgr1, "run1") + mgr1._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "done"}) + + mgr2 = Co4ERunManager(_Ctx()) + assert "run1" in mgr2._runs + assert mgr2._runs["run1"].status == "stopped" + assert mgr2._seq == 1 + + +def test_reloaded_seq_avoids_colliding_with_history_ids(tmp_path, monkeypatch): + history_path = tmp_path / "run_history.json" + monkeypatch.setattr(Co4ERunManager, "_history_path", lambda self: history_path) + + mgr1 = Co4ERunManager(_Ctx()) + _seed(mgr1, "run7") + mgr1._on_event("run7", {"type": "node_status", "node_id": "n1", "status": "done"}) + + mgr2 = Co4ERunManager(_Ctx()) + assert mgr2._seq == 7 + assert mgr2._next_id() == "run8" + + +def test_load_history_missing_file_is_silent_noop(tmp_path, monkeypatch): + monkeypatch.setattr(Co4ERunManager, "_history_path", lambda self: tmp_path / "does-not-exist.json") + mgr = Co4ERunManager(_Ctx()) + assert mgr._runs == {} + assert mgr._seq == 0 diff --git a/tests/characterization/test_co4e_runs_page.py b/tests/characterization/test_co4e_runs_page.py new file mode 100644 index 0000000..7b832d3 --- /dev/null +++ b/tests/characterization/test_co4e_runs_page.py @@ -0,0 +1,524 @@ +"""Characterization test cho phần DỰNG WIDGET của trang "Runs" trong Co4E +(``ui/co4e_tab.py``, method ``_build_runs_page``, dòng 869-928). + +VÒNG ĐỜI: đây là giàn giáo (scaffolding), KHÔNG phải đặc tả cuối cùng. Mục +đích DUY NHẤT là lưới an toàn cho đợt tách "Run Control" sắp tới (xem +``docs/architecture/co4e-split-map-run-control.md`` — dự kiến ``_build_runs_page`` +sẽ dời sang ``presentation/co4e/co4e_run_control_widget.py``). Sau khi việc +tách hoàn tất và ổn định, các test ở đây nên được viết lại thành test đặc tả +(specification test) cho widget/API mới; quirk nào liệt kê dưới đây nên có +issue riêng nếu ai đó muốn "dọn" chúng — ĐỪNG tự sửa code sản phẩm để "dọn" +quirk khi đọc thấy test này. + +PHẠM VI: CHỈ ``_build_runs_page`` — phần dựng ``QWidget``/``runs_table`` (5 +cột) + 7 widget con (``runs_back_btn``, ``runs_title``, ``ws_folder_btn``, +``run_stop_btn``, ``run_rename_btn``, ``run_del_btn``, ``run_clear_btn``) và +việc NỐI (connect) các signal của chúng tới các method xử lý. CÁC METHOD XỬ LÝ +(``_refresh_runs``, ``_stop_selected_run``, ``_delete_selected_run``, +``_runs_context_menu``, ``_rename_selected_run``, ``_open_run_from_table``, +``_open_workspace_folder``, ``_refresh_ws_folder_btn``) VẪN Ở NGUYÊN trên +``Co4ETab`` và KHÔNG được characterize ở đây (đề bài giao đúng phạm vi +constructor cho lượt này) — test này chỉ xác nhận rằng bấm nút/emit signal +tương ứng CÓ gọi tới đúng method trên ``self`` (qua fake/stub), không xác +nhận method đó làm gì bên trong. + +CÁCH DỰNG: ``_build_runs_page`` là instance method cần rất nhiều state của +``Co4ETab`` thật (``self.ctx``, ``self.manager``, hàng chục method khác) để +dựng trọn vẹn — dựng cả ``Co4ETab`` chỉ để test 60 dòng constructor này là +tốn kém và kéo theo rủi ro chạm những phần KHÔNG thuộc phạm vi. Nên ở đây +gọi thẳng ``Co4ETab._build_runs_page(fake_self)`` (unbound, theo đúng gợi ý +của đề bài) trên một ``_FakeTab`` tối giản: chỉ có ``ctx``/``_project_dir``/ +``manager`` (để ``_flow_output_root``/``_refresh_ws_folder_btn`` — hai +method DÙNG THẬT của ``Co4ETab``, được gọi ngay TRONG lúc dựng ở dòng 893 — +chạy được) và các method xử lý còn lại được thay bằng stub ghi lại số lần gọi +(KHÔNG gọi ``Co4ERunManager.start()``/dựng ``QThread``/``AgentWorker`` thật — +đúng ràng buộc "không spawn thread/gọi provider thật"). + +AN TOÀN DỮ LIỆU: dù bước dựng widget này tự nó KHÔNG chạm đĩa, việc gọi +``_flow_output_root()``/``_refresh_ws_folder_btn()`` NGAY trong lúc dựng lại +tính ``CONFIG_DIR`` (qua ``cowork_local.config.CONFIG_DIR = Path.home() / +".cowork_local"``, xuyên qua ``core.co4e.CO4E_DIR``) — nên toàn bộ probe chạy +trong TIẾN TRÌNH CON riêng (tránh xung đột ``QApplication`` singleton với các +test khác trong cùng lượt chạy pytest) với ``HOME``/``USERPROFILE`` trỏ vào +một ``tmp_path`` sandbox ĐẶT TRƯỚC khi script import bất kỳ thứ gì thuộc +``cowork_local`` (đúng kỹ thuật ``tools/capture_screens.py::_isolate_home()``: +đặt ``USERPROFILE``/``HOME``, xoá ``HOMEDRIVE``/``HOMEPATH``), và +``QT_QPA_PLATFORM=offscreen`` được đặt TRƯỚC khi import PySide6 (đúng khuôn +``tools/check_co4e.py`` dòng 22+40-42). Một assert ngay trong tiến trình con +chốt ``CONFIG_DIR`` nằm trong sandbox trước khi làm gì khác (kiểu +``tools/check_co4e.py:47``). + +CẦN QApplication: ``_build_runs_page`` dựng ``QWidget``/``QTableWidget`` thật, +đọc ``.text()``/``.toolTip()``/``.icon()``/``.cursor()`` và bấm nút thật qua +``.click()`` — không phải kiểu giá trị thuần, nên bắt buộc ``QApplication`` +(``offscreen``), khác các test hình học thuần (``test_co4e_canvas_geometry.py``). + +CÁCH CHỐT ASSERT: mọi giá trị dưới đây lấy bằng cách CHẠY code thật (script +``_PROBE_SCRIPT`` bên dưới, qua ``.venv/Scripts/python.exe``, giống hệt lệnh ở +cuối file) rồi dán NGUYÊN VĂN JSON in được vào assert — không suy luận lý +thuyết. Các chuỗi hiển thị phụ thuộc ``tr()`` (tiếng Việt mặc định) được so +sánh bằng cách gọi LẠI ``tr()`` thật ngay trong tiến trình test (không cần +QApplication, ``i18n.py`` là tra bảng thuần) thay vì chép tay chuỗi có dấu — +tránh gõ nhầm ký tự Unicode khi transcribe. + +QUIRK ĐÃ ĐÓNG ĐINH (xem case tương ứng bên dưới — ĐỪNG "dọn" các chỗ này khi +tách, chúng trông như bất đối xứng khó hiểu nhưng là hành vi đang chạy thật +hôm nay): + * ``run_clear_btn`` là nút DUY NHẤT trong 5 nút hàng thao tác KHÔNG có + ``setIcon(...)`` — icon của nó luôn rỗng (``.icon().isNull() is True``), + khác hẳn ``run_stop_btn``/``run_rename_btn``/``run_del_btn``/ + ``ws_folder_btn`` đều có icon SVG built-in. + * ``run_clear_btn.clicked`` nối THẲNG tới + ``lambda: self.manager.clear_finished()`` — gọi trực tiếp method trên + ``manager``, KHÔNG đi qua một method riêng trên ``self`` như 3 nút hàng + xóm (``_stop_selected_run``/``_rename_selected_run``/ + ``_delete_selected_run``) — không có lớp bọc nào để thêm xác nhận + (confirm dialog) sau này mà không sửa trực tiếp dòng connect này. + * ``ws_folder_btn`` text được dựng bằng ``"…/" + "/".join(parts[-2:])`` + (đúng 3 ký tự: dấu chấm lửng Unicode U+2026 rồi dấu gạch chéo xuôi) khi + đường dẫn có hơn 2 phần — dùng ``"/"`` LUÔN LUÔN, kể cả trên Windows + (khác separator ``\\`` của phần còn lại của path), và không có fallback + hiển thị full path trừ khi ``len(parts) <= 2``. + * ``_flow_output_root()`` (được ``_refresh_ws_folder_btn()`` gọi NGAY + trong lúc dựng, dòng 893) bọc ``ctx.config.cowork_output_dir()`` trong + ``except Exception`` RỘNG — bất kỳ lỗi nào từ ``ctx.config`` (kể cả + ``AttributeError`` vì ``ctx`` không có ``.config`` như trong probe này) + đều rơi vào nhánh fallback ``co4e.CO4E_DIR / "runs"`` một cách im lặng, + không log, không báo cho người gọi biết đã fallback. + * ``runs_table`` sau khi dựng xong LUÔN có 0 hàng bất kể ``manager`` đang + có run nào hay không — ``_build_runs_page`` không tự seed dữ liệu, việc + đó thuộc về ``_refresh_runs`` (method riêng, KHÔNG thuộc phạm vi test + này) — ai tách file mà tưởng constructor này "phải" gọi ``_refresh_runs`` + luôn thì sẽ đổi hành vi so với hôm nay. + +Lệnh thủ công đã dùng để chốt các con số trên (quy trình ngược, xem cuối file +để chạy lại nếu cần chốt lại sau khi code đổi có chủ đích). +""" +from __future__ import annotations + +import json +import os +import subprocess +import sys +from pathlib import Path + +import pytest + +REPO_ROOT = Path(__file__).resolve().parent.parent.parent +REPO_PARENT = REPO_ROOT.parent + +_PROBE_SCRIPT = r""" +import json +import os +import sys +from pathlib import Path + +sandbox = sys.argv[1] +repo_parent = sys.argv[2] +sys.path.insert(0, repo_parent) + +os.environ["QT_QPA_PLATFORM"] = "offscreen" +for var in ("USERPROFILE", "HOME"): + os.environ[var] = sandbox +os.environ.pop("HOMEDRIVE", None) +os.environ.pop("HOMEPATH", None) + +from PySide6.QtCore import QPoint, Qt +from PySide6.QtWidgets import ( + QApplication, QHeaderView, QTableWidget, QTableWidgetItem, +) + +app = QApplication([]) + +from cowork_local.config import CONFIG_DIR +assert str(Path(sandbox).resolve()) in str(CONFIG_DIR.resolve()), ( + "khong co lap: CONFIG_DIR=" + str(CONFIG_DIR)) + +from cowork_local.ui.co4e_tab import Co4ETab + +result = {} +calls = {"show_runs": [], "stop": 0, "rename": 0, "delete": 0, "open_run": 0, + "ws_open": 0, "ctx_menu": 0} + + +class _Manager: + # Stand-in cho Co4ERunManager - KHONG dung QThread/AgentWorker that. + + def __init__(self): + self.clear_finished_calls = 0 + + def clear_finished(self): + self.clear_finished_calls += 1 + + +class _Config: + def cowork_output_dir(self): + # co tinh nem loi de _flow_output_root roi vao nhanh fallback + # (quirk duoc dong dinh trong docstring cua file test). + raise RuntimeError("no config in probe") + + +class _Ctx: + def __init__(self): + self.config = _Config() + + +class _FakeTab: + # Chi mang du state de goi duoc Co4ETab._build_runs_page(self) unbound - + # KHONG dung ca Co4ETab that (tranh keo theo sidebar/canvas/config panel + # ngoai pham vi). + + # Hai method NAY la method THAT cua Co4ETab, duoc _build_runs_page goi + # NGAY trong luc dung (dong 893) - phai la ban that, khong stub. + _flow_output_root = Co4ETab._flow_output_root + _refresh_ws_folder_btn = Co4ETab._refresh_ws_folder_btn + _build_runs_page = Co4ETab._build_runs_page + + def __init__(self): + self.ctx = _Ctx() + self._project_dir = None + self.manager = _Manager() + + def _show_runs(self, on): + calls["show_runs"].append(on) + + def _stop_selected_run(self): + calls["stop"] += 1 + + def _rename_selected_run(self): + calls["rename"] += 1 + + def _delete_selected_run(self): + calls["delete"] += 1 + + def _open_run_from_table(self, item): + calls["open_run"] += 1 + + def _open_workspace_folder(self): + calls["ws_open"] += 1 + + def _runs_context_menu(self, pos): + calls["ctx_menu"] += 1 + + +fake = _FakeTab() +w = fake._build_runs_page() + +result["w_type"] = type(w).__name__ +result["layout_type"] = type(w.layout()).__name__ +result["table_is_child_of_w"] = w.findChild(type(fake.runs_table)) is fake.runs_table + +result["col_count"] = fake.runs_table.columnCount() +result["row_count"] = fake.runs_table.rowCount() +result["header_resize_mode_is_stretch"] = ( + fake.runs_table.horizontalHeader().sectionResizeMode(0) == QHeaderView.Stretch +) +result["vheader_visible"] = fake.runs_table.verticalHeader().isVisible() +# isVisible() luon False vi 'w' khong bao gio duoc .show() trong probe nay +# (widget khong nam trong mot top-level dang hien thi that) - dung +# isVisibleTo(ancestor) de bat dung co hidden explicit da duoc setVisible(...) +# dat tren verticalHeader, khong phu thuoc chuoi ancestor co duoc show hay +# khong. Xem PySide6 doc QWidget.isVisibleTo(): tra ve True/False dua tren co +# WA_WState_Hidden explicit cua chinh widget do (va cac ancestor tinh den +# truoc 'ancestor'), bat ke ancestor da .show() hay chua. +result["vheader_visible_to_table"] = ( + fake.runs_table.verticalHeader().isVisibleTo(fake.runs_table) +) +result["edit_triggers_is_no_edit"] = ( + fake.runs_table.editTriggers() == QTableWidget.NoEditTriggers +) +result["selection_behavior_is_select_rows"] = ( + fake.runs_table.selectionBehavior() == QTableWidget.SelectRows +) +result["context_menu_policy_is_custom"] = ( + fake.runs_table.contextMenuPolicy() == Qt.CustomContextMenu +) +result["table_tooltip"] = fake.runs_table.toolTip() + +result["back_btn_text"] = fake.runs_back_btn.text() +result["back_btn_tooltip"] = fake.runs_back_btn.toolTip() +result["back_icon_isnull"] = fake.runs_back_btn.icon().isNull() + +result["title_text"] = fake.runs_title.text() +result["title_object_name"] = fake.runs_title.objectName() + +result["ws_folder_flat"] = fake.ws_folder_btn.isFlat() +result["ws_folder_cursor_is_pointing_hand"] = ( + fake.ws_folder_btn.cursor().shape() == Qt.PointingHandCursor +) +result["ws_folder_text"] = fake.ws_folder_btn.text() +result["ws_folder_tooltip"] = fake.ws_folder_btn.toolTip() +result["ws_folder_icon_isnull"] = fake.ws_folder_btn.icon().isNull() + +result["stop_btn_text"] = fake.run_stop_btn.text() +result["stop_btn_object_name"] = fake.run_stop_btn.objectName() +result["stop_btn_tooltip"] = fake.run_stop_btn.toolTip() +result["stop_btn_icon_isnull"] = fake.run_stop_btn.icon().isNull() + +result["rename_btn_text"] = fake.run_rename_btn.text() +result["rename_btn_tooltip"] = fake.run_rename_btn.toolTip() +result["rename_btn_icon_isnull"] = fake.run_rename_btn.icon().isNull() + +result["del_btn_text"] = fake.run_del_btn.text() +result["del_btn_tooltip"] = fake.run_del_btn.toolTip() +result["del_btn_icon_isnull"] = fake.run_del_btn.icon().isNull() + +result["clear_btn_text"] = fake.run_clear_btn.text() +result["clear_btn_tooltip"] = fake.run_clear_btn.toolTip() +result["clear_btn_object_name"] = fake.run_clear_btn.objectName() +result["clear_btn_icon_isnull"] = fake.run_clear_btn.icon().isNull() + +# --- bam nut / emit signal that -> xac nhan CO goi dung method tren self ---- +fake.runs_back_btn.click() +result["calls_after_back_click"] = list(calls["show_runs"]) + +fake.ws_folder_btn.click() +result["ws_open_calls_after_click"] = calls["ws_open"] + +fake.run_stop_btn.click() +result["stop_calls_after_click"] = calls["stop"] + +fake.run_rename_btn.click() +result["rename_calls_after_click"] = calls["rename"] + +fake.run_del_btn.click() +result["delete_calls_after_click"] = calls["delete"] + +fake.run_clear_btn.click() +result["manager_clear_finished_calls_after_click"] = fake.manager.clear_finished_calls + +item = QTableWidgetItem("row0") +fake.runs_table.setRowCount(1) +fake.runs_table.setItem(0, 0, item) +fake.runs_table.itemDoubleClicked.emit(item) +result["open_run_calls_after_dbl_click"] = calls["open_run"] + +fake.runs_table.customContextMenuRequested.emit(QPoint(5, 5)) +result["ctx_menu_calls_after_signal"] = calls["ctx_menu"] + +result["flow_output_root_fallback"] = str(fake._flow_output_root()) +result["config_dir"] = str(CONFIG_DIR) + +print(json.dumps(result, sort_keys=True, ensure_ascii=True)) +print("PROBE_OK") +""" + + +@pytest.fixture(scope="module") +def probe_result(tmp_path_factory): + """Chạy ``_PROBE_SCRIPT`` một lần cho cả module trong TIẾN TRÌNH CON, trả + về dict JSON đã in được cùng ``sandbox`` đã dùng (để test tính lại các giá + trị phụ thuộc đường dẫn, thay vì chép tay chuỗi tuyệt đối).""" + sandbox = tmp_path_factory.mktemp("co4e-runs-page-home") + + env = dict(os.environ) + env["HOME"] = str(sandbox) + env["USERPROFILE"] = str(sandbox) + env["QT_QPA_PLATFORM"] = "offscreen" + env.pop("HOMEDRIVE", None) + env.pop("HOMEPATH", None) + + result = subprocess.run( + [sys.executable, "-c", _PROBE_SCRIPT, str(sandbox), str(REPO_PARENT)], + cwd=str(REPO_ROOT), + env=env, + capture_output=True, + text=True, + timeout=60, + ) + assert result.returncode == 0, ( + f"probe co4e runs page that bai (exit {result.returncode}):\n" + f"--- stdout ---\n{result.stdout}\n--- stderr ---\n{result.stderr}" + ) + assert "PROBE_OK" in result.stdout, result.stdout + + json_line = result.stdout.strip().splitlines()[-2] + data = json.loads(json_line) + data["_sandbox"] = str(sandbox) + return data + + +# --------------------------------------------------------------------------- +# runs_table: cau truc/co so mac dinh +# --------------------------------------------------------------------------- + +def test_runs_table_has_5_columns_and_starts_empty(probe_result): + assert probe_result["col_count"] == 5 + # quirk: _build_runs_page KHONG tu seed hang nao, du manager co run hay + # khong - seed la viec cua _refresh_runs (ngoai pham vi test nay). + assert probe_result["row_count"] == 0 + + +def test_runs_table_is_parented_into_the_returned_widget(probe_result): + # DA CAP NHAT sau khi tach "Run Control" (xem + # docs/architecture/co4e-split-map-run-control.md): _build_runs_page gio + # tra ve mot RunsPagePanel (subclass QWidget dung trong presentation/co4e/ + # co4e_run_control_widget.py) thay vi mot QWidget tran - van la mot QWidget + # that su (layout/table van nguyen), chi ten class cu the doi. + assert probe_result["w_type"] == "RunsPagePanel" + assert probe_result["layout_type"] == "QVBoxLayout" + assert probe_result["table_is_child_of_w"] is True + + +def test_runs_table_display_settings(probe_result): + assert probe_result["header_resize_mode_is_stretch"] is True + # KHONG dung "vheader_visible" (QWidget.isVisible()) o day: gia tri do + # luon False bat ke setVisible(True/False) trong code san pham, vi + # runs_table/verticalHeader khong bao gio duoc .show() thuc su trong luc + # probe (isVisible() phu thuoc CA chuoi ancestor co dang hien tren man + # hinh hay khong). Dung "vheader_visible_to_table" (isVisibleTo(ancestor)) + # de bat dung co explicit hidden ma setVisible(False) dat len + # verticalHeader, khong phu thuoc runs_table co duoc show hay khong - + # mutation setVisible(False) -> True lam gia tri nay lat tu False len True. + assert probe_result["vheader_visible_to_table"] is False + assert probe_result["edit_triggers_is_no_edit"] is True + assert probe_result["selection_behavior_is_select_rows"] is True + assert probe_result["context_menu_policy_is_custom"] is True + + +def test_runs_table_tooltip_matches_tr_key(probe_result): + from cowork_local.i18n import tr + assert probe_result["table_tooltip"] == tr("co4e.tt_runs_list") + + +# --------------------------------------------------------------------------- +# runs_back_btn +# --------------------------------------------------------------------------- + +def test_back_button_text_tooltip_and_icon(probe_result): + from cowork_local.i18n import tr + assert probe_result["back_btn_text"] == tr("co4e.back_to_flow") + assert probe_result["back_btn_tooltip"] == tr("co4e.tt_back_to_flow") + assert probe_result["back_icon_isnull"] is False + + +def test_back_button_click_calls_show_runs_with_false(probe_result): + # _build_runs_page noi runs_back_btn.clicked -> lambda: self._show_runs(False) + assert probe_result["calls_after_back_click"] == [False] + + +# --------------------------------------------------------------------------- +# runs_title +# --------------------------------------------------------------------------- + +def test_runs_title_text_and_object_name(probe_result): + from cowork_local.i18n import tr + assert probe_result["title_text"] == tr("co4e.running_flows") + assert probe_result["title_object_name"] == "hint" + + +# --------------------------------------------------------------------------- +# ws_folder_btn +# --------------------------------------------------------------------------- + +def test_ws_folder_button_is_flat_with_pointing_hand_cursor(probe_result): + assert probe_result["ws_folder_flat"] is True + assert probe_result["ws_folder_cursor_is_pointing_hand"] is True + assert probe_result["ws_folder_icon_isnull"] is False + + +def test_ws_folder_button_text_uses_ellipsis_and_forward_slash_regardless_of_os( + probe_result, +): + # quirk: "…/" (dau cham lung That, KHONG phai 3 dau cham thuong) roi + # noi 2 phan cuoi cua path bang "/" luon luon - kha nang fallback rong day + # du duoc kich hoat boi ctx.config gia lap khong co .config that. + assert probe_result["ws_folder_text"] == "…/runs/co4e" + + +def test_ws_folder_button_tooltip_embeds_the_fallback_root_path(probe_result): + from cowork_local.i18n import tr + root = str(Path(probe_result["config_dir"]) / "co4e" / "runs" / "co4e") + assert probe_result["ws_folder_tooltip"] == tr( + "co4e.tt_open_workspace", path=root + ) + assert probe_result["flow_output_root_fallback"] == root + + +def test_ws_folder_button_click_calls_open_workspace_folder(probe_result): + assert probe_result["ws_open_calls_after_click"] == 1 + + +def test_config_dir_is_isolated_inside_the_sandbox(probe_result): + # chot lai rang qua trinh dung widget khong lam chuyen sang HOME that. + assert probe_result["_sandbox"] in probe_result["config_dir"] + + +# --------------------------------------------------------------------------- +# run_stop_btn / run_rename_btn / run_del_btn / run_clear_btn +# --------------------------------------------------------------------------- + +def test_stop_button_text_object_name_tooltip_icon(probe_result): + from cowork_local.i18n import tr + assert probe_result["stop_btn_text"] == tr("co4e.stop") + assert probe_result["stop_btn_object_name"] == "danger" + assert probe_result["stop_btn_tooltip"] == tr("co4e.tt_stop_run") + assert probe_result["stop_btn_icon_isnull"] is False + + +def test_stop_button_click_calls_stop_selected_run(probe_result): + assert probe_result["stop_calls_after_click"] == 1 + + +def test_rename_button_text_tooltip_icon(probe_result): + from cowork_local.i18n import tr + assert probe_result["rename_btn_text"] == tr("co4e.rename_run") + assert probe_result["rename_btn_tooltip"] == tr("co4e.tt_rename_run") + assert probe_result["rename_btn_icon_isnull"] is False + + +def test_rename_button_click_calls_rename_selected_run(probe_result): + assert probe_result["rename_calls_after_click"] == 1 + + +def test_delete_button_text_tooltip_icon(probe_result): + from cowork_local.i18n import tr + assert probe_result["del_btn_text"] == tr("co4e.delete_run") + assert probe_result["del_btn_tooltip"] == tr("co4e.tt_delete_run") + assert probe_result["del_btn_icon_isnull"] is False + + +def test_delete_button_click_calls_delete_selected_run(probe_result): + assert probe_result["delete_calls_after_click"] == 1 + + +def test_clear_button_text_tooltip_and_no_object_name(probe_result): + from cowork_local.i18n import tr + assert probe_result["clear_btn_text"] == tr("co4e.clear_done") + assert probe_result["clear_btn_tooltip"] == tr("co4e.tt_clear_runs") + # quirk: khac 4 nut hang xom, run_clear_btn khong setObjectName. + assert probe_result["clear_btn_object_name"] == "" + + +def test_clear_button_has_no_icon_unlike_its_siblings(probe_result): + # quirk: run_clear_btn la nut DUY NHAT trong hang khong co setIcon(...). + assert probe_result["clear_btn_icon_isnull"] is True + + +def test_clear_button_click_calls_manager_clear_finished_directly(probe_result): + # quirk: noi THANG toi lambda: self.manager.clear_finished() - khong di + # qua mot method rieng tren self nhu 3 nut hang xom (stop/rename/delete). + assert probe_result["manager_clear_finished_calls_after_click"] == 1 + + +# --------------------------------------------------------------------------- +# runs_table: double-click / context-menu signals +# --------------------------------------------------------------------------- + +def test_double_click_on_a_row_calls_open_run_from_table(probe_result): + assert probe_result["open_run_calls_after_dbl_click"] == 1 + + +def test_context_menu_request_calls_runs_context_menu(probe_result): + assert probe_result["ctx_menu_calls_after_signal"] == 1 + + +# --------------------------------------------------------------------------- +# Lenh thu cong da dung de chot cac gia tri JSON o tren (quy trinh nguoc): +# +# .venv/Scripts/python.exe -c "" +# +# voi la mot thu muc rong duoc gan vao HOME/USERPROFILE TRUOC khi +# script import bat ky thu gi thuoc cowork_local, va la thu muc +# cha cua repo (de "import cowork_local" hoat dong dung nhu conftest.py lam). +# --------------------------------------------------------------------------- diff --git a/tests/characterization/test_co4e_skills_panel.py b/tests/characterization/test_co4e_skills_panel.py new file mode 100644 index 0000000..9a58268 --- /dev/null +++ b/tests/characterization/test_co4e_skills_panel.py @@ -0,0 +1,309 @@ +"""Characterization test cho khu vực SKILLS trong sidebar của ``Co4ETab`` +(``ui/co4e_tab.py``): ``sk_manage_btn``/``skill_list``/``_manage_skills`` (nối +click) và phần "populate skill_list" bên trong ``_reload_sidebar`` — đúng các +đoạn được giao: dòng 569-580 (dựng widget qua ``SkillsListPanel`` + nối +signal), 602 (vòng lặp ``setMinimumHeight(56)`` dùng CHUNG cho +``wf_list``/``agent_list``/``skill_list``/``runs_side_list``), 690-723 +(``_reload_sidebar``, CHỈ đoạn skill) và 1370-1374 (``_manage_skills``). + +VÌ SAO GHI LẠI CHỨ KHÔNG PHÁN XÉT: đây là lưới an toàn cho đợt tách +``ui/co4e_tab.py`` (2000+ dòng) thành các module con dưới ``presentation/co4e/`` +(xem ``docs/architecture/co4e-split-map.md`` — khu vực SKILLS đã dời phần +DỰNG WIDGET sang ``presentation/co4e/skills_list_panel.py::SkillsListPanel``, +còn phần NỐI SIGNAL + populate vẫn ở ``Co4ETab``). Mọi ``assert`` dưới đây +được chốt lại từ giá trị THẬT in ra khi chạy code (quy trình ngược: chạy +trước, in ra, dán vào assert) — không phải giá trị tôi nghĩ nó "nên" là gì. + +VÌ SAO CHẠY TRONG TIẾN TRÌNH CON CÔ LẬP HOME: giống hệt kỹ thuật của +``tests/test_build_co4e_tab.py`` (đọc docstring đầu file đó để thấy khuôn gốc) +và ``tests/characterization/test_co4e_agent_panel.py`` — dựng ``Co4ETab`` thật +kéo theo ``AppConfig``/``CONFIG_DIR`` (config.py) và ``SKILLS_DIR`` +(core/skills.py) đều là hằng số module tính MỘT LẦN lúc import từ +``Path.home()``. Monkeypatch thuộc tính module SAU khi import không đủ (còn +``AppConfig.load()`` có tham số mặc định đóng băng lúc định nghĩa hàm — xem +``test_build_co4e_tab.py``), nên phải cô lập ``HOME``/``USERPROFILE`` TRƯỚC +bất kỳ import ``cowork_local.*`` nào, trong một tiến trình con sạch hoàn toàn. + +AN TOÀN DỮ LIỆU: script con assert ``str(CONFIG_DIR).startswith(sandbox)`` +NGAY sau khi import, trước khi ghi bất kỳ file skill nào xuống +``skills_mod.SKILLS_DIR`` (``CONFIG_DIR / "skills"``) — chạy nhầm trên máy +thật sẽ ghi/xoá skill thật của người dùng. + +KHÔNG gọi provider AI thật / spawn thread thật: test này không đụng tới +``Co4ERunManager``/``AgentWorker``. ``SkillsDialog.exec()`` (modal, sẽ treo +tiến trình headless) được monkeypatch thành một lớp giả NGAY TRONG tiến trình +con của test — không sửa code sản phẩm; lớp giả chỉ đếm số lần được gọi và trả +về một giá trị falsy (giống bấm Cancel) để lộ ra quirk "luôn reload" bên dưới. + +QUIRK ĐÃ ĐÓNG ĐINH (xem case tương ứng bên dưới): + * ``skill_list`` không lọc theo ``Skill.enabled`` — ``_skill_names()`` gọi + ``list_skills() + builtin_skills()`` không quan tâm cờ ``enabled``, nên + một skill được TẠO nhưng chưa được người dùng tick bật (``enabled=False``) + vẫn xuất hiện trong danh sách kéo-thả của Co4E y hệt một skill đã bật. + Cờ ``enabled`` chỉ ảnh hưởng nơi khác (``active_skills_text`` cho chat), + không ảnh hưởng palette này. + * Payload kéo-thả của một skill KHÔNG chứa ``instructions`` thô của skill, + mà chứa nguyên khối trả về bởi ``skills_mod.skill_prefix_for(name)`` — + tức đã có tiền tố ``"## Skill: \\n"`` dán trước nội dung. Ai "dọn" + chỗ này để dùng thẳng ``skill.instructions`` sẽ làm mọi flow kéo-thả sẵn + mất dòng tiêu đề đó. + * Khi skill có ``instructions`` rỗng, ``skill_prefix_for`` trả về chuỗi rỗng + (không phải ``None``, không ném lỗi) — payload kéo-thả của skill đó có + ``instructions == ""`` dù skill vẫn hiện trong danh sách với đúng tên. + * ``_manage_skills`` LUÔN gọi ``self._reload_sidebar()`` sau + ``SkillsDialog(...).exec()``, bất kể dialog trả về gì (khác với + ``_new_agent``/``_edit_agent`` ở khu vực AGENTS, nơi chỉ reload khi + ``dlg.exec()`` truthy) — đóng Skills manager bằng Cancel/Esc vẫn khiến + ``skill_list`` bị dựng lại từ đĩa. + * Thư mục skills không tồn tại (chưa từng tạo skill nào) không ném lỗi: + ``_skill_names()`` có ``try/except`` bọc quanh, trả về ``[]`` một cách im + lặng — ``skill_list`` rỗng, không có thông báo lỗi nào cho người dùng. + +VÒNG ĐỜI: đây là giàn giáo cho đợt tách phần NỐI SIGNAL + populate của khu vực +Skills sang ``presentation/co4e/`` (dựng widget đã tách xong thành +``SkillsListPanel`` — xem cột "Trạng thái" dòng liên quan trong +``docs/architecture/co4e-split-map.md``). Sau khi phần còn lại được tách (ví +dụ một ``SkillsListController`` biết ``_manage_skills``/populate mà không cần +biết toàn bộ ``Co4ETab``), các case ở đây nên viết lại thành test đặc tả cho +controller mới (input rõ ràng, không cần dựng cả ``Co4ETab``/``QApplication`` +nặng nề qua subprocess). Quirk "payload dùng khối có tiền tố thay vì +instructions thô" và quirk "luôn reload dù Cancel" đáng mở issue hỏi ý kiến +sản phẩm trước khi ai đó "dọn" chúng trong lúc tách. +""" +from __future__ import annotations + +import os +import subprocess +import sys +from pathlib import Path + +REPO_ROOT = Path(__file__).resolve().parent.parent.parent +REPO_PARENT = REPO_ROOT.parent + +_SCRIPT = r""" +import json +import sys +sys.path.insert(0, REPO_PARENT_PLACEHOLDER) + +from PySide6.QtWidgets import QAbstractItemView, QApplication +from PySide6.QtCore import Qt + +from cowork_local.config import AppConfig, CONFIG_DIR +from cowork_local.state import AppContext +from cowork_local.core import skills as skills_mod +from cowork_local.ui.co4e_tab import Co4ETab, _PaletteList, _skill_names +from cowork_local.ui.icons import icon as _icon +from cowork_local.i18n import tr + +sandbox = sys.argv[1] +assert str(CONFIG_DIR).startswith(sandbox), "khong co lap: CONFIG_DIR=" + str(CONFIG_DIR) + +app = QApplication([]) +ctx = AppContext(AppConfig.load()) +tab = Co4ETab(ctx) + +# ---- 569-580: widget cua khu vuc SKILLS duoc dung qua SkillsListPanel ------ +assert tab.sk_manage_btn.text() == tr("co4e.manage_skills"), tab.sk_manage_btn.text() +assert tab.sk_manage_btn.toolTip() == tr("co4e.tt_manage_skills"), tab.sk_manage_btn.toolTip() +assert tab.sk_manage_btn.objectName() == "co4eSectionAction" +assert tab.sk_manage_btn.isFlat() is True +assert tab.sk_manage_btn.cursor().shape() == Qt.PointingHandCursor +assert isinstance(tab.skill_list, _PaletteList), type(tab.skill_list) +assert tab.skill_list.dragEnabled() is True +assert tab.skill_list.dragDropMode() == QAbstractItemView.DragOnly +print("CASE_WIDGETS_OK") + +# ---- 602: bon danh sach dung CHUNG mot vong lap setMinimumHeight(56) ------- +heights = { + "wf_list": tab.wf_list.minimumHeight(), + "agent_list": tab.agent_list.minimumHeight(), + "skill_list": tab.skill_list.minimumHeight(), + "runs_side_list": tab.runs_side_list.minimumHeight(), +} +assert heights == { + "wf_list": 56, "agent_list": 56, "skill_list": 56, "runs_side_list": 56, +}, heights +print("CASE_MIN_HEIGHT_SHARED_OK") + +# ---- quirk: chua tao skill nao -> thu muc SKILLS_DIR khong ton tai --------- +# _skill_names() boc try/except quanh list_skills()/builtin_skills(); thu muc +# chua ton tai (Co4ETab.__init__ khong tu tao no) khong nem loi, tra ve rong. +assert not skills_mod.SKILLS_DIR.exists(), skills_mod.SKILLS_DIR +assert _skill_names() == [] +tab._reload_sidebar() +assert tab.skill_list.count() == 0, tab.skill_list.count() +print("CASE_EMPTY_DIR_OK") + +# ---- 690-723 (doan skill): mot skill co instructions, da bat enabled ------- +skills_mod.SKILLS_DIR.mkdir(parents=True, exist_ok=True) +(skills_mod.SKILLS_DIR / "s1.json").write_text(json.dumps({ + "name": "Viet test", + "description": "desc 1", + "instructions": "Luon viet test", + "enabled": True, +}), encoding="utf-8") +tab._reload_sidebar() +assert tab.skill_list.count() == 1, tab.skill_list.count() +it0 = tab.skill_list.item(0) +assert it0.text() == "Viet test", it0.text() +assert it0.icon().isNull() is False +# Dong lo hong da bi mutation test bat duoc (xem docs/architecture/ +# co4e-refactor-run-report.md muc 4, luot 3): doi icon_name truyen vao +# _palette_item(name, "sparkle", payload) tu "sparkle" sang "robot" o +# ui/co4e_tab.py (dong _reload_sidebar, khu vuc SKILLS) truoc day KHONG bi bat, +# vi assert cu chi kiem "co icon" (isNull() is False) ma khong kiem la icon NAO. +# So sanh pixmap that (icon() la ham thuan, cung name/size/color -> cung anh) +# thay vi so QIcon truc tiep (QIcon khong dinh nghia __eq__ theo noi dung). +assert it0.icon().pixmap(16, 16).toImage() == _icon("sparkle").pixmap(16, 16).toImage(), ( + "icon cua skill trong palette phai dung 'sparkle' (_palette_item(name, 'sparkle', payload))" +) +payload0 = it0.data(Qt.UserRole) +assert payload0 == { + "variant": "step", "label": "Viet test", "agent_slug": "viet-test", + "role": "SKILL", "icon": "sparkle", + "instructions": "## Skill: Viet test\nLuon viet test", + "context": "", "model": "", "self_verify": True, "max_verify_rounds": 1, + "permission_preset": "full", "skills": ["Viet test"], "attachments": [], + "sub_agents": [], +}, payload0 +assert it0.data(Qt.UserRole + 1) is None +print("CASE_ONE_SKILL_OK") + +# ---- quirk: skill CHUA duoc bat (enabled=False) van hien trong palette ----- +# list_skills()/builtin_skills() khong loc theo enabled - _skill_names() lay +# ca hai, nen mot skill "tat" van keo-tha duoc tu Co4E y het skill "bat". +(skills_mod.SKILLS_DIR / "s2-disabled.json").write_text(json.dumps({ + "name": "Chua bat", + "description": "", + "instructions": "Noi dung chua bat", + "enabled": False, +}), encoding="utf-8") +tab._reload_sidebar() +assert tab.skill_list.count() == 2, tab.skill_list.count() +names = [tab.skill_list.item(i).text() for i in range(tab.skill_list.count())] +assert names == ["Viet test", "Chua bat"], names +it1 = tab.skill_list.item(1) +payload1 = it1.data(Qt.UserRole) +assert payload1["instructions"] == "## Skill: Chua bat\nNoi dung chua bat", payload1 +print("CASE_DISABLED_SKILL_STILL_SHOWN_QUIRK_OK") + +# ---- quirk: skill co instructions RONG -> payload instructions == "" ------ +# skill_prefix_for() tra ve "" khi instructions rong (khong None, khong loi); +# skill van hien dung ten trong danh sach. +(skills_mod.SKILLS_DIR / "s3-empty-instr.json").write_text(json.dumps({ + "name": "Rong noi dung", + "description": "", + "instructions": "", + "enabled": True, +}), encoding="utf-8") +tab._reload_sidebar() +assert tab.skill_list.count() == 3, tab.skill_list.count() +it2 = tab.skill_list.item(2) +assert it2.text() == "Rong noi dung", it2.text() +payload2 = it2.data(Qt.UserRole) +assert payload2["instructions"] == "", payload2 +assert payload2["skills"] == ["Rong noi dung"], payload2 +print("CASE_EMPTY_INSTRUCTIONS_QUIRK_OK") + +# ---- xoa het skill roi reload lai -> khong con dong nao (khong con sot) ---- +for p in skills_mod.SKILLS_DIR.glob("*.json"): + p.unlink() +tab._reload_sidebar() +assert tab.skill_list.count() == 0, tab.skill_list.count() +print("CASE_CLEAR_ON_RELOAD_OK") + +# ---- 1370-1374: _manage_skills() mo SkillsDialog(self, self.ctx) ----------- +import cowork_local.ui.skills_dialog as skills_dialog_mod + +dialog_calls = [] + + +class _FakeSkillsDialog: + def __init__(self, parent, ctx_arg): + dialog_calls.append((parent is tab, ctx_arg is ctx)) + + def exec(self): + return 0 # falsy, gia lap bam Cancel/Esc + + +orig_dialog_cls = skills_dialog_mod.SkillsDialog +skills_dialog_mod.SkillsDialog = _FakeSkillsDialog + +reload_calls = {"n": 0} +orig_reload = tab._reload_sidebar + + +def _counting_reload(): + reload_calls["n"] += 1 + return orig_reload() + + +tab._reload_sidebar = _counting_reload +tab._manage_skills() +skills_dialog_mod.SkillsDialog = orig_dialog_cls +tab._reload_sidebar = orig_reload + +assert dialog_calls == [(True, True)], dialog_calls +# quirk: dialog tra ve gia tri falsy (Cancel) nhung sidebar VAN duoc reload. +assert reload_calls["n"] == 1, reload_calls +print("CASE_MANAGE_SKILLS_ALWAYS_RELOADS_QUIRK_OK") + +# ---- 573: sk_manage_btn.clicked noi thang toi _manage_skills --------------- +recorded = [] +tab._manage_skills = lambda: recorded.append(1) +tab.sk_manage_btn.click() +assert recorded == [1], recorded +print("CASE_CLICK_WIRES_TO_MANAGE_SKILLS_OK") + +print("ALL_OK") +""" + + +def _run_isolated(sandbox: Path) -> subprocess.CompletedProcess: + env = dict(os.environ) + env["HOME"] = str(sandbox) + env["USERPROFILE"] = str(sandbox) + env["QT_QPA_PLATFORM"] = "offscreen" + env["PYTHONIOENCODING"] = "utf-8" + env.pop("HOMEDRIVE", None) + env.pop("HOMEPATH", None) + + script = _SCRIPT.replace("REPO_PARENT_PLACEHOLDER", repr(str(REPO_PARENT))) + return subprocess.run( + [sys.executable, "-c", script, str(sandbox)], + cwd=str(REPO_ROOT), + env=env, + capture_output=True, + text=True, + timeout=60, + ) + + +def test_co4e_skills_panel_hanh_vi_hien_tai(tmp_path): + sandbox = tmp_path / "home" + sandbox.mkdir() + + result = _run_isolated(sandbox) + + assert result.returncode == 0, ( + f"characterization script that bai (exit {result.returncode}):\n" + f"--- stdout ---\n{result.stdout}\n--- stderr ---\n{result.stderr}" + ) + for marker in ( + "CASE_WIDGETS_OK", + "CASE_MIN_HEIGHT_SHARED_OK", + "CASE_EMPTY_DIR_OK", + "CASE_ONE_SKILL_OK", + "CASE_DISABLED_SKILL_STILL_SHOWN_QUIRK_OK", + "CASE_EMPTY_INSTRUCTIONS_QUIRK_OK", + "CASE_CLEAR_ON_RELOAD_OK", + "CASE_MANAGE_SKILLS_ALWAYS_RELOADS_QUIRK_OK", + "CASE_CLICK_WIRES_TO_MANAGE_SKILLS_OK", + "ALL_OK", + ): + assert marker in result.stdout, f"thieu marker {marker}\n{result.stdout}" + + # Sandbox chi duoc dung boi cac file skill test tu tao xuong SKILLS_DIR + # (khong co du lieu nguoi dung that nao bi cham vao) - CONFIG_DIR nam + # trong sandbox nhu da assert ngay dau script. + assert (sandbox / ".cowork_local").exists() diff --git a/tests/characterization/test_node_property_panel.py b/tests/characterization/test_node_property_panel.py new file mode 100644 index 0000000..656f5ef --- /dev/null +++ b/tests/characterization/test_node_property_panel.py @@ -0,0 +1,463 @@ +"""Characterization test cho ``StepConfigPanel`` (``ui/co4e_config_panel.py``, +dong 133-528) — KHONG bao gom ``_SectionHeader``/``_add_section`` (khung UI +chung, khong co hanh vi nghiep vu rieng dang characterize). + +VI SAO GHI LAI CHU KHONG PHAN XET: day la luoi an toan cho dot tach +``StepConfigPanel`` ra khoi ``ui/co4e_config_panel.py`` sang cac module con +duoi ``presentation/co4e/`` (vi du ``node_property_panel.py``, +``node_property_actions_mixin.py``, ``step_config_section.py`` — xem +``docs/architecture/co4e-split-map-node-property.md``). Moi ``assert`` duoi +day duoc chot lai tu gia tri THAT in ra khi chay code that (quy trinh nguoc: +chay truoc, in ra, dan vao assert) — khong phai gia tri "nen" la gi theo suy +doan. + +VI SAO CAN TIEN TRINH CON + CO LAP HOME: ban than ``StepConfigPanel.__init__``/ +``load_step`` KHONG cham dia/mang, nhung ``_available_agent_names()`` (goi tu +``_add_subagent``/``_edit_subagent``) doc THAT tu +``core.co4e.list_custom_agents()`` duoi ``CONFIG_DIR/co4e/agents`` — mot +hang so module tinh MOT LAN tu ``Path.home()`` luc import. Vi vay HOME/ +USERPROFILE phai duoc tro sang thu muc tam TRUOC BAT KY import +``cowork_local.*`` nao, trong mot tien trinh con sach (patch thuoc tinh sau +khi import la khong du) — dung khuon ``tools/capture_screens.py::_isolate_home`` +va ``tests/characterization/test_co4e_agent_panel.py``. Tien trinh con rieng +cung tranh xung dot QApplication singleton neu mot tien trinh pytest khac da +tao QApplication trong cung luot chay. ``QT_QPA_PLATFORM=offscreen`` duoc dat +TRUOC khi import PySide6 (dung khuon ``tools/check_co4e.py`` dong 22+40-42); +script con assert ngay ``str(CONFIG_DIR).startswith(sandbox)`` truoc khi goi +bat ky ham co4e nao (giong ``tools/check_co4e.py:47``) — khong co lap la doc +(va co the ghi) du lieu that cua nguoi dung qua ``list_custom_agents()``/ +``save_custom_agent()``. + +KHONG goi provider AI that / spawn thread that: ``_ai_draft()`` va +``_load_models()`` (dung ``AgentWorker``/``QThread`` that) KHONG duoc goi o +bat ky case nao trong file nay — hai ham do nam NGOAI pham vi duoc giao +(139-462) va can duoc characterize rieng, tach biet, voi worker/thread duoc +gia lap chu khong start that. + +QUIRK DA DONG DINH (xem case tuong ung ben duoi): + * ``gen_btn``/``load_models_btn`` duoc set ``setEnabled(ctx is not None)`` + ngay trong ``__init__`` (dong 181, 208), NHUNG dong 313 goi + ``self.setEnabled(False)`` cho CA PANEL o cuoi ``__init__`` — vi Qt tinh + ``isEnabled()`` hieu qua tu ca chuoi ancestor, ca hai nut deu tra ve + ``False`` NGAY SAU KHI DUNG XONG bat ke ``ctx`` la gi, cho toi khi + ``load_step()`` (hoac ``setEnabled(True)`` truc tiep) bat lai ca panel. + Doc rieng dong 181/208 se de tuong "ctx=None thi nut luon tat, ctx khac + None thi nut luon bat" — sai, ca hai deu tat cho den khi co step duoc nap. + * ``rounds_spin`` = ``QSpinBox(range=1..5)`` nhung code goi + ``setValue(max(1, step.max_verify_rounds))`` (dong 330) — voi + ``max_verify_rounds=10``, ``max(1, 10) == 10`` nhung ``QSpinBox`` tu kep + ve tran cua no nen gia tri hien thi la ``5``, khong phai ``10``. Doc code + ma khong chay se tuong gia tri duoc giu nguyen. + * ``perm_combo`` voi ``step.permission_preset`` khong nam trong + ``PERMISSION_PRESETS`` (nhanh fallback cua ``findData`` tra ve -1) roi ve + index 0 == ``"inherit"`` — im lang, khong bao loi. + * ``load_step`` chi dung skill_names de dung skills_list; mot skill trong + ``step.skills`` khong con trong ``skill_names`` (skill da bi xoa khoi + registry) don gian BIEN MAT khoi checklist — va khi ``_on_edit`` chay lan + ke tiep (do BAT KY thay doi field nao khac, khong can dung vao + skills_list), ``s.skills`` duoc GHI DE lai chi bang cac item dang hien + trong checklist, nen ten skill "mo coi" do bi RUNG VINH VIEN khoi + ``step.skills`` — mot edit khong lien quan (vi du sua role) am tham xoa + du lieu skill cu. + * ``variant != "parallel"``: ``_parallel_card`` bi an VA ``sub_list.clear()`` + duoc goi, nhung ``step.sub_agents`` KHONG bi dung vao neu ``is_par`` False + — du liệu van con trong step, chi khong hien tren UI. + * ``_add_subagent``: khi ``_available_agent_names()`` tra ve danh sach RONG, + code chuyen sang ``QInputDialog.getText`` thay vi ``getItem`` (dong + 401-402) — nhanh fallback nay chi cham toi khi khong con agent nao (builtin + + custom) de chon, hiem khi xay ra tren du lieu that nhung van la mot + nhanh code song. + * ``_edit_subagent``: neu agent hien tai cua sub-agent khong con trong danh + sach ten kha dung (``cur not in names``), dialog mo tai index 0 thay vi + bao loi hay giu nguyen lua chon cu. + +VONG DOI: day la gian giao cho dot tach ``StepConfigPanel`` sang +``presentation/co4e/`` (xem ``docs/architecture/co4e-split-map-node-property.md`` +cho ke hoach tach cu the). Sau khi tach xong thanh cac lop/mixin voi hop dong +ro rang, cac case o day nen duoc viet lai thanh test dac ta cho tung phan +(khong can dung ca ``QApplication``/tien trinh con neu phan tach ra la logic +thuan). Ba quirk "panel disabled de len enable cua nut", "orphan skill bi xoa +qua mot edit khong lien quan" va "sub_agents khong dong bo voi sub_list khi +doi variant" dang mo issue hoi y kien san pham truoc khi ai do "don" chung +trong luc tach — dac biet quirk orphan-skill, vi day la mot dang mat du lieu +tham lang de bi coi la bug can sua ngay khi gap lai, nhung sua no thay doi +hanh vi luu tru hien co ma khong ai ro co ai dang phu thuoc vao khong. +""" +from __future__ import annotations + +import os +import subprocess +import sys +from pathlib import Path + +REPO_ROOT = Path(__file__).resolve().parent.parent.parent +REPO_PARENT = REPO_ROOT.parent + +_SCRIPT = r""" +import sys +sys.path.insert(0, REPO_PARENT_PLACEHOLDER) + +from pathlib import Path as _PP +from PySide6.QtWidgets import QApplication, QInputDialog, QFileDialog, QListWidgetItem +from PySide6.QtCore import Qt + +from cowork_local.config import CONFIG_DIR + +sandbox = sys.argv[1] +assert str(CONFIG_DIR).startswith(str(_PP(sandbox))), "khong co lap: CONFIG_DIR=" + str(CONFIG_DIR) + +app = QApplication([]) + +from cowork_local.ui.co4e_config_panel import StepConfigPanel +from cowork_local.core.co4e import Step, SubAgent, PERMISSION_PRESETS +from cowork_local.core import co4e as co4e_mod +from cowork_local.core.co4e_builtins import BUILTIN_AGENTS + +# ---- __init__ (139-313) ---------------------------------------------------- +p = StepConfigPanel() +assert p.gen_btn.isEnabled() is False +assert p.load_models_btn.isEnabled() is False +assert p.isEnabled() is False, "panel bat dau bi setEnabled(False) o dong 313" +assert p.perm_combo.count() == len(PERMISSION_PRESETS) == 4 +assert [p.perm_combo.itemData(i) for i in range(4)] == list(PERMISSION_PRESETS) +assert (p.rounds_spin.minimum(), p.rounds_spin.maximum()) == (1, 5) +print("CASE_INIT_DEFAULT_CTX_NONE_OK") + +# quirk: gen_btn/load_models_btn duoc set theo ctx, nhung setEnabled(False) +# cho CA PANEL o cuoi __init__ de len tren ca hai -> ca hai deu False cho den +# khi mot cai gi do bat lai ca panel (vd load_step() goi setEnabled(True)). +p_ctx = StepConfigPanel(ctx=object()) +assert p_ctx.gen_btn.isEnabled() is False, "quirk: panel disabled de len len ctx!=None" +assert p_ctx.load_models_btn.isEnabled() is False +p_ctx.setEnabled(True) # mo phong dieu load_step() lam +assert p_ctx.gen_btn.isEnabled() is True +assert p_ctx.load_models_btn.isEnabled() is True + +p_none = StepConfigPanel(ctx=None) +p_none.setEnabled(True) +assert p_none.gen_btn.isEnabled() is False, "ctx=None -> nut van tat sau khi panel duoc bat" +assert p_none.load_models_btn.isEnabled() is False +print("CASE_INIT_CTX_ENABLE_QUIRK_OK") + +p.show() +app.processEvents() +assert p._parallel_card.isVisible() is True, "form4/_parallel_card khong tu an luc dung" +print("CASE_INIT_PARALLEL_CARD_DEFAULT_VISIBLE_OK") + +# ---- load_step (316-354): step "step" thuong ------------------------------- +step = Step( + variant="step", label="My Step", role="worker", icon="file", + instructions="Do X", context="bg info", model="gpt-4", + permission_preset="standard", self_verify=False, max_verify_rounds=3, + skills=["Test Skill", "OrphanSkill"], attachments=["C:/foo/bar/baz.txt", "note.md"], + sub_agents=[SubAgent(agent="Ghost")], +) +p.load_step("n1", step, ["Test Skill", "Other Skill"]) +assert p.label_edit.text() == "My Step" +assert p.role_edit.text() == "worker" +assert p.icon_edit.currentText() == "file" +assert p.instructions_edit.toPlainText() == "Do X" +assert p.context_edit.toPlainText() == "bg info" +assert p.model_combo.currentText() == "gpt-4" +assert (p.perm_combo.currentIndex(), p.perm_combo.currentData()) == (2, "standard") +assert p.verify_chk.isChecked() is False +assert p.rounds_spin.value() == 3 +assert p.skills_list.count() == 2, "chi 2 muc trong skill_names duoc ve, OrphanSkill khong co hang" +assert [p.skills_list.item(i).text() for i in range(2)] == ["Test Skill", "Other Skill"] +assert p.skills_list.item(0).checkState() == Qt.Checked +assert p.skills_list.item(1).checkState() == Qt.Unchecked +assert p.attach_list.count() == 2 +assert p.attach_list.item(0).text() == "baz.txt" +assert p.attach_list.item(0).toolTip() == "C:/foo/bar/baz.txt" +assert p.attach_list.item(1).text() == "note.md" +app.processEvents() +assert p._parallel_card.isVisible() is False, "variant='step' -> card an" +assert p.sub_list.count() == 0, "quirk: sub_agents khong rong nhung khong dong bo vao UI khi khong phai parallel" +assert step.sub_agents == [SubAgent(agent="Ghost")], "du lieu step khong bi dong cham, chi UI khong ve" +print("CASE_LOAD_STEP_BASIC_OK") + +# quirk: rounds_spin.setValue(max(1, n)) nhung QSpinBox tu kep tran o 5. +p.load_step("n0", Step(max_verify_rounds=0), []) +assert p.rounds_spin.value() == 1 +p.load_step("nneg", Step(max_verify_rounds=-5), []) +assert p.rounds_spin.value() == 1 +p.load_step("n10", Step(max_verify_rounds=10), []) +assert p.rounds_spin.value() == 5, "quirk: max(1,10)=10 nhung QSpinBox kep ve tran 5" +print("CASE_LOAD_STEP_ROUNDS_CLAMP_QUIRK_OK") + +# quirk: permission_preset la khoa khong ton tai -> fallback ve index 0 (inherit) +p.load_step("nbad", Step(permission_preset="does-not-exist"), []) +assert (p.perm_combo.currentIndex(), p.perm_combo.currentData()) == (0, "inherit") +print("CASE_LOAD_STEP_UNKNOWN_PRESET_FALLBACK_OK") + +# variant="parallel" -> card hien, sub_list duoc ve tu sub_agents +steppar = Step(variant="parallel", sub_agents=[SubAgent(agent="A1"), SubAgent(agent="A2")]) +p.load_step("npar", steppar, []) +app.processEvents() +assert p._parallel_card.isVisible() is True +assert [p.sub_list.item(i).text() for i in range(p.sub_list.count())] == ["A1", "A2"] +print("CASE_LOAD_STEP_PARALLEL_OK") + +# rong: skills/attachments rong -> list rong, khong loi +p.load_step("nempty", Step(), []) +assert p.skills_list.count() == 0 +assert p.attach_list.count() == 0 +print("CASE_LOAD_STEP_EMPTY_OK") + +# ---- clear_step (356-359) --------------------------------------------------- +p.clear_step() +assert p._step is None +assert p._node_id == "" +assert p.isEnabled() is False +print("CASE_CLEAR_STEP_OK") + +# _on_edit voi _step None -> khong loi, khong lam gi +p._on_edit() +print("CASE_ON_EDIT_NO_STEP_NOOP_OK") + +# ---- _on_edit (362-378): guard _loading, fallback role, quirk orphan-skill -- +p.load_step("npar2", step, ["Test Skill", "Other Skill"]) +assert step.skills == ["Test Skill", "OrphanSkill"], "chua edit gi thi step chua bi dong den" +p.role_edit.setText("") # -> _on_edit tu dong chay qua signal that, khong mock +assert step.role == "AGENT", "role rong -> fallback 'AGENT' (dong 367)" +assert step.skills == ["Test Skill"], ( + "quirk: mot edit KHONG LIEN QUAN (sua role) cung ghi de s.skills bang " + "danh sach dang checked trong UI -> OrphanSkill bi rung vinh vien" +) +print("CASE_ON_EDIT_ROLE_FALLBACK_AND_ORPHAN_SKILL_QUIRK_OK") + +p._loading = True +step.role = "UNTOUCHED" +p.role_edit.setText("Something Else") +assert step.role == "UNTOUCHED", "guard _loading chan _on_edit khong ghi lai step" +p._loading = False +print("CASE_ON_EDIT_LOADING_GUARD_OK") + +p.role_edit.setText("scout") +assert step.role == "SCOUT", "role duoc upper() hoa (dong 367)" +print("CASE_ON_EDIT_ROLE_UPPERCASE_OK") + +# ---- _available_agent_names (380-390, static) ------------------------------ +names0 = StepConfigPanel._available_agent_names() +assert names0 == [a.name for a in BUILTIN_AGENTS], "khong co custom agent -> chi builtin, dung thu tu" +assert names0[0] == "Business Analyst" +assert len(names0) == len(BUILTIN_AGENTS) == 19 +print("CASE_AVAILABLE_NAMES_NO_CUSTOM_OK") + +custom = co4e_mod.new_custom_agent("Zed Custom") +co4e_mod.save_custom_agent(custom) +names1 = StepConfigPanel._available_agent_names() +assert names1[0] == "Zed Custom", "custom agent dung TRUOC builtin" +assert len(names1) == len(BUILTIN_AGENTS) + 1 +print("CASE_AVAILABLE_NAMES_ONE_CUSTOM_OK") + +# quirk: custom trung ten voi mot builtin -> chi giu 1 lan (dong 389: "not in names") +dup = co4e_mod.new_custom_agent(BUILTIN_AGENTS[0].name) +co4e_mod.save_custom_agent(dup) +names2 = StepConfigPanel._available_agent_names() +assert names2.count(BUILTIN_AGENTS[0].name) == 1, "trung ten voi builtin bi loai bo, khong nhan doi" +assert names2[0] == "Zed Custom" +print("CASE_AVAILABLE_NAMES_DEDUPE_WITH_BUILTIN_OK") + +# ---- _add_subagent (392-408) ------------------------------------------------ +pstep = Step(variant="parallel") +p.load_step("nsub", pstep, []) +p._step = None +before_n = p.sub_list.count() +p._add_subagent() +assert p.sub_list.count() == before_n, "_step None -> _add_subagent la no-op" +print("CASE_ADD_SUBAGENT_NO_STEP_NOOP_OK") + +p._step = pstep +orig_getItem = QInputDialog.getItem +orig_getText = QInputDialog.getText +changed_n = {"n": 0} +p.changed.connect(lambda: changed_n.__setitem__("n", changed_n["n"] + 1)) + +QInputDialog.getItem = staticmethod(lambda *a, **k: ("Picked Agent", True)) +p._add_subagent() +assert [s.agent for s in pstep.sub_agents] == ["Picked Agent"] +assert [p.sub_list.item(i).text() for i in range(p.sub_list.count())] == ["Picked Agent"] +assert changed_n["n"] == 1 +print("CASE_ADD_SUBAGENT_PICKED_OK") + +QInputDialog.getItem = staticmethod(lambda *a, **k: ("", True)) +p._add_subagent() +assert [s.agent for s in pstep.sub_agents] == ["Picked Agent"], "ten rong (sau strip) -> khong them" +assert changed_n["n"] == 1, "khong them thi khong emit changed" +print("CASE_ADD_SUBAGENT_EMPTY_NAME_NOOP_OK") + +QInputDialog.getItem = staticmethod(lambda *a, **k: ("Should Not Add", False)) +p._add_subagent() +assert [s.agent for s in pstep.sub_agents] == ["Picked Agent"], "ok=False -> khong them" +print("CASE_ADD_SUBAGENT_CANCELLED_NOOP_OK") + +# quirk: khi _available_agent_names() rong -> dung getText thay vi getItem (dong 401-402) +# GHI CHU DOT TACH mixin (khong doi hanh vi, chi doi CACH patch/restore trong +# test): sau khi StepConfigPanel._available_agent_names duoc dua vao mixin +# rieng (_StepConfigActionsMixin), no khong con nam trong +# StepConfigPanel.__dict__ nua (ma nam trong __dict__ cua mixin, StepConfigPanel +# chi ke thua qua MRO) nen "StepConfigPanel.__dict__['_available_agent_names']" +# nem KeyError. Gan de ghi de truc tiep len StepConfigPanel (nhu dong duoi) van +# shadow dung nhu truoc; khi xong chi can `del` thuoc tinh do khoi +# StepConfigPanel de no roi ve lai dung method ke thua tu mixin - tuong duong +# hanh vi voi cach "luu roi gan lai" cu, khong lam yeu di assert nao. +StepConfigPanel._available_agent_names = staticmethod(lambda: []) +QInputDialog.getText = staticmethod(lambda *a, **k: ("Typed Agent", True)) +p._add_subagent() +assert [s.agent for s in pstep.sub_agents] == ["Picked Agent", "Typed Agent"] +del StepConfigPanel._available_agent_names +QInputDialog.getItem = orig_getItem +QInputDialog.getText = orig_getText +print("CASE_ADD_SUBAGENT_EMPTY_NAMES_USES_GETTEXT_QUIRK_OK") + +# ---- _edit_subagent (410-428) ----------------------------------------------- +pstep2 = Step(variant="parallel", sub_agents=[SubAgent(agent="Unknown Agent XYZ")]) +p.load_step("nedit", pstep2, []) +captured = {} + + +def _fake_get_item(*a, **k): + captured["items"] = a[3] + captured["current_index"] = a[4] + return ("Renamed", True) + + +QInputDialog.getItem = staticmethod(_fake_get_item) +item0 = p.sub_list.item(0) +p._edit_subagent(item0) +assert captured["current_index"] == 0, "quirk: cur khong nam trong names -> mo dialog tai index 0" +assert pstep2.sub_agents[0].agent == "Renamed" +assert item0.text() == "Renamed" +print("CASE_EDIT_SUBAGENT_UNKNOWN_CUR_STARTS_AT_0_OK") + +foreign_item = QListWidgetItem("not in list") +snapshot = dict(captured) +p._edit_subagent(foreign_item) +assert captured == snapshot, "item khong thuoc sub_list (row=-1) -> no-op" +QInputDialog.getItem = orig_getItem +print("CASE_EDIT_SUBAGENT_FOREIGN_ITEM_NOOP_OK") + +# ---- _del_subagent (430-437) ------------------------------------------------- +pstep3 = Step(variant="parallel", sub_agents=[SubAgent(agent="A"), SubAgent(agent="B")]) +p.load_step("ndel", pstep3, []) +p.sub_list.setCurrentRow(-1) +p._del_subagent() +assert [s.agent for s in pstep3.sub_agents] == ["A", "B"], "khong chon dong nao -> no-op" +p.sub_list.setCurrentRow(0) +p._del_subagent() +assert [s.agent for s in pstep3.sub_agents] == ["B"] +assert [p.sub_list.item(i).text() for i in range(p.sub_list.count())] == ["B"] +print("CASE_DEL_SUBAGENT_OK") + +# ---- _add_attachment (439-453) ----------------------------------------------- +astep = Step(attachments=["already/here.txt"]) +p.load_step("natt", astep, []) +orig_getOpenFileNames = QFileDialog.getOpenFileNames +QFileDialog.getOpenFileNames = staticmethod( + lambda *a, **k: (["already/here.txt", "new/one.txt", ""], "") +) +att_changed = {"n": 0} +p.changed.connect(lambda: att_changed.__setitem__("n", att_changed["n"] + 1)) +p._add_attachment() +assert astep.attachments == ["already/here.txt", "new/one.txt"], ( + "duplicate bi loai (dong 447), chuoi rong bi loai boi 'if f and ...'" +) +assert p.attach_list.count() == 2 +print("CASE_ADD_ATTACHMENT_DEDUPE_AND_SKIP_EMPTY_OK") + +before_att_changed = att_changed["n"] +QFileDialog.getOpenFileNames = staticmethod(lambda *a, **k: ([], "")) +p._add_attachment() +assert att_changed["n"] == before_att_changed, "files rong -> khong emit changed (dong 452-453)" +QFileDialog.getOpenFileNames = orig_getOpenFileNames +print("CASE_ADD_ATTACHMENT_EMPTY_FILES_NO_CHANGED_OK") + +p._step = None +before_att_count = p.attach_list.count() +p._add_attachment() +assert p.attach_list.count() == before_att_count, "_step None -> no-op" +p._step = astep +print("CASE_ADD_ATTACHMENT_NO_STEP_NOOP_OK") + +# ---- _del_attachment (455-462) ----------------------------------------------- +p.attach_list.setCurrentRow(-1) +p._del_attachment() +assert astep.attachments == ["already/here.txt", "new/one.txt"], "khong chon dong -> no-op" +p.attach_list.setCurrentRow(0) +p._del_attachment() +assert astep.attachments == ["new/one.txt"] +assert p.attach_list.count() == 1 +print("CASE_DEL_ATTACHMENT_OK") + +print("ALL_OK") +""" + + +def _run_isolated(sandbox: Path) -> subprocess.CompletedProcess: + env = dict(os.environ) + env["HOME"] = str(sandbox) + env["USERPROFILE"] = str(sandbox) + env["QT_QPA_PLATFORM"] = "offscreen" + env["PYTHONIOENCODING"] = "utf-8" + env.pop("HOMEDRIVE", None) + env.pop("HOMEPATH", None) + + script = _SCRIPT.replace("REPO_PARENT_PLACEHOLDER", repr(str(REPO_PARENT))) + return subprocess.run( + [sys.executable, "-c", script, str(sandbox)], + cwd=str(REPO_ROOT), + env=env, + capture_output=True, + text=True, + timeout=60, + ) + + +def test_step_config_panel_hanh_vi_hien_tai(tmp_path): + sandbox = tmp_path / "home" + sandbox.mkdir() + + result = _run_isolated(sandbox) + + assert result.returncode == 0, ( + f"characterization script that bai (exit {result.returncode}):\n" + f"--- stdout ---\n{result.stdout}\n--- stderr ---\n{result.stderr}" + ) + for marker in ( + "CASE_INIT_DEFAULT_CTX_NONE_OK", + "CASE_INIT_CTX_ENABLE_QUIRK_OK", + "CASE_INIT_PARALLEL_CARD_DEFAULT_VISIBLE_OK", + "CASE_LOAD_STEP_BASIC_OK", + "CASE_LOAD_STEP_ROUNDS_CLAMP_QUIRK_OK", + "CASE_LOAD_STEP_UNKNOWN_PRESET_FALLBACK_OK", + "CASE_LOAD_STEP_PARALLEL_OK", + "CASE_LOAD_STEP_EMPTY_OK", + "CASE_CLEAR_STEP_OK", + "CASE_ON_EDIT_NO_STEP_NOOP_OK", + "CASE_ON_EDIT_ROLE_FALLBACK_AND_ORPHAN_SKILL_QUIRK_OK", + "CASE_ON_EDIT_LOADING_GUARD_OK", + "CASE_ON_EDIT_ROLE_UPPERCASE_OK", + "CASE_AVAILABLE_NAMES_NO_CUSTOM_OK", + "CASE_AVAILABLE_NAMES_ONE_CUSTOM_OK", + "CASE_AVAILABLE_NAMES_DEDUPE_WITH_BUILTIN_OK", + "CASE_ADD_SUBAGENT_NO_STEP_NOOP_OK", + "CASE_ADD_SUBAGENT_PICKED_OK", + "CASE_ADD_SUBAGENT_EMPTY_NAME_NOOP_OK", + "CASE_ADD_SUBAGENT_CANCELLED_NOOP_OK", + "CASE_ADD_SUBAGENT_EMPTY_NAMES_USES_GETTEXT_QUIRK_OK", + "CASE_EDIT_SUBAGENT_UNKNOWN_CUR_STARTS_AT_0_OK", + "CASE_EDIT_SUBAGENT_FOREIGN_ITEM_NOOP_OK", + "CASE_DEL_SUBAGENT_OK", + "CASE_ADD_ATTACHMENT_DEDUPE_AND_SKIP_EMPTY_OK", + "CASE_ADD_ATTACHMENT_EMPTY_FILES_NO_CHANGED_OK", + "CASE_ADD_ATTACHMENT_NO_STEP_NOOP_OK", + "CASE_DEL_ATTACHMENT_OK", + "ALL_OK", + ): + assert marker in result.stdout, f"thieu marker {marker}\n{result.stdout}" + + # Sandbox chi duoc dung boi save_custom_agent() cua chinh test (khong co + # du lieu nguoi dung that nao bi cham vao) - CONFIG_DIR nam trong sandbox + # nhu da assert ngay dau script. + assert (sandbox / ".cowork_local" / "co4e").exists() diff --git a/tests/fakes/fake_co4e_workflow_service.py b/tests/fakes/fake_co4e_workflow_service.py new file mode 100644 index 0000000..6986471 --- /dev/null +++ b/tests/fakes/fake_co4e_workflow_service.py @@ -0,0 +1,174 @@ +"""``Co4EWorkflowService`` giả — cho widget Co4E Studio (presentation/) và cho +test khác dùng khi service thật +(``application/workflows/co4e_workflow_service.py``) chưa được ``bootstrap.py`` +lắp vào, hoặc khi test không muốn chạm đĩa/AI thật. + +Chạy hoàn toàn trong bộ nhớ, đồng bộ, không cần ``runner`` thật (không +``AgentWorker``/``QThread`` nào được tạo): ``start()`` ghi nhận run ở trạng +thái "running" rồi đứng yên — muốn mô phỏng tiến trình thì test tự gọi +``deliver_event``/``mark_finished``/``mark_failed``, giống hệt cách +``tests/characterization/test_co4e_run_manager_behavior.py`` seed tay vào +``Co4ERunManager`` thật rồi gọi ``_on_event``/``_on_finished``/``_on_failed``. + +Ví dụ dùng:: + + >>> from tests.fakes.fake_co4e_workflow_service import FakeCo4EWorkflowService + >>> class _Wf: + ... id = "wf1"; name = "Flow"; nodes = []; edges = [] + >>> svc = FakeCo4EWorkflowService() + >>> run_id = svc.start(_Wf()) + >>> svc.started_workflows[0].id + 'wf1' + >>> svc.runs()[0].status + 'running' + >>> svc.mark_finished(run_id) + >>> svc.runs()[0].status + 'done' +""" +from __future__ import annotations + +from pathlib import Path +from typing import Callable, Dict, List, Optional + +from cowork_local.domain.workflows.run_record import RunRecord + +# Mirror dung gia tri cua STEP_DONE/STEP_ERROR/STEP_PLANNED (core/co4e.py) ma +# khong import core/ o day -- fake nay chi phu thuoc domain/, giu no nhe va +# nhanh de import trong test cua team khac. +_TERMINAL_NODE = {"done", "error", "planned"} + + +class FakeCo4EWorkflowService: + """Bản giả của ``Co4EWorkflowService`` — cùng API công khai, ghi lại mọi + lời gọi để test khẳng định được "có gọi service không" và "gọi với gì".""" + + def __init__(self): + self._runs: Dict[str, RunRecord] = {} + self._seq = 0 + self._project_id: str = "" + self._output_root: Optional[Path] = None + self._changed_callbacks: List[Callable[[], None]] = [] + self._event_callbacks: List[Callable[[str, dict], None]] = [] + #: moi workflow da duoc start(), dung thu tu goi -- test khang dinh + #: "co goi service.start() khong" ma khong can thuc thi that. + self.started_workflows: list = [] + self.stopped_run_ids: List[str] = [] + self.removed_run_ids: List[str] = [] + self.renamed: List[tuple] = [] + + # ---- callback thay Signal (giong Co4EWorkflowService that) ------------- + def on_changed(self, cb: Callable[[], None]) -> None: + self._changed_callbacks.append(cb) + + def on_event(self, cb: Callable[[str, dict], None]) -> None: + self._event_callbacks.append(cb) + + def _emit_changed(self) -> None: + for cb in self._changed_callbacks: + cb() + + def _emit_event(self, run_id: str, ev: dict) -> None: + for cb in self._event_callbacks: + cb(run_id, ev) + + # ---- lifecycle ---------------------------------------------------- + def start(self, wf, *, skill_map=None, plan_mode: bool = False, only_nodes=None, + seed_outputs=None, manual: bool = False, label: Optional[str] = None) -> str: + self._seq += 1 + run_id = f"run{self._seq}" + nodes = getattr(wf, "nodes", None) or [] + total = len(only_nodes) if only_nodes else len(nodes) + record = RunRecord(run_id, getattr(wf, "id", ""), label or getattr(wf, "name", ""), + total, plan_mode, manual, project_id=self._project_id) + self._runs[run_id] = record + self.started_workflows.append(wf) + self._emit_changed() + return run_id + + # ---- hook gia lap tien trinh (goi TU TEST, khong phai tu runner that) -- + def deliver_event(self, run_id: str, ev: dict) -> None: + """Mo phong dung ``Co4EWorkflowService._on_event`` that.""" + record = self._runs.get(run_id) + if record is not None and isinstance(ev, dict): + t = ev.get("type") + if t == "node_status": + record.node_status[ev.get("node_id")] = ev.get("status") + record.done = sum(1 for s in record.node_status.values() if s in _TERMINAL_NODE) + self._emit_changed() + elif t == "run_done": + if record.status == "running": + record.status = "done" if ev.get("ok", True) else "error" + self._emit_changed() + self._emit_event(run_id, ev) + + def mark_finished(self, run_id: str) -> None: + record = self._runs.get(run_id) + if record is not None and record.status == "running": + record.status = "done" + self._emit_changed() + + def mark_failed(self, run_id: str, err: str) -> None: + record = self._runs.get(run_id) + if record is not None: + record.status = "error" + record.error = str(err) + self._emit_event(run_id, {"type": "run_error", "error": str(err)}) + self._emit_changed() + + # ---- control -------------------------------------------------------- + def stop(self, run_id: str) -> None: + record = self._runs.get(run_id) + if record is not None and record.running: + record.status = "stopped" + self.stopped_run_ids.append(run_id) + self._emit_changed() + + def stop_all(self) -> None: + for run_id in [r for r, rec in self._runs.items() if self._belongs(rec)]: + self.stop(run_id) + + def rename(self, run_id: str, new_name: str) -> None: + record = self._runs.get(run_id) + new_name = (new_name or "").strip() + if record is None or not new_name or new_name == record.name: + return + record.name = new_name + if record.wf is not None: + record.wf["name"] = new_name + self.renamed.append((run_id, new_name)) + self._emit_changed() + + def remove(self, run_id: str) -> None: + self._runs.pop(run_id, None) + self.removed_run_ids.append(run_id) + self._emit_changed() + + def clear_finished(self) -> None: + for run_id in [r for r, rec in self._runs.items() if not rec.running and self._belongs(rec)]: + self._runs.pop(run_id, None) + self._emit_changed() + + # ---- queries ---------------------------------------------------------- + def _belongs(self, r: RunRecord) -> bool: + return getattr(r, "project_id", "") == self._project_id + + def runs(self) -> List[RunRecord]: + return [r for r in self._runs.values() if self._belongs(r)] + + def all_runs(self) -> List[RunRecord]: + return list(self._runs.values()) + + def get(self, run_id: str) -> Optional[RunRecord]: + return self._runs.get(run_id) + + def active_count(self) -> int: + return sum(1 for r in self._runs.values() if r.running and self._belongs(r)) + + def set_current_project(self, project_id: str) -> None: + pid = project_id or "" + if pid != self._project_id: + self._project_id = pid + self._emit_changed() + + def set_output_root(self, root) -> None: + self._output_root = Path(root) if root else None diff --git a/tests/test_build_co4e_tab.py b/tests/test_build_co4e_tab.py new file mode 100644 index 0000000..6b68269 --- /dev/null +++ b/tests/test_build_co4e_tab.py @@ -0,0 +1,102 @@ +"""Smoke test cho ``presentation.co4e.co4e_tab.build_co4e_tab`` — gọi thật +factory, dựng thật ``Co4ETab``, xác nhận nó không vỡ. + +Vì sao chạy trong tiến trình con thay vì import thẳng trong tiến trình pytest +chính: ``CONFIG_DIR`` (config.py) và ``CO4E_DIR`` (core/co4e.py) đều là hằng số +module tính MỘT LẦN lúc import từ ``Path.home()``. Nhiều file test khác trong +bộ này (chạy trước theo thứ tự collect) đã import ``cowork_local.config``/ +``cowork_local.core.co4e`` với HOME thật rồi — monkeypatch thuộc tính module +(cách ``tests/characterization/test_co4e_run_manager_behavior.py`` dùng cho +``CO4E_DIR``) chỉ vá được đúng chỗ đó, còn ``AppConfig.load()`` có thêm một bẫy +riêng: tham số mặc định ``path: Path = CONFIG_PATH`` được gán MỘT LẦN lúc định +nghĩa hàm, nên monkeypatch ``CONFIG_PATH`` sau đó không đổi được giá trị mặc +định đã đóng băng — gọi ``AppConfig.load()`` không tham số vẫn đọc file thật +dù đã vá module. Dựng ``Co4ETab`` thật kéo theo cả hai đường trên (và có thể +còn đường khác chưa biết, vì lớp này 2000+ dòng). Cô lập bằng biến môi trường +``HOME``/``USERPROFILE`` TRƯỚC bất kỳ import nào, trong một tiến trình con +sạch hoàn toàn, né được toàn bộ lớp bẫy này một lần — không cần biết hết mọi +hằng số tính lúc import ở đâu trong file 2000+ dòng đó. + +Bắt được gì: đổi sai độ sâu dấu chấm ở import tương đối trong +``presentation/co4e/co4e_tab.py`` (``from ...ui.co4e_tab import Co4ETab``), +đổi chữ ký ``Co4ETab.__init__`` mà quên sửa lệnh gọi trong factory, hoặc +factory trả sai kiểu/sai ``ctx`` — không có test nào khác trong bộ này gọi +``build_co4e_tab()``, nên đây là lưới an toàn DUY NHẤT cho hàm này. + +KHÔNG chạm dữ liệu thật: sandbox trống hoàn toàn, không copy +``~/.cowork_local`` thật (khác ``tools/capture_screens.py::_isolate_home()`` — +ở đó cố tình copy để chụp ảnh có dữ liệu mẫu; ở đây không cần, càng sạch càng +tốt cho một smoke test). +""" +from __future__ import annotations + +import os +import subprocess +import sys +from pathlib import Path + +REPO_ROOT = Path(__file__).resolve().parent.parent +REPO_PARENT = REPO_ROOT.parent + +_SMOKE_SCRIPT = """ +import sys +sys.path.insert(0, {repo_parent!r}) + +from PySide6.QtWidgets import QApplication, QWidget + +from cowork_local.config import AppConfig, CONFIG_DIR +from cowork_local.state import AppContext +from cowork_local.presentation.co4e.co4e_tab import build_co4e_tab + +sandbox = sys.argv[1] +assert str(CONFIG_DIR).startswith(sandbox), "khong co lap: CONFIG_DIR=" + str(CONFIG_DIR) + +app = QApplication([]) +ctx = AppContext(AppConfig.load()) + + +class _FakeWorkflowService: + \"\"\"Chua dung toi trong than ham build_co4e_tab hien tai (xem docstring + cua factory) - chi can mot doi tuong bat ky de kiem factory nhan dung + tham so bat buoc thu hai.\"\"\" + + +widget = build_co4e_tab(ctx, _FakeWorkflowService()) +assert isinstance(widget, QWidget), "khong phai QWidget: " + repr(type(widget)) +assert widget.ctx is ctx, "factory khong gan dung ctx cho widget tra ve" +print("SMOKE_OK") +""" + + +def test_build_co4e_tab_dung_that_va_gan_dung_ctx(tmp_path): + sandbox = tmp_path / "home" + sandbox.mkdir() + + env = dict(os.environ) + env["HOME"] = str(sandbox) + env["USERPROFILE"] = str(sandbox) + env["QT_QPA_PLATFORM"] = "offscreen" + env.pop("HOMEDRIVE", None) + env.pop("HOMEPATH", None) + + script = _SMOKE_SCRIPT.format(repo_parent=str(REPO_PARENT)) + result = subprocess.run( + [sys.executable, "-c", script, str(sandbox)], + cwd=str(REPO_ROOT), + env=env, + capture_output=True, + text=True, + timeout=60, + ) + + assert result.returncode == 0, ( + f"smoke build_co4e_tab that bai (exit {result.returncode}):\n" + f"--- stdout ---\n{result.stdout}\n--- stderr ---\n{result.stderr}" + ) + assert "SMOKE_OK" in result.stdout, result.stdout + + # Sandbox khong duoc dung: chua co gi ghi vao no truoc khi tien trinh con + # chay (con AppConfig.load() khong ghi gi ca - chi save() moi ghi). + assert not (sandbox / ".cowork_local").exists(), ( + "AppConfig.load() khong duoc tu tao thu muc config that trong sandbox" + ) diff --git a/tests/test_co4e_integration.py b/tests/test_co4e_integration.py new file mode 100644 index 0000000..ccecac7 --- /dev/null +++ b/tests/test_co4e_integration.py @@ -0,0 +1,138 @@ +"""Integration test đầu-cuối cho Co4E Studio — dựng THẬT ``Co4ETab`` qua +``build_co4e_tab()`` và lái một luồng người dùng thật xuyên qua NHIỀU panel đã +tách (canvas, chat, agent/skills list, run control) trong CÙNG MỘT instance, +để bắt lỗi mà các characterization test riêng từng panel (test_co4e_canvas_widget, +test_co4e_chat_view, test_co4e_runs_page, test_co4e_agent_panel, +test_co4e_skills_panel) không thể bắt: các panel đó mỗi cái dựng ĐỘC LẬP, không +đi qua ``Co4ETab`` thật nên không lộ lỗi wiring xuyên-panel (ví dụ: alias thiếu, +gọi nhầm panel khác, state canvas mất khi chuyển qua trang Runs rồi quay lại). + +PHẠM VI CHỦ ĐỘNG LOẠI TRỪ — KHÔNG bấm nút Run/Stop và KHÔNG gọi bất kỳ +method nào dẫn tới ``Co4ERunManager.start()`` (dòng dẫn tới ``AgentWorker``/ +``QThread``/gọi AI thật) — đúng nguyên tắc đã áp dụng xuyên suốt mọi +characterization test của lane N3 (xem ``test_co4e_run_manager_behavior.py``). +Trang "Flow Status"/Runs được kiểm ở trạng thái RỖNG (không có run nào), đủ để +xác nhận panel + wiring không vỡ khi chuyển trang, không cần một run thật. + +Vì sao chạy trong tiến trình con cô lập HOME/USERPROFILE (giống +``test_build_co4e_tab.py``, xem docstring đầu file đó để biết đủ cả 2 cái bẫy +CONFIG_DIR/CONFIG_PATH tính lúc import): dựng ``Co4ETab`` thật kéo theo +``Co4ERunManager`` (đọc lịch sử run từ ``CO4E_DIR``/``CONFIG_DIR`` lúc +``__init__``) — không cô lập sẽ đọc/ghi vào ``~/.cowork_local`` thật của người +dùng chạy test. +""" +from __future__ import annotations + +import os +import subprocess +import sys +from pathlib import Path + +REPO_ROOT = Path(__file__).resolve().parent.parent +REPO_PARENT = REPO_ROOT.parent + +_SCRIPT = """ +import sys +sys.path.insert(0, {repo_parent!r}) + +from PySide6.QtWidgets import QApplication + +from cowork_local.config import AppConfig, CONFIG_DIR +from cowork_local.state import AppContext +from cowork_local.core.co4e import Step +from cowork_local.presentation.co4e.co4e_tab import build_co4e_tab + +sandbox = sys.argv[1] +assert str(CONFIG_DIR).startswith(sandbox), "khong co lap: CONFIG_DIR=" + str(CONFIG_DIR) + +app = QApplication([]) +ctx = AppContext(AppConfig.load()) + + +class _FakeWorkflowService: + \"\"\"build_co4e_tab() hien tai chua dung toi (xem presentation/co4e/co4e_tab.py) - + chi can mot doi tuong bat ky de kiem factory nhan dung tham so bat buoc thu hai.\"\"\" + + +tab = build_co4e_tab(ctx, _FakeWorkflowService()) + +# ---- 1) sidebar: 4 panel da tach deu co mat, danh sach rong luc moi dung --- +assert tab.wf_list.count() == 0, "wf_list phai rong luc moi dung" +assert tab.agent_list.count() >= 0 # AgentListPanel.list_widget qua alias +assert tab.skill_list.count() >= 0 # SkillsListPanel.list_widget qua alias +assert tab.runs_table.rowCount() == 0, "Flow Status phai rong khi chua co run nao" + +# ---- 2) "New" workflow (wf_new_btn -> _new_workflow) ----------------------- +tab.wf_new_btn.click() +assert tab.canvas.nodes() == [], "flow moi phai la canvas rong" +assert tab._wf.name, "flow moi phai co ten (untitled)" + +# ---- 3) them 2 node ket noi tren canvas THAT (khong drag-drop, goi truc tiep +# dung method public da duoc characterization test_co4e_canvas_widget.py khoa +# hanh vi - integration test nay chi kiem NO CHAY DUOC xuyen qua Co4ETab thuc, +# khong lap lai chi tiet hanh vi canvas) -------------------------------------- +n1 = tab.canvas.add_node(Step(label="Buoc 1"), x=60, y=60) +n2_id = None +tab.canvas.add_step_below(n1) +assert len(tab.canvas.nodes()) == 2, "canvas phai co 2 node sau add_node + add_step_below" +assert len(tab.canvas.edges()) == 1, "add_step_below phai tu noi edge tu node truoc" + +# ---- 4) mo/thu gon khung chat (ChatPanel + _toggle_messages xuyen panel) --- +assert tab.chat_stack.isHidden(), "chat phai COLLAPSED mac dinh (dung dac ta ChatPanel)" +tab.chat_toggle_btn.click() +assert not tab.chat_stack.isHidden(), "bam nut thu/mo phai HIEN khung chat" +tab.chat_toggle_btn.click() +assert tab.chat_stack.isHidden(), "bam lan 2 phai AN lai (toggle dung 2 chieu)" + +# ---- 5) chuyen qua trang Flow Status (RunsPagePanel) roi quay lai flow editor, +# xac nhan canvas KHONG mat 2 node da them o buoc 3 (rui ro thuc su cua viec +# tach RunsPagePanel: state flow co song sot qua center_stack.setCurrentIndex?) +tab.runs_btn.setChecked(True) +assert tab.center_stack.currentIndex() == 0, "bam Flow Status phai chuyen sang trang Runs" +assert tab.runs_table.rowCount() == 0, "van chua co run nao, bang phai rong" +tab.runs_btn.setChecked(False) +assert tab.center_stack.currentIndex() == 1, "bo chon Flow Status phai tro lai flow editor" +assert len(tab.canvas.nodes()) == 2, "quay lai flow editor KHONG duoc mat node da them truoc do" + +# ---- CHU DINH KHONG lam: khong bam run_stop_btn/bat ky nut Run nao, khong goi +# tab.manager.start(...) - do se tao AgentWorker/QThread thuc va co the goi AI +# thuc (ngoai pham vi integration test nay, xem docstring dau file). + +print("INTEGRATION_OK") +""" + + +def test_co4e_end_to_end_qua_nhieu_panel_da_tach(tmp_path): + sandbox = tmp_path / "home" + sandbox.mkdir() + + env = dict(os.environ) + env["HOME"] = str(sandbox) + env["USERPROFILE"] = str(sandbox) + env["QT_QPA_PLATFORM"] = "offscreen" + env.pop("HOMEDRIVE", None) + env.pop("HOMEPATH", None) + + script = _SCRIPT.format(repo_parent=str(REPO_PARENT)) + result = subprocess.run( + [sys.executable, "-c", script, str(sandbox)], + cwd=str(REPO_ROOT), + env=env, + capture_output=True, + text=True, + timeout=60, + ) + + assert result.returncode == 0, ( + f"integration test that bai (exit {result.returncode}):\n" + f"--- stdout ---\n{result.stdout}\n--- stderr ---\n{result.stderr}" + ) + assert "INTEGRATION_OK" in result.stdout, result.stdout + + # Sandbox khong duoc dung: khong co run nao duoc kich hoat trong luot nay, + # nen Co4ERunManager khong co gi de ghi xuong dia (_save_history chi ghi khi + # changed.emit() that su co run/thay doi - _new_workflow khong dung toi + # manager, add_node/canvas khong dung toi manager). + assert not (sandbox / ".cowork_local" / "co4e" / "run_history.json").exists(), ( + "chua co run nao thi khong duoc tu ghi lich su run xuong dia" + ) diff --git a/tests/test_co4e_workflow_service.py b/tests/test_co4e_workflow_service.py new file mode 100644 index 0000000..3bd7f0e --- /dev/null +++ b/tests/test_co4e_workflow_service.py @@ -0,0 +1,577 @@ +"""Test đặc tả cho phần vừa tách khỏi ``core/co4e_run_manager.py``: + + * ``domain/workflows/run_record.py::RunRecord`` — DTO thuần domain. + * ``application/workflows/co4e_workflow_service.py::Co4EWorkflowService`` — + phần hành vi (hook + lifecycle + lưu lịch sử), thuần Python. + +Khác với ``tests/characterization/test_co4e_run_manager_behavior.py`` (bọc lớp +CŨ, không được sửa), file này bọc lớp MỚI, và có thêm một test bắt buộc theo +yêu cầu tách: ``test_new_service_produces_same_json_record_as_old_manager`` — +chạy CÙNG một chuỗi thao tác trên CẢ HAI lớp (cũ và mới) với cùng input, rồi so +JSON ghi ra đĩa của chúng bằng nhau. Đây là bằng chứng "hành vi không lệch" +chạy được, không phải suy luận bằng mắt. + +Không gọi ``Co4EWorkflowService.start()`` với ``runner=None`` bỏ qua — luôn +truyền ``runner`` fake không thực thi job thật (không gọi AI thật), giống lý do +``test_co4e_run_manager_behavior.py`` không bao giờ gọi ``Co4ERunManager.start()`` +thật. +""" +from __future__ import annotations + +import json +from pathlib import Path + +import pytest + +from cowork_local.application.workflows.co4e_workflow_service import Co4EWorkflowService +from cowork_local.core.co4e import Node, Step, Workflow +from cowork_local.domain.workflows.run_record import RunRecord + + +class _FakeConfig: + def __init__(self, output_dir: Path): + self._output_dir = output_dir + + def cowork_output_dir(self) -> Path: + return self._output_dir + + +class _Ctx: + """Stub ctx: chỉ ``start()``/``_out_dir()`` mới đụng ``ctx.config``.""" + + def __init__(self, output_dir: Path): + self.config = _FakeConfig(output_dir) + + +class _RecordingRunner: + """Fake ``WorkflowRunner`` — ghi lại lời gọi ``start()``, KHÔNG thực thi + ``job`` (job thật gọi ``core.co4e_runner.run_workflow`` -> AI thật, tốn + tiền/ghi file thật, đúng lý do old characterization test tránh gọi + ``Co4ERunManager.start()``). Trả một handle giả để test ``stop()``.""" + + def __init__(self): + self.calls = [] + + def start(self, run_id, job, on_event, on_finished, on_failed): + handle = _FakeWorkerHandle() + self.calls.append((run_id, job, on_event, on_finished, on_failed, handle)) + return handle + + +class _FakeWorkerHandle: + def __init__(self): + self.stop_requested = False + + def request_stop(self): + self.stop_requested = True + + +def _make_workflow(node_count: int = 3, wf_id: str = "wf1", name: str = "Flow") -> Workflow: + # Dung dung dataclass that (core/co4e.py) thay vi stub -- workflow_to_dict() + # trong Co4EWorkflowService.start() doc n.id/n.x/n.y/n.data tren tung node + # va wf.is_template tren workflow, khong the gia lap bang string/duck-type + # thieu thuoc tinh. + nodes = [Node(id=f"n{i}", x=0.0, y=0.0, data=Step(label=f"Step{i}")) for i in range(1, node_count + 1)] + return Workflow(id=wf_id, name=name, nodes=nodes, edges=[]) + + +@pytest.fixture +def service(tmp_path): + return Co4EWorkflowService(_Ctx(tmp_path), history_path=tmp_path / "run_history.json") + + +def _seed(service: Co4EWorkflowService, run_id: str, **kw) -> RunRecord: + defaults = dict(wf_id="wf1", name="Flow", total=3, plan_mode=False, manual=False) + defaults.update(kw) + r = RunRecord(run_id, **defaults) + service._runs[run_id] = r + return r + + +# --------------------------------------------------------------------------- +# RunRecord: gia tri mac dinh / kep bien / round trip (khop ban cu) +# --------------------------------------------------------------------------- + +def test_run_record_defaults_on_construction(): + r = RunRecord("run1", "wf1", "My Flow", 3, False, False) + assert r.status == "running" + assert r.done == 0 + assert r.progress_text() == "0/3" + assert r.running is True + + +def test_run_record_negative_total_clamped_to_zero(): + r = RunRecord("run2", "wf2", "Flow2", -5, False, False) + assert r.total == 0 + + +def test_run_record_zero_total_progress_text_falls_back_to_status(): + r = RunRecord("run3", "wf3", "Flow3", 0, False, False) + assert r.progress_text() == "running" + + +def test_to_dict_contains_expected_keys_and_values(): + r = RunRecord("run1", "wf1", "My Flow", 3, False, False, + created_by="alice", created_at="2026-08-23 10:00", project_id="p1") + rec = r.to_dict() + assert sorted(rec.keys()) == [ + "created_at", "created_by", "done", "error", "id", "manual", "name", + "node_status", "out_dir", "plan_mode", "project_id", "status", "total", + "wf", "wf_id", + ] + assert rec["id"] == "run1" + assert rec["status"] == "running" + assert rec["wf"] is None + + +def test_round_trip_status_running_becomes_stopped(): + r = RunRecord("run1", "wf1", "My Flow", 3, False, False) + rec = r.to_dict() + assert rec["status"] == "running" + back = RunRecord.from_dict(rec) + assert back.status == "stopped" + + +@pytest.mark.parametrize("status", ["done", "error", "stopped"]) +def test_round_trip_non_running_statuses_are_preserved(status): + r = RunRecord("run1", "wf1", "My Flow", 3, False, False) + r.status = status + back = RunRecord.from_dict(r.to_dict()) + assert back.status == status + + +def test_from_dict_empty_dict_uses_documented_defaults(): + r = RunRecord.from_dict({}) + assert r.id == "" + assert r.status == "done" + assert r.wf is None + assert r.node_status == {} + + +def test_from_dict_none_treated_same_as_empty_dict(): + assert RunRecord.from_dict(None).id == RunRecord.from_dict({}).id + assert RunRecord.from_dict(None).status == RunRecord.from_dict({}).status + + +def test_round_trip_preserves_raw_workflow_snapshot_dict(): + # domain khong parse "wf" thanh doi tuong -- giu nguyen dict tho (khac + # RunHandle cu, xem docstring domain/workflows/run_record.py). + r = RunRecord("run4", "wf-x", "Flow X run", 1, False, False) + r.wf = {"id": "wf-x", "name": "Flow X", "nodes": [{"id": "n1"}], "edges": []} + back = RunRecord.from_dict(r.to_dict()) + assert back.wf == r.wf + assert isinstance(back.wf, dict) + + +# --------------------------------------------------------------------------- +# _on_event / _on_finished / _on_failed (hanh vi khop ban cu, callback thay Signal) +# --------------------------------------------------------------------------- + +def test_on_event_node_status_done_increments_progress_and_emits_changed(service): + r = _seed(service, "run1") + changed = [] + service.on_changed(lambda: changed.append(1)) + service._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "done"}) + assert r.node_status == {"n1": "done"} + assert r.done == 1 + assert len(changed) == 1 + + +def test_on_event_node_status_planned_counts_as_terminal_too(service): + r = _seed(service, "run1") + service._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "planned"}) + assert r.done == 1 + + +def test_on_event_node_status_running_is_not_terminal(service): + r = _seed(service, "run1") + service._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "running"}) + assert r.done == 0 + + +def test_on_event_node_status_missing_keys_stores_none_key(service): + r = _seed(service, "run1") + service._on_event("run1", {"type": "node_status"}) + assert r.node_status == {None: None} + + +def test_on_event_run_done_default_ok_marks_done(service): + r = _seed(service, "run1") + service._on_event("run1", {"type": "run_done"}) + assert r.status == "done" + + +def test_on_event_run_done_ok_false_marks_error(service): + r = _seed(service, "run1") + service._on_event("run1", {"type": "run_done", "ok": False}) + assert r.status == "error" + + +def test_on_event_run_done_ignored_when_not_running(service): + r = _seed(service, "run1") + r.status = "stopped" + service._on_event("run1", {"type": "run_done", "ok": False}) + assert r.status == "stopped" + + +def test_on_event_unknown_run_id_does_not_raise_and_still_reemits_event(service): + received = [] + service.on_event(lambda rid, ev: received.append((rid, ev))) + service._on_event("no-such-run", {"type": "node_status", "node_id": "n1", "status": "done"}) + assert received == [("no-such-run", {"type": "node_status", "node_id": "n1", "status": "done"})] + + +def test_on_event_none_payload_does_not_raise_and_reemits_none(service): + # Khac ban cu (Qt ep None -> {} do Signal(str, dict)): o day khong con + # Signal nen callback nhan DUNG gia tri goc None. Xem comment trong + # co4e_workflow_service.py::_on_event ve ly do khong gia lap lai viec ep + # kieu do. + _seed(service, "run1") + received = [] + service.on_event(lambda rid, ev: received.append((rid, ev))) + service._on_event("run1", None) + assert received == [("run1", None)] + + +def test_on_finished_while_running_settles_to_done(service): + r = _seed(service, "run1") + changed = [] + service.on_changed(lambda: changed.append(1)) + service._on_finished("run1") + assert r.status == "done" + assert len(changed) == 1 + + +def test_on_finished_when_already_settled_is_a_noop(service): + r = _seed(service, "run1") + r.status = "error" + changed = [] + service.on_changed(lambda: changed.append(1)) + service._on_finished("run1") + assert r.status == "error" + assert len(changed) == 0 + + +def test_on_finished_unknown_run_id_is_a_total_noop(service): + changed = [] + service.on_changed(lambda: changed.append(1)) + service._on_finished("no-such-run") + assert service._runs == {} + assert changed == [] + + +def test_on_failed_marks_error_with_message_and_emits_run_error_event(service): + r = _seed(service, "run1") + events = [] + changed = [] + service.on_event(lambda rid, ev: events.append((rid, ev))) + service.on_changed(lambda: changed.append(1)) + service._on_failed("run1", "boom") + assert r.status == "error" + assert r.error == "boom" + assert events == [("run1", {"type": "run_error", "error": "boom"})] + assert len(changed) == 1 + + +def test_on_failed_overrides_status_even_when_already_settled(service): + r = _seed(service, "run1") + r.status = "done" + service._on_failed("run1", "late failure") + assert r.status == "error" + + +def test_on_failed_unknown_run_id_is_a_total_noop(service): + events = [] + changed = [] + service.on_event(lambda rid, ev: events.append((rid, ev))) + service.on_changed(lambda: changed.append(1)) + service._on_failed("no-such-run", "err") + assert events == [] + assert changed == [] + + +# --------------------------------------------------------------------------- +# persistence: hook -> dia -> from_dict round trip +# --------------------------------------------------------------------------- + +def test_changed_hook_persists_to_history_file(service, tmp_path): + _seed(service, "run1") + service._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "done"}) + path = tmp_path / "run_history.json" + assert path.exists() + data = json.loads(path.read_text(encoding="utf-8")) + assert len(data["runs"]) == 1 + assert data["runs"][0]["id"] == "run1" + assert data["runs"][0]["status"] == "running" + + +def test_reloading_service_after_hook_settles_running_to_stopped(tmp_path): + history_path = tmp_path / "run_history.json" + s1 = Co4EWorkflowService(_Ctx(tmp_path), history_path=history_path) + _seed(s1, "run1") + s1._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "done"}) + + s2 = Co4EWorkflowService(_Ctx(tmp_path), history_path=history_path) + assert "run1" in s2._runs + assert s2._runs["run1"].status == "stopped" + assert s2._seq == 1 + + +def test_reloaded_seq_avoids_colliding_with_history_ids(tmp_path): + history_path = tmp_path / "run_history.json" + s1 = Co4EWorkflowService(_Ctx(tmp_path), history_path=history_path) + _seed(s1, "run7") + s1._on_event("run7", {"type": "node_status", "node_id": "n1", "status": "done"}) + + s2 = Co4EWorkflowService(_Ctx(tmp_path), history_path=history_path) + assert s2._seq == 7 + assert s2._next_id() == "run8" + + +def test_load_history_missing_file_is_silent_noop(tmp_path): + s = Co4EWorkflowService(_Ctx(tmp_path), history_path=tmp_path / "does-not-exist.json") + assert s._runs == {} + assert s._seq == 0 + + +# --------------------------------------------------------------------------- +# start() qua WorkflowRunner Protocol (khong QThread, khong AI that) +# --------------------------------------------------------------------------- + +def test_start_registers_run_and_delegates_to_injected_runner(tmp_path): + runner = _RecordingRunner() + s = Co4EWorkflowService(_Ctx(tmp_path), history_path=tmp_path / "h.json", runner=runner) + changed = [] + s.on_changed(lambda: changed.append(1)) + + run_id = s.start(_make_workflow(node_count=2)) + + assert run_id == "run1" + record = s.get(run_id) + assert record is not None + assert record.status == "running" + assert record.total == 2 + assert record.wf["id"] == "wf1" + assert record.wf["name"] == "Flow" + assert len(record.wf["nodes"]) == 2 + assert len(runner.calls) == 1 + assert runner.calls[0][0] == run_id + assert len(changed) == 1 + + +def test_start_with_only_nodes_uses_its_length_as_total(tmp_path): + runner = _RecordingRunner() + s = Co4EWorkflowService(_Ctx(tmp_path), history_path=tmp_path / "h.json", runner=runner) + run_id = s.start(_make_workflow(node_count=3), only_nodes={"n1", "n2"}) + assert s.get(run_id).total == 2 + + +def test_start_without_runner_still_registers_run_but_no_job_delegated(tmp_path): + s = Co4EWorkflowService(_Ctx(tmp_path), history_path=tmp_path / "h.json") # runner=None mac dinh + run_id = s.start(_make_workflow()) + assert s.get(run_id) is not None + assert s.get(run_id).status == "running" + + +def test_stop_calls_runner_handle_request_stop(tmp_path): + runner = _RecordingRunner() + s = Co4EWorkflowService(_Ctx(tmp_path), history_path=tmp_path / "h.json", runner=runner) + run_id = s.start(_make_workflow()) + handle = runner.calls[0][5] + s.stop(run_id) + assert handle.stop_requested is True + assert s.get(run_id).status == "stopped" + + +def test_stop_running_run_emits_changed(tmp_path): + # Bite-test: neu ai xoa self._emit_changed() ben trong stop(), test nay + # phai do (khac assertion ve status/stop_requested o test ben tren, von + # khong dung toi len goi on_changed()). + runner = _RecordingRunner() + s = Co4EWorkflowService(_Ctx(tmp_path), history_path=tmp_path / "h.json", runner=runner) + run_id = s.start(_make_workflow()) + changed = [] + s.on_changed(lambda: changed.append(1)) + s.stop(run_id) + assert len(changed) == 1 + + +def test_stop_non_running_run_is_noop_and_does_not_emit_changed(tmp_path): + runner = _RecordingRunner() + s = Co4EWorkflowService(_Ctx(tmp_path), history_path=tmp_path / "h.json", runner=runner) + run_id = s.start(_make_workflow()) + s.get(run_id).status = "done" + changed = [] + s.on_changed(lambda: changed.append(1)) + s.stop(run_id) + assert changed == [] + + +def test_rename_updates_name_and_wf_dict_and_emits_changed(service): + r = _seed(service, "run1") + r.wf = {"id": "wf1", "name": "Old", "nodes": [], "edges": []} + changed = [] + service.on_changed(lambda: changed.append(1)) + service.rename("run1", "New Name") + assert r.name == "New Name" + assert r.wf["name"] == "New Name" + assert len(changed) == 1 + + +def test_rename_blank_name_is_noop_and_does_not_emit_changed(service): + r = _seed(service, "run1", name="Flow") + changed = [] + service.on_changed(lambda: changed.append(1)) + service.rename("run1", " ") + assert r.name == "Flow" + assert changed == [] + + +def test_rename_same_name_is_noop_and_does_not_emit_changed(service): + _seed(service, "run1", name="Flow") + changed = [] + service.on_changed(lambda: changed.append(1)) + service.rename("run1", "Flow") + assert changed == [] + + +def test_rename_unknown_run_id_is_noop_and_does_not_emit_changed(service): + changed = [] + service.on_changed(lambda: changed.append(1)) + service.rename("no-such-run", "New Name") + assert changed == [] + + +def test_remove_running_run_stops_it_then_removes_and_emits_changed_twice(tmp_path): + # remove() goi stop() (rieng no da emit mot lan) roi tu emit them mot lan + # sau khi pop -- 2 la con so dung khop ban cu (core/co4e_run_manager.py:: + # remove), khong phai 1. + runner = _RecordingRunner() + s = Co4EWorkflowService(_Ctx(tmp_path), history_path=tmp_path / "h.json", runner=runner) + run_id = s.start(_make_workflow()) + handle = runner.calls[0][5] + changed = [] + s.on_changed(lambda: changed.append(1)) + s.remove(run_id) + assert handle.stop_requested is True + assert s.get(run_id) is None + assert len(changed) == 2 + + +def test_remove_non_running_run_emits_changed_once(service): + r = _seed(service, "run1") + r.status = "done" + changed = [] + service.on_changed(lambda: changed.append(1)) + service.remove("run1") + assert service.get("run1") is None + assert len(changed) == 1 + + +def test_clear_finished_emits_changed_even_with_no_matching_runs(service): + # Ban cu luon emit sau vong lap, ke ca khi khong xoa gi -- giu quirk nay. + changed = [] + service.on_changed(lambda: changed.append(1)) + service.clear_finished() + assert len(changed) == 1 + + +def test_clear_finished_removes_only_finished_runs_of_current_project(service): + r1 = _seed(service, "run1") + r1.status = "done" + r2 = _seed(service, "run2") + r2.status = "running" + changed = [] + service.on_changed(lambda: changed.append(1)) + service.clear_finished() + assert "run1" not in service._runs + assert "run2" in service._runs + assert len(changed) == 1 + + +def test_set_current_project_changes_pid_and_emits_changed(service): + changed = [] + service.on_changed(lambda: changed.append(1)) + service.set_current_project("proj1") + assert service._project_id == "proj1" + assert len(changed) == 1 + + +def test_set_current_project_same_pid_is_noop_and_does_not_emit_changed(service): + service.set_current_project("proj1") + changed = [] + service.on_changed(lambda: changed.append(1)) + service.set_current_project("proj1") + assert changed == [] + + +# --------------------------------------------------------------------------- +# Bang chung "hanh vi khong lech": cung input -> cung JSON tren dia, ca lop +# cu (core/co4e_run_manager.py) lan lop moi (application/workflows/...). +# --------------------------------------------------------------------------- + +def test_new_service_produces_same_json_record_as_old_manager(tmp_path, monkeypatch): + from cowork_local.core import co4e as _co4e_module + from cowork_local.core.co4e_run_manager import Co4ERunManager, RunHandle as OldRunHandle + + # Co lap CO4E_DIR cho manager cu bang cach patch THUOC TINH MODULE (dung ky + # thuat cua tests/characterization/test_co4e_run_manager_behavior.py, xem + # docstring dau file do ve ly do KHONG dung bien moi truong truoc luc + # import: _history_path() doc lai CO4E_DIR tuoi ngay luc goi ham). + monkeypatch.setattr(_co4e_module, "CO4E_DIR", tmp_path / "old_home" / ".cowork_local" / "co4e") + old_history = tmp_path / "old_history.json" + monkeypatch.setattr(Co4ERunManager, "_history_path", lambda self: old_history) + + class _OldCtx: + pass + + old_mgr = Co4ERunManager(_OldCtx()) + old_mgr._runs["run1"] = OldRunHandle( + "run1", "wf1", "Flow", 3, False, False, + created_by="alice", created_at="2026-08-23 10:00", project_id="p1", + ) + old_mgr._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "done"}) + old_mgr._on_event("run1", {"type": "node_status", "node_id": "n2", "status": "running"}) + old_mgr._on_event("run1", {"type": "run_done", "ok": True}) + old_record = json.loads(old_history.read_text(encoding="utf-8"))["runs"][0] + + new_history = tmp_path / "new_history.json" + new_svc = Co4EWorkflowService(_Ctx(tmp_path), history_path=new_history) + new_svc._runs["run1"] = RunRecord( + "run1", "wf1", "Flow", 3, False, False, + created_by="alice", created_at="2026-08-23 10:00", project_id="p1", + ) + new_svc._on_event("run1", {"type": "node_status", "node_id": "n1", "status": "done"}) + new_svc._on_event("run1", {"type": "node_status", "node_id": "n2", "status": "running"}) + new_svc._on_event("run1", {"type": "run_done", "ok": True}) + new_record = json.loads(new_history.read_text(encoding="utf-8"))["runs"][0] + + assert new_record == old_record + + +def test_new_service_reload_quirk_matches_old_manager_reload_quirk(tmp_path, monkeypatch): + """Cung quirk round-trip khong doi xung ('running' -> 'stopped' sau khi + doc lai tu dia) phai xay ra giong het nhau tren ca hai lop.""" + from cowork_local.core import co4e as _co4e_module + from cowork_local.core.co4e_run_manager import Co4ERunManager, RunHandle as OldRunHandle + + monkeypatch.setattr(_co4e_module, "CO4E_DIR", tmp_path / "old_home2" / ".cowork_local" / "co4e") + old_history = tmp_path / "old_history2.json" + monkeypatch.setattr(Co4ERunManager, "_history_path", lambda self: old_history) + + class _OldCtx: + pass + + old_mgr = Co4ERunManager(_OldCtx()) + old_mgr._runs["run7"] = OldRunHandle("run7", "wf1", "Flow", 2, False, False) + old_mgr._on_event("run7", {"type": "node_status", "node_id": "n1", "status": "done"}) + old_mgr2 = Co4ERunManager(_OldCtx()) + + new_history = tmp_path / "new_history2.json" + new_svc = Co4EWorkflowService(_Ctx(tmp_path), history_path=new_history) + new_svc._runs["run7"] = RunRecord("run7", "wf1", "Flow", 2, False, False) + new_svc._on_event("run7", {"type": "node_status", "node_id": "n1", "status": "done"}) + new_svc2 = Co4EWorkflowService(_Ctx(tmp_path), history_path=new_history) + + assert old_mgr2._runs["run7"].status == new_svc2._runs["run7"].status == "stopped" + assert old_mgr2._seq == new_svc2._seq == 7 diff --git a/ui/co4e_canvas.py b/ui/co4e_canvas.py index e47e1a7..dd20b76 100644 --- a/ui/co4e_canvas.py +++ b/ui/co4e_canvas.py @@ -12,780 +12,27 @@ Kept UI-only; the graph model lives in ``core/co4e.py``. """ from __future__ import annotations -import copy -import json -from typing import Dict, Optional - -from PySide6.QtCore import QPointF, QRectF, Qt, Signal -from PySide6.QtGui import QBrush, QColor, QPainterPath, QPen, QPolygonF -from PySide6.QtWidgets import ( - QGraphicsItem, QGraphicsObject, QGraphicsPathItem, QGraphicsScene, - QGraphicsView, QMenu, +# _NodeItem/_EdgeItem (hằng số vẽ + hai lớp QGraphicsItem) đã dời sang +# presentation/co4e/canvas_items.py; Co4ECanvas (mutation đồ thị) đã dời sang +# presentation/co4e/co4e_canvas_widget.py, phần tương tác view (zoom/pan/ +# relayout/phím tắt/kéo-thả) nằm trong _CanvasInteractionMixin cùng thư mục. +# Không đổi hành vi — xem characterization test cùng tên và docstring ở từng +# file đích. Import ĐÍCH DANH tên gốc, không alias — nếu đổi thành +# `import co4e_canvas_widget as _w` thì các chỗ gọi bên dưới (và cả test cũ) +# vẫn chạy được vì Python cho phép, nhưng lại sai mục đích của việc giữ nguyên +# tên: test characterization import trực tiếp các tên này TỪ module này, +# alias sẽ làm test đó ngưng chứng minh được điều nó cần chứng minh. +from ..presentation.co4e.canvas_items import ( + _NODE_H, _NODE_W, _PORT_HIT, _PORT_R, _EdgeItem, _NodeItem, _status_color, ) - -from ..core.co4e import ( - STEP_DONE, STEP_ERROR, STEP_PLANNED, STEP_RUNNING, Edge, Node, Step, - compute_waves, new_edge_id, new_node_id, +# 8 hàm hình học thuần đã dời sang canvas_geometry.py (không đổi hành vi, xem +# characterization test cùng tên). Import ĐÍCH DANH tên gốc, không alias — nếu +# đổi thành `import canvas_geometry as _g` thì các chỗ gọi bên dưới (và cả +# test cũ) vẫn chạy được vì Python cho phép, nhưng lại sai mục đích của việc +# giữ nguyên tên: test characterization import trực tiếp các tên này TỪ module +# này, alias sẽ làm test đó ngưng chứng minh được điều nó cần chứng minh. +from ..presentation.co4e.canvas_geometry import ( + _dist, _elide, _hits, _ortho_path, _route, _rounded_path, _seg_hits_rect, + _towards, ) -from ..theme import current_palette - - -def _status_color(status: str) -> str: - """Accent colour for a step's run status. Resolved per paint so the canvas - follows a live theme switch.""" - p = current_palette() - return { - "idle": p.text_muted, STEP_RUNNING: p.accent, STEP_DONE: p.success, - STEP_ERROR: p.danger, STEP_PLANNED: p.purple, "pending": p.text_faint, - }.get(status, p.text_muted) - -CO4E_MIME = "application/x-co4e-step" - -_NODE_W, _NODE_H = 210, 96 -_PORT_R = 6 # output port radius (the drag-to-connect handle) -_PORT_HIT = 15 # click tolerance around a port -_CORNER_R = 12 # edge elbow corner radius - - -class _NodeItem(QGraphicsObject): - """One draggable step card. Emits signals via the parent canvas.""" - - def __init__(self, node: Node, canvas: "Co4ECanvas"): - super().__init__() - self.node = node - self.canvas = canvas - self.status = "idle" - self._porting = False - self.setFlags(QGraphicsItem.ItemIsMovable | QGraphicsItem.ItemIsSelectable - | QGraphicsItem.ItemSendsGeometryChanges) - self.setAcceptHoverEvents(True) - self.setPos(node.x, node.y) - self.setZValue(2) - - def boundingRect(self) -> QRectF: - # slack left/right so the input/output ports (now on the sides) paint cleanly - return QRectF(-_PORT_R - 2, -3, _NODE_W + 2 * _PORT_R + 4, _NODE_H + 6) - - def _card_rect(self) -> QRectF: - return QRectF(1, 1, _NODE_W - 2, _NODE_H - 2) - - def paint(self, p, _opt, _widget=None): - tok = current_palette() - step = self.node.data - accent = QColor(_status_color(self.status)) - body = QColor(tok.surface_raised) - border = QColor(tok.accent) if self.isSelected() else QColor(tok.border) - p.setRenderHint(p.RenderHint.Antialiasing) - rect = self._card_rect() - path = QPainterPath() - radius = float(tok.radius_lg) - path.addRoundedRect(rect, radius, radius) - p.fillPath(path, QBrush(body)) - p.setPen(QPen(border, 2 if self.isSelected() else 1)) - p.drawPath(path) - # header stripe — a tint of the status colour, not the status colour - # itself, so the card's own text stays the brightest thing on it. - hdr = QRectF(rect.left(), rect.top(), rect.width(), 26) - hpath = QPainterPath() - hpath.addRoundedRect(hdr, radius, radius) - stripe = QColor(accent) - stripe.setAlpha(48) - p.fillPath(hpath, QBrush(stripe)) - # label - p.setPen(QColor(tok.text)) - f = p.font(); f.setBold(True); f.setPointSize(9); p.setFont(f) - p.drawText(QRectF(10, 4, _NODE_W - 20, 20), Qt.AlignVCenter | Qt.AlignLeft, - _elide(step.label, 26)) - # role badge + status - f.setBold(False); f.setPointSize(8); p.setFont(f) - p.setPen(accent) - p.drawText(QRectF(10, 30, _NODE_W - 20, 16), Qt.AlignLeft, step.role) - # body: instructions preview OR sub-agent chips - p.setPen(QColor(tok.text_muted)) - if step.is_parallel: - preview = "⇉ " + ", ".join(s.agent for s in step.sub_agents) if step.sub_agents else "⇉ (no sub-agents)" - else: - preview = step.instructions or "(no instructions)" - p.drawText(QRectF(10, 46, _NODE_W - 20, 30), Qt.TextWordWrap | Qt.AlignTop, - _elide(preview, 66)) - # footer: model + skills + status dot - p.setPen(QColor(tok.text_faint)) - foot = [] - if step.model: - foot.append(step.model) - if step.skills: - foot.append(f"skills:{len(step.skills)}") - foot.append(self.status) - p.drawText(QRectF(10, _NODE_H - 18, _NODE_W - 20, 14), Qt.AlignLeft, - _elide(" · ".join(foot), 34)) - # ---- ports --------------------------------------------------------- - # input port (top-center): hollow. output port (bottom-center): filled — - # the drag handle you pull to wire an edge to another step. - port_col = QColor(tok.accent) - # input port (left-center): hollow. output port (right-center): filled — - # the drag handle you pull to wire an edge to the next step (left→right). - p.setBrush(QBrush(body)); p.setPen(QPen(port_col, 1.4)) - p.drawEllipse(QPointF(1, _NODE_H / 2), _PORT_R - 1, _PORT_R - 1) - p.setBrush(QBrush(port_col)); p.setPen(QPen(port_col, 1.4)) - p.drawEllipse(QPointF(_NODE_W - 1, _NODE_H / 2), _PORT_R, _PORT_R) - - def _in_out_port(self, pos: QPointF) -> bool: - d = pos - QPointF(_NODE_W, _NODE_H / 2) - return (d.x() * d.x() + d.y() * d.y()) ** 0.5 <= _PORT_HIT - - def itemChange(self, change, value): - if change == QGraphicsItem.ItemPositionHasChanged: - self.node.x = float(self.pos().x()) - self.node.y = float(self.pos().y()) - self.canvas._reposition_edges() - self.canvas.graph_changed.emit() - elif change == QGraphicsItem.ItemSelectedHasChanged: - # a selected/edited node comes to the front (above the edges at z=3) - self.setZValue(4 if value else 2) - if value: - self.canvas.node_selected.emit(self.node.id) - return super().itemChange(change, value) - - def hoverMoveEvent(self, e): - # a hand cursor over the output port hints it's draggable-to-connect - self.setCursor(Qt.PointingHandCursor if self._in_out_port(e.pos()) else Qt.ArrowCursor) - super().hoverMoveEvent(e) - - def mousePressEvent(self, e): - if self.canvas._connect_from is not None: - self.canvas._finish_connect(self.node.id) - e.accept() - return - if e.button() == Qt.LeftButton and self._in_out_port(e.pos()): - # start a manual drag-to-connect from this node's output port - self._porting = True - self.canvas.begin_port_drag(self.node.id, self.mapToScene(QPointF(_NODE_W, _NODE_H / 2))) - e.accept() - return - super().mousePressEvent(e) - - def mouseMoveEvent(self, e): - if self._porting: - self.canvas.update_port_drag(self.mapToScene(e.pos())) - e.accept() - return - super().mouseMoveEvent(e) - - def mouseReleaseEvent(self, e): - if self._porting: - self._porting = False - self.canvas.finish_port_drag(self.mapToScene(e.pos())) - e.accept() - return - super().mouseReleaseEvent(e) - - def mouseDoubleClickEvent(self, e): - self.canvas.node_activated.emit(self.node.id) - e.accept() - - def contextMenuEvent(self, e): - menu = QMenu() - a_add = menu.addAction("＋ Add next step") - a_conn = menu.addAction("→ Connect from here") - a_del = menu.addAction("🗑 Delete step") - chosen = menu.exec(e.screenPos()) - if chosen is a_add: - self.canvas.add_step_below(self.node.id) - elif chosen is a_conn: - self.canvas.begin_connect(self.node.id) - elif chosen is a_del: - self.canvas.delete_node(self.node.id) - e.accept() - - def center(self) -> QPointF: - return self.pos() + QPointF(_NODE_W / 2, _NODE_H / 2) - - -def _dist(a: QPointF, b: QPointF) -> float: - return ((a.x() - b.x()) ** 2 + (a.y() - b.y()) ** 2) ** 0.5 - - -def _towards(a: QPointF, b: QPointF, d: float) -> QPointF: - dist = _dist(a, b) - if dist < 1e-6: - return QPointF(a) - t = d / dist - return QPointF(a.x() + (b.x() - a.x()) * t, a.y() + (b.y() - a.y()) * t) - - -def _rounded_path(points, r: float = _CORNER_R) -> QPainterPath: - """Build a path through axis-aligned ``points`` with rounded corners at each - bend ("vuông bo cong ở góc").""" - if not points: - return QPainterPath() - path = QPainterPath(points[0]) - if len(points) == 1: - return path - for i in range(1, len(points) - 1): - prev, cur, nxt = points[i - 1], points[i], points[i + 1] - rr = min(r, _dist(prev, cur) / 2.0, _dist(cur, nxt) / 2.0) - path.lineTo(_towards(cur, prev, rr)) - path.quadTo(cur, _towards(cur, nxt, rr)) - path.lineTo(points[-1]) - return path - - -def _seg_hits_rect(p1: QPointF, p2: QPointF, rect: QRectF) -> bool: - """Axis-aligned segment vs rectangle overlap (all routed segments are H or V).""" - x1, y1, x2, y2 = p1.x(), p1.y(), p2.x(), p2.y() - if abs(y1 - y2) < 0.5: # horizontal - if rect.top() <= y1 <= rect.bottom(): - lo, hi = sorted((x1, x2)) - return not (hi < rect.left() or lo > rect.right()) - return False - if abs(x1 - x2) < 0.5: # vertical - if rect.left() <= x1 <= rect.right(): - lo, hi = sorted((y1, y2)) - return not (hi < rect.top() or lo > rect.bottom()) - return False - box = QRectF(QPointF(min(x1, x2), min(y1, y2)), QPointF(max(x1, x2), max(y1, y2))) - return rect.intersects(box) - - -def _hits(points, obstacles) -> bool: - for i in range(len(points) - 1): - for r in obstacles: - if _seg_hits_rect(points[i], points[i + 1], r): - return True - return False - - -def _route(src: QPointF, dst: QPointF, obstacles=None): - """Waypoints for a LEFT→RIGHT orthogonal edge from ``src`` (a node's right - output) to ``dst`` (the next node's left input) that AVOIDS the other node - rectangles: try the straight elbow, then a clear vertical band, then a - top/bottom detour — so a connector never overlaps or hides behind a step.""" - obstacles = list(obstacles or []) - if abs(src.y() - dst.y()) < 1.5: - cand = [src, dst] - if not _hits(cand, obstacles): - return cand - mid_x = (src.x() + dst.x()) / 2.0 - base = [src, QPointF(mid_x, src.y()), QPointF(mid_x, dst.y()), dst] - if not _hits(base, obstacles): - return base - # 1) slide the vertical run to a clear band between the two columns - lo, hi = min(src.x(), dst.x()) + 6, max(src.x(), dst.x()) - 6 - if hi > lo: - for frac in (0.5, 0.35, 0.65, 0.2, 0.8): - x = lo + (hi - lo) * frac - cand = [src, QPointF(x, src.y()), QPointF(x, dst.y()), dst] - if not _hits(cand, obstacles): - return cand - # 2) detour above/below every obstacle, then back in - margin = 44.0 - ys = [src.y(), dst.y()] + [r.top() for r in obstacles] + [r.bottom() for r in obstacles] - out_x, in_x = src.x() + 34, dst.x() - 34 # short stubs out of the side ports - for side_y in (min(ys) - margin, max(ys) + margin): - cand = [src, QPointF(out_x, src.y()), QPointF(out_x, side_y), - QPointF(in_x, side_y), QPointF(in_x, dst.y()), dst] - if not _hits(cand, obstacles): - return cand - return base - - -def _ortho_path(src: QPointF, dst: QPointF, r: float = _CORNER_R) -> QPainterPath: - """Rounded orthogonal elbow (no obstacle avoidance) — used for the transient - drag-to-connect line and by callers that pass no obstacles.""" - return _rounded_path(_route(src, dst), r) - - -class _EdgeItem(QGraphicsPathItem): - def __init__(self, edge: Edge, canvas: "Co4ECanvas"): - super().__init__() - self.edge = edge - self.canvas = canvas - self._dst: Optional[QPointF] = None - # Above node cards (z=2) so a connecting line is never hidden behind a - # step; a selected node bumps itself to the front while being edited. - self.setZValue(3) - self.setFlag(QGraphicsItem.ItemIsSelectable, True) - self.setAcceptHoverEvents(True) - self._hover = False - self._apply_pen() - - def _apply_pen(self): - tok = current_palette() - if self.isSelected(): - color, w = QColor(tok.accent), 3 - elif self._hover: - color, w = QColor(tok.text_muted), 3 - else: - color, w = QColor(tok.border_strong), 2 - self.setPen(QPen(color, w, Qt.SolidLine, Qt.RoundCap, Qt.RoundJoin)) - - def update_path(self, points): - self._dst = points[-1] if points else None - self.setPath(_rounded_path(points)) - - def boundingRect(self): - return super().boundingRect().adjusted(-10, -10, 10, 10) # room for the arrowhead - - def shape(self): - # Widen the clickable/selectable area so a thin line is easy to grab. - from PySide6.QtGui import QPainterPathStroker - stroker = QPainterPathStroker() - stroker.setWidth(14) - return stroker.createStroke(self.path()) - - def hoverEnterEvent(self, e): - self._hover = True - self._apply_pen() - self.update() - super().hoverEnterEvent(e) - - def hoverLeaveEvent(self, e): - self._hover = False - self._apply_pen() - self.update() - super().hoverLeaveEvent(e) - - def paint(self, p, opt, widget=None): - self._apply_pen() - super().paint(p, opt, widget) - # arrowhead at the target, pointing right into its (left) input port - if self._dst is not None: - p.setRenderHint(p.RenderHint.Antialiasing) - tip = self._dst - s = 7.0 - tri = QPolygonF([ - QPointF(tip.x() + 1, tip.y()), - QPointF(tip.x() - s, tip.y() - s * 0.7), - QPointF(tip.x() - s, tip.y() + s * 0.7), - ]) - col = self.pen().color() - p.setBrush(QBrush(col)) - p.setPen(QPen(col, 1)) - p.drawPolygon(tri) - - def contextMenuEvent(self, e): - menu = QMenu() - act_del = menu.addAction("🗑 Delete connection") - if menu.exec(e.screenPos()) is act_del: - self.canvas.delete_edge(self.edge) - e.accept() - - -def _elide(text: str, n: int) -> str: - text = (text or "").replace("\n", " ") - return text if len(text) <= n else text[: n - 1] + "…" - - -class Co4ECanvas(QGraphicsView): - node_selected = Signal(str) # a node was clicked (→ config panel) - node_activated = Signal(str) # double-clicked - graph_changed = Signal() # nodes/edges/positions changed (autosave) - - _ZOOM_MIN, _ZOOM_MAX = 0.3, 3.0 - - def __init__(self): - super().__init__() - self.setObjectName("co4eCanvas") # themed frame (see theme.py) - self._scene = QGraphicsScene(self) - self.setScene(self._scene) - self.setRenderHint(self.renderHints().Antialiasing) - self.setDragMode(QGraphicsView.RubberBandDrag) - self.setTransformationAnchor(QGraphicsView.AnchorUnderMouse) - self.setAcceptDrops(True) - self._nodes: Dict[str, _NodeItem] = {} - self._edges: list[_EdgeItem] = [] - self._connect_from: Optional[str] = None - self._zoom = 1.0 - self._panning = False # middle-mouse drag-to-pan - self._pan_start = None - self._overlay = None # bottom-left zoom/fit controls (parented to viewport) - # manual drag-to-connect state - self._port_src: Optional[str] = None - self._port_src_pt: Optional[QPointF] = None - self._temp_edge: Optional[QGraphicsPathItem] = None - - # ---- bottom-left overlay (zoom / fit) -------------------------------- - def add_overlay(self, widget) -> None: - self._overlay = widget - widget.setParent(self.viewport()) - widget.show() - widget.raise_() - self._place_overlay() - - def _place_overlay(self) -> None: - if self._overlay is not None: - self._overlay.adjustSize() - vp = self.viewport() - self._overlay.move(12, vp.height() - self._overlay.height() - 12) - self._overlay.raise_() - - def resizeEvent(self, e): # noqa: N802 - super().resizeEvent(e) - self._place_overlay() - - def scrollContentsBy(self, dx, dy): # noqa: N802 - # QGraphicsView scrolls the viewport's child widgets along with the - # scene, so panning/scrolling would drag the zoom overlay off-corner. - # Re-pin it after every scroll so +/−/fit stay fixed in place. - super().scrollContentsBy(dx, dy) - self._place_overlay() - - def showEvent(self, e): # noqa: N802 - super().showEvent(e) - self._place_overlay() # viewport size is final once shown - - # ---- load / serialize ------------------------------------------------- - def load(self, nodes, edges) -> None: - self._scene.clear() - self._nodes.clear() - self._edges.clear() - self._connect_from = None - self._port_src = None - self._temp_edge = None - for n in nodes: - item = _NodeItem(n, self) - self._nodes[n.id] = item - self._scene.addItem(item) - for e in edges: - if e.source in self._nodes and e.target in self._nodes: - self._add_edge_item(e) - self._reposition_edges() - - def nodes(self): - return [it.node for it in self._nodes.values()] - - def edges(self): - return [it.edge for it in self._edges] - - # ---- mutation --------------------------------------------------------- - def add_node(self, step: Step, x: float = 60.0, y: float = 60.0, - connect_from: str = "") -> str: - node = Node(id=new_node_id(), x=x, y=y, data=step) - item = _NodeItem(node, self) - self._nodes[node.id] = item - self._scene.addItem(item) - if connect_from and connect_from in self._nodes: - self._make_edge(connect_from, node.id) - self._reposition_edges() - self.graph_changed.emit() - self.node_selected.emit(node.id) - return node.id - - def add_step_below(self, node_id: str) -> None: - """Add the next step to the RIGHT of ``node_id`` (horizontal flow).""" - parent = self._nodes.get(node_id) - if parent is None: - return - step = Step(label="New Step") - self.add_node(step, x=parent.node.x + _NODE_W + 150, y=parent.node.y, connect_from=node_id) - - def _chain_tail(self) -> str: - """A node with no outgoing edge (so a freshly added node chains on).""" - sources = {e.edge.source for e in self._edges} - tails = [nid for nid in self._nodes if nid not in sources] - return tails[-1] if tails else (next(reversed(self._nodes), "") if self._nodes else "") - - def add_palette_step(self, step: Step, pos: QPointF) -> None: - tail = self._chain_tail() - self.add_node(step, x=pos.x(), y=pos.y(), connect_from=tail) - - def begin_connect(self, source_id: str) -> None: - self._connect_from = source_id - - def _finish_connect(self, target_id: str) -> None: - src = self._connect_from - self._connect_from = None - if src and src != target_id: - self._make_edge(src, target_id) - - # ---- manual drag-to-connect (from a node's output port) --------------- - def begin_port_drag(self, source_id: str, scene_pt: QPointF) -> None: - self._port_src = source_id - self._port_src_pt = scene_pt - self._temp_edge = QGraphicsPathItem() - self._temp_edge.setZValue(3.5) # above nodes + edges while connecting - self._temp_edge.setPen( - QPen(QColor(current_palette().accent), 2, Qt.DashLine, Qt.RoundCap)) - self._scene.addItem(self._temp_edge) - - def update_port_drag(self, scene_pt: QPointF) -> None: - if self._temp_edge is None or self._port_src_pt is None: - return - self._temp_edge.setPath(_ortho_path(self._port_src_pt, scene_pt)) - - def finish_port_drag(self, scene_pt: QPointF) -> None: - src = self._port_src - if self._temp_edge is not None: - self._scene.removeItem(self._temp_edge) - self._temp_edge = None - self._port_src = None - self._port_src_pt = None - tgt = self._node_at(scene_pt) - if src and tgt and tgt != src: - self._make_edge(src, tgt) - - def _node_at(self, scene_pt: QPointF) -> Optional[str]: - for it in self._scene.items(scene_pt): - if isinstance(it, _NodeItem): - return it.node.id - return None - - def _make_edge(self, source: str, target: str) -> None: - if source == target: - return - if any(e.edge.source == source and e.edge.target == target for e in self._edges): - return - edge = Edge(id=new_edge_id(source, target), source=source, target=target) - self._add_edge_item(edge) - self._reposition_edges() - self.graph_changed.emit() - - def _add_edge_item(self, edge: Edge) -> None: - item = _EdgeItem(edge, self) - self._edges.append(item) - self._scene.addItem(item) - - def delete_edge(self, edge: Edge) -> None: - for e in list(self._edges): - if e.edge is edge or (e.edge.source == edge.source and e.edge.target == edge.target): - self._scene.removeItem(e) - self._edges.remove(e) - self.graph_changed.emit() - - def delete_node(self, node_id: str) -> None: - item = self._nodes.pop(node_id, None) - if item is None: - return - self._scene.removeItem(item) - for e in list(self._edges): - if e.edge.source == node_id or e.edge.target == node_id: - self._scene.removeItem(e) - self._edges.remove(e) - self._reposition_edges() - self.graph_changed.emit() - - def delete_selected(self) -> None: - for nid in [it.node.id for it in self._nodes.values() if it.isSelected()]: - self.delete_node(nid) - for e in [it.edge for it in self._edges if it.isSelected()]: - self.delete_edge(e) - - # ---- zoom / fit ------------------------------------------------------- - def _zoom_by(self, factor: float) -> None: - # Derive the CURRENT scale from the live transform (never a separate - # accumulator that can drift out of sync with fit_view/relayout/reset — - # that drift is what made the +/− buttons and Ctrl+wheel randomly stop - # working). Clamp the TARGET to the range and apply the exact factor to - # reach it, so zooming still works right up to the limits. - cur = self.transform().m11() or 1.0 - target = max(self._ZOOM_MIN, min(self._ZOOM_MAX, cur * factor)) - if abs(target - cur) < 1e-6: - return - self.scale(target / cur, target / cur) - self._zoom = target - - def zoom_in(self) -> None: - self._zoom_by(1.15) - - def zoom_out(self) -> None: - self._zoom_by(1 / 1.15) - - def reset_zoom(self) -> None: - self.resetTransform() - self._zoom = 1.0 - - def wheelEvent(self, e): - # Ctrl+wheel = zoom (anchored under the cursor); Shift+wheel = pan - # horizontally; plain wheel scrolls vertically. - if e.modifiers() & Qt.ControlModifier: - self._zoom_by(1.15 if e.angleDelta().y() > 0 else 1 / 1.15) - e.accept() - return - if e.modifiers() & Qt.ShiftModifier: - bar = self.horizontalScrollBar() - bar.setValue(bar.value() - e.angleDelta().y()) - e.accept() - return - super().wheelEvent(e) - - # ---- middle-mouse drag-to-pan ---------------------------------------- - def mousePressEvent(self, e): - if e.button() == Qt.MiddleButton: - self._panning = True - self._pan_start = e.position().toPoint() - self.setCursor(Qt.ClosedHandCursor) - e.accept() - return - super().mousePressEvent(e) - - def mouseMoveEvent(self, e): - if self._panning and self._pan_start is not None: - pos = e.position().toPoint() - delta = pos - self._pan_start - self._pan_start = pos - self.horizontalScrollBar().setValue(self.horizontalScrollBar().value() - delta.x()) - self.verticalScrollBar().setValue(self.verticalScrollBar().value() - delta.y()) - e.accept() - return - super().mouseMoveEvent(e) - - def mouseReleaseEvent(self, e): - if e.button() == Qt.MiddleButton and self._panning: - self._panning = False - self.setCursor(Qt.ArrowCursor) - e.accept() - return - super().mouseReleaseEvent(e) - - def fit_view(self) -> None: - """Auto-fit: zoom/pan so every node is visible with a small margin.""" - rect = self._scene.itemsBoundingRect() - if rect.isNull(): - return - self.setSceneRect(rect.adjusted(-60, -60, 60, 60)) - self.fitInView(rect.adjusted(-40, -40, 40, 40), Qt.KeepAspectRatio) - # keep the zoom accumulator in sync with the transform fitInView applied - self._zoom = self.transform().m11() or 1.0 - - def relayout(self, hgap: float = 110.0, vgap: float = 40.0) -> None: - """Arrange nodes LEFT→RIGHT by dependency depth: each topological wave is - a column (x = wave), siblings stacked vertically within it. Used to turn - an old top-down graph into the horizontal flow layout.""" - nodes = [it.node for it in self._nodes.values()] - edges = [it.edge for it in self._edges] - if not nodes: - return - waves = compute_waves(nodes, edges) - from collections import defaultdict - cols: Dict[int, list] = defaultdict(list) - for n in nodes: - cols[waves.get(n.id, 0)].append(n) - for w in sorted(cols): - for row, n in enumerate(sorted(cols[w], key=lambda nn: (nn.y, nn.x))): - item = self._nodes.get(n.id) - if item is not None: - item.setPos(w * (_NODE_W + hgap), row * (_NODE_H + vgap)) - self._reposition_edges() - - def relayout_if_vertical(self) -> None: - """Convert a graph that's stacked vertically (the old top-down layout, or - overlapping nodes) into the horizontal left→right layout — but leave a - graph the user already arranged horizontally untouched.""" - nodes = [it.node for it in self._nodes.values()] - if len(nodes) < 2: - return - xs = [n.x for n in nodes] - if max(xs) - min(xs) < _NODE_W: # all in one column → it's vertical - self.relayout() - - def add_workflow(self, nodes, edges, at: Optional[QPointF] = None) -> None: - """Drop/merge a whole flow's nodes+edges onto the canvas with fresh ids - (so the same template can be dropped several times). Offsets it near - ``at`` when given, else tiles it beside whatever is already there.""" - remap: Dict[str, str] = {} - # offset so a dropped template doesn't land exactly on existing nodes - ox = (at.x() - nodes[0].x) if (at and nodes) else (60 if self._nodes else 0) - oy = (at.y() - nodes[0].y) if (at and nodes) else (60 if self._nodes else 0) - for n in nodes: - new = Node(id=new_node_id(), x=n.x + ox, y=n.y + oy, data=copy.deepcopy(n.data)) - remap[n.id] = new.id - item = _NodeItem(new, self) - self._nodes[new.id] = item - self._scene.addItem(item) - for e in edges: - s, t = remap.get(e.source), remap.get(e.target) - if s and t: - self._add_edge_item(Edge(id=new_edge_id(s, t), source=s, target=t)) - self._reposition_edges() - self.graph_changed.emit() - - def update_node_status(self, node_id: str, status: str) -> None: - item = self._nodes.get(node_id) - if item is not None: - item.status = status - item.update() - - def reset_statuses(self) -> None: - for it in self._nodes.values(): - it.status = "idle" - it.update() - - def refresh_node(self, node_id: str) -> None: - item = self._nodes.get(node_id) - if item is not None: - item.update() - - def _node_rects(self, exclude): - """Rectangles of every node except ``exclude`` (inflated a little), used - as obstacles the edge router steers around.""" - m = 12.0 - out = [] - for nid, item in self._nodes.items(): - if nid in exclude: - continue - p = item.pos() - out.append(QRectF(p.x(), p.y(), _NODE_W, _NODE_H).adjusted(-m, -m, m, m)) - return out - - def _reposition_edges(self) -> None: - for e in self._edges: - s = self._nodes.get(e.edge.source) - t = self._nodes.get(e.edge.target) - if s is None or t is None: - continue - src = s.pos() + QPointF(_NODE_W, _NODE_H / 2) # right-center (output) - dst = t.pos() + QPointF(0, _NODE_H / 2) # left-center (input) - obstacles = self._node_rects({e.edge.source, e.edge.target}) - e.update_path(_route(src, dst, obstacles)) - - # ---- key / drop ------------------------------------------------------- - def keyPressEvent(self, e): - if e.key() in (Qt.Key_Delete, Qt.Key_Backspace): - self.delete_selected() - return - if e.key() == Qt.Key_Escape: - self._connect_from = None - if self._temp_edge is not None: - self._scene.removeItem(self._temp_edge) - self._temp_edge = None - self._port_src = None - return - if e.key() in (Qt.Key_Plus, Qt.Key_Equal) and (e.modifiers() & Qt.ControlModifier): - self.zoom_in(); return - if e.key() == Qt.Key_Minus and (e.modifiers() & Qt.ControlModifier): - self.zoom_out(); return - if e.key() == Qt.Key_0 and (e.modifiers() & Qt.ControlModifier): - self.reset_zoom(); return - super().keyPressEvent(e) - - def dragEnterEvent(self, e): - if e.mimeData().hasFormat(CO4E_MIME): - e.acceptProposedAction() - else: - super().dragEnterEvent(e) - - def dragMoveEvent(self, e): - if e.mimeData().hasFormat(CO4E_MIME): - e.acceptProposedAction() - else: - super().dragMoveEvent(e) - - def dropEvent(self, e): - if not e.mimeData().hasFormat(CO4E_MIME): - super().dropEvent(e) - return - try: - payload = json.loads(bytes(e.mimeData().data(CO4E_MIME)).decode("utf-8")) - except (ValueError, UnicodeDecodeError): - return - pos = self.mapToScene(e.position().toPoint()) - if isinstance(payload, dict) and payload.get("kind") == "workflow": - # A whole flow dragged from the sidebar → merge its graph in. - from ..core.co4e import workflow_from_dict - wf = workflow_from_dict(payload.get("workflow", {})) - if wf.nodes: - self.add_workflow(wf.nodes, wf.edges, at=pos) - else: - from ..core.co4e import step_from_dict - self.add_palette_step(step_from_dict(payload), pos) - e.acceptProposedAction() +from ..presentation.co4e.co4e_canvas_widget import Co4ECanvas, CO4E_MIME diff --git a/ui/co4e_config_panel.py b/ui/co4e_config_panel.py index fd2e928..5f0e864 100644 --- a/ui/co4e_config_panel.py +++ b/ui/co4e_config_panel.py @@ -1,528 +1,14 @@ """Co4E right-hand config panels — edit a selected step node's persona. -StepConfigPanel edits the fields of a ``core.co4e.Step`` in place and emits -``changed`` (so the canvas repaints + the workflow autosaves) and ``run_node`` / -``delete_node`` for the footer actions. Kept intentionally close to nova's -config-panel.tsx field set: label, role, icon, instructions, model, permission -preset, self-verify (+rounds), attached skills, and — for parallel nodes — the -sub-agent list. +StepConfigPanel has moved to ``presentation/co4e/node_property_panel.py`` +(split further into ``presentation/co4e/step_config_section.py`` and +``presentation/co4e/node_property_actions_mixin.py`` to stay under the +400-line-per-file cap). Re-exported here, unchanged in name and behaviour, so +every existing ``from .co4e_config_panel import StepConfigPanel`` (e.g. +``ui/co4e_tab.py``) keeps working without edits. """ from __future__ import annotations -from typing import List, Optional +from ..presentation.co4e.node_property_panel import StepConfigPanel -from PySide6.QtCore import Qt, QEasingCurve, QPropertyAnimation, Signal -from PySide6.QtWidgets import ( - QCheckBox, QComboBox, QFormLayout, QHBoxLayout, QInputDialog, - QLabel, QLineEdit, QListWidget, QListWidgetItem, QPlainTextEdit, - QPushButton, QScrollArea, QSpinBox, QVBoxLayout, QWidget, -) - -from ..config import PROVIDER_LABELS -from ..core.co4e import PERMISSION_PRESETS, Step, SubAgent -from ..i18n import tr -from ..theme import current_palette -from .icons import icon, icon_picker_combo - -_SECTION_ANIM_MS = 180 - - -class _SectionHeader(QLabel): - """A clickable label — a QPushButton's own style chrome (border, native - button margin, focus rect) always leaves a taller minimum height than a - plain label, even once its QSS padding is zeroed out, so the header that - needs to sit tight against its neighbours is a label, not a button.""" - - clicked = Signal() - - def mousePressEvent(self, event) -> None: # noqa: N802 - if event.button() == Qt.LeftButton: - self.clicked.emit() - super().mousePressEvent(event) - - def showEvent(self, event) -> None: # noqa: N802 - # fontMetrics() at construction time (before this label is ever part - # of a shown top-level window) reflects the QSS font-size only if the - # style has fully polished by then — on the very FIRST paint of the - # Co4E screen it sometimes hasn't, so the fixed height computed in - # _add_section is briefly wrong (too tall) until something else - # triggers a relayout. Recomputing here, every time the label - # actually becomes visible, means the first paint is never stale. - self.setFixedHeight(self.fontMetrics().height()) - super().showEvent(event) - - -def _add_section(outer: QVBoxLayout, title: str) -> tuple[QFormLayout, QWidget]: - """One group of fields, collapsed to just its heading by default and - independently expandable, so a long step config reads as a short list of - group names until you open the one you need. Deliberately bare — no card - border/background/box — the ▶/▼ marker and the heading text are the only - things separating one group from the next; opening one never closes - another (not an accordion, not a tab bar). Returns ``(form, card)``: add - the group's rows to ``form``; ``card`` is the whole section (header + - body) — hide it to remove the group entirely (e.g. for a section that - only applies to some steps), rather than hiding individual rows inside - an always-visible header.""" - p = current_palette() - card = QWidget() - card_lay = QVBoxLayout(card) - card_lay.setContentsMargins(0, 0, 0, 0) - card_lay.setSpacing(0) - - header = _SectionHeader() - header.setCursor(Qt.PointingHandCursor) - header.setStyleSheet(f"font-weight:400; font-size:13px; color:{p.text}; padding:0; margin:0;") - header.setContentsMargins(0, 0, 0, 0) - # QSS font-size only lands on the widget's actual QFont (and therefore - # its fontMetrics()) once the style sheet is polished — ensurePolished() - # forces that now, so the fixed height below is computed from the 12px - # font just set above, not the default one this label was constructed - # with. A label's natural sizeHint still reserves font leading above/ - # below the glyphs on top of the (now zeroed) QSS padding — pinning the - # height to the text's actual cap-to-baseline span is what closes that - # last gap without clipping the ▶ glyph, the title, or Vietnamese - # diacritics. - header.ensurePolished() - header.setFixedHeight(header.fontMetrics().height()) - header.setText(f"▶ {title}") - card_lay.addWidget(header) - - body = QWidget() - body.setVisible(False) - body.setMaximumHeight(0) - form = QFormLayout(body) - form.setContentsMargins(0, 6, 0, 0) - card_lay.addWidget(body) - - anim = QPropertyAnimation(body, b"maximumHeight", body) - anim.setDuration(_SECTION_ANIM_MS) - anim.setEasingCurve(QEasingCurve.InOutCubic) - - is_open = False - - def _on_finished() -> None: - if is_open: - # Uncapped once open, so switching to a step whose fields make - # this section taller/shorter (e.g. a parallel node's sub-agent - # list appearing) is never clipped by the height this animation - # last landed on. - body.setMaximumHeight(16_777_215) - else: - body.setVisible(False) - anim.finished.connect(_on_finished) - - def _toggle() -> None: - nonlocal is_open - is_open = not is_open - header.setText(f"{'▼' if is_open else '▶'} {title}") - anim.stop() - if is_open: - body.setVisible(True) - anim.setStartValue(body.height()) - anim.setEndValue(body.sizeHint().height()) - else: - anim.setStartValue(body.height()) - anim.setEndValue(0) - anim.start() - header.clicked.connect(_toggle) - - outer.addWidget(card) - return form, card - - -class StepConfigPanel(QScrollArea): - changed = Signal() # any field edited → repaint node + autosave - run_node = Signal(str) # "Run this step" (node id) - run_from = Signal(str) # "Run from here" - delete_node = Signal(str) # "Delete step" - - def __init__(self, ctx=None): - super().__init__() - self.ctx = ctx - self._step: Optional[Step] = None - self._node_id = "" - self._loading = False - self.setWidgetResizable(True) - host = QWidget() - self.setWidget(host) - outer = QVBoxLayout(host) - outer.setSpacing(1) - - # Grouped sections stacked on one scrolling page — same fields as - # before, grouped by what they're for: identity, execution - # (model/permission), and the extra resources fed to the step - # (skills/files/sub-agents). No tabs/accordion: every group's border - # and heading are what separate it from its neighbours, and all three - # are on screen (or one scroll away) at once. - form, _basic_card = _add_section(outer, tr("co4e.tab_basic")) - - self.label_edit = QLineEdit() - self.label_edit.textChanged.connect(self._on_edit) - form.addRow(tr("co4e.f_label"), self.label_edit) - - self.role_edit = QLineEdit() - self.role_edit.textChanged.connect(self._on_edit) - form.addRow(tr("co4e.f_role"), self.role_edit) - - # Dropdown of every icon in the registry (Monitoring's Icon Management - # set + built-ins), each row previewing its actual glyph — still - # editable so a not-yet-added custom name can be typed directly. - self.icon_edit = icon_picker_combo() - self.icon_edit.lineEdit().setPlaceholderText(tr("co4e.f_icon_placeholder")) - self.icon_edit.currentTextChanged.connect(self._on_edit) - form.addRow(tr("co4e.f_icon"), self.icon_edit) - - self.instructions_edit = QPlainTextEdit() - self.instructions_edit.setMaximumHeight(120) - self.instructions_edit.textChanged.connect(self._on_edit) - self.gen_btn = QPushButton(tr("co4e.ai_draft")) - self.gen_btn.setIcon(icon("sparkle")) - self.gen_btn.setToolTip(tr("co4e.ai_draft_tooltip")) - self.gen_btn.setEnabled(ctx is not None) - self.gen_btn.clicked.connect(self._ai_draft) - instr_box = QWidget() - ib = QVBoxLayout(instr_box) - ib.setContentsMargins(0, 0, 0, 0) - ib.addWidget(self.instructions_edit) - ib.addWidget(self.gen_btn, alignment=Qt.AlignRight) - form.addRow(tr("co4e.f_instructions"), instr_box) - - # Extra context — free-text background/info fed to the step at run time - # (in addition to instructions, attachments and upstream outputs). - self.context_edit = QPlainTextEdit() - self.context_edit.setMaximumHeight(90) - self.context_edit.setPlaceholderText(tr("co4e.f_context_placeholder")) - self.context_edit.textChanged.connect(self._on_edit) - form.addRow(tr("co4e.f_context"), self.context_edit) - - form2, _model_card = _add_section(outer, tr("co4e.tab_model_perm")) - - model_row = QHBoxLayout() - self.model_combo = QComboBox() - self.model_combo.setEditable(True) - self.model_combo.editTextChanged.connect(self._on_edit) - self.load_models_btn = QPushButton() - self.load_models_btn.setIcon(icon("download")) - self.load_models_btn.setToolTip(tr("co4e.load_models_tooltip")) - self.load_models_btn.clicked.connect(self._load_models) - self.load_models_btn.setEnabled(ctx is not None) - model_row.addWidget(self.model_combo, 1) - model_row.addWidget(self.load_models_btn) - mrow = QWidget(); mrow.setLayout(model_row) - form2.addRow(tr("co4e.f_model"), mrow) - - self.perm_combo = QComboBox() - for preset in PERMISSION_PRESETS: - self.perm_combo.addItem(tr(f"co4e.perm.{preset}"), preset) - self.perm_combo.currentIndexChanged.connect(self._on_edit) - form2.addRow(tr("co4e.f_permission"), self.perm_combo) - - verify_row = QHBoxLayout() - self.verify_chk = QCheckBox(tr("co4e.f_self_verify")) - self.verify_chk.toggled.connect(self._on_edit) - self.rounds_spin = QSpinBox() - self.rounds_spin.setRange(1, 5) - self.rounds_spin.valueChanged.connect(self._on_edit) - verify_row.addWidget(self.verify_chk) - verify_row.addWidget(QLabel(tr("co4e.f_verify_rounds"))) - verify_row.addWidget(self.rounds_spin) - verify_row.addStretch(1) - vrow = QWidget(); vrow.setLayout(verify_row) - form2.addRow("", vrow) - - form3, _skills_card = _add_section(outer, tr("co4e.tab_skills_files")) - - # Skills checklist (registry skills) - self.skills_list = QListWidget() - self.skills_list.setMaximumHeight(110) - self.skills_list.itemChanged.connect(self._on_edit) - form3.addRow(tr("co4e.f_skills"), self.skills_list) - - # Attachments — files whose extracted text is fed to this step at run time. - self.attach_list = QListWidget() - self.attach_list.setMaximumHeight(80) - self.attach_add_btn = QPushButton(tr("co4e.attach_add")) - self.attach_add_btn.setIcon(icon("plus")) - self.attach_add_btn.clicked.connect(self._add_attachment) - self.attach_del_btn = QPushButton(tr("co4e.attach_remove")) - self.attach_del_btn.setIcon(icon("trash")) - self.attach_del_btn.clicked.connect(self._del_attachment) - att_btns = QHBoxLayout() - att_btns.addWidget(self.attach_add_btn) - att_btns.addWidget(self.attach_del_btn) - att_btns.addStretch(1) - abtn = QWidget(); abtn.setLayout(att_btns) - form3.addRow(tr("co4e.f_attachments"), self.attach_list) - form3.addRow("", abtn) - - # Parallel sub-agents get their OWN section — same header style as - # Cơ bản/Model & Quyền/Skills & Tệp — rather than a row buried inside - # Skills & Tệp, since it's really a distinct group, just one that - # only applies to parallel-variant steps. load_step() hides the whole - # card for a non-parallel step (see is_par below). - form4, self._parallel_card = _add_section(outer, tr("co4e.f_subagents")) - self.sub_list = QListWidget() - self.sub_list.setMaximumHeight(90) - self.sub_list.itemDoubleClicked.connect(self._edit_subagent) # re-pick agent - self.sub_add_btn = QPushButton(tr("co4e.add_subagent")) - self.sub_add_btn.setIcon(icon("plus")) - self.sub_add_btn.clicked.connect(self._add_subagent) - self.sub_del_btn = QPushButton(tr("co4e.del_subagent")) - self.sub_del_btn.setIcon(icon("trash")) - self.sub_del_btn.clicked.connect(self._del_subagent) - sub_btns = QHBoxLayout() - sub_btns.addWidget(self.sub_add_btn) - sub_btns.addWidget(self.sub_del_btn) - sub_btns.addStretch(1) - sbtn = QWidget(); sbtn.setLayout(sub_btns) - form4.addRow(self.sub_list) - form4.addRow("", sbtn) - - # Footer actions — one compact row (Run · Run from here · Delete), - # kept below every section, not inside one of the cards. - self.run_btn = QPushButton(tr("co4e.run")) - self.run_btn.setIcon(icon("play")) - self.run_btn.setToolTip(tr("co4e.run_this_step")) - self.run_btn.clicked.connect(lambda: self.run_node.emit(self._node_id)) - self.run_from_btn = QPushButton(tr("co4e.run_from_here")) - self.run_from_btn.setToolTip(tr("co4e.run_from_here")) - self.run_from_btn.clicked.connect(lambda: self.run_from.emit(self._node_id)) - self.del_btn = QPushButton() - self.del_btn.setIcon(icon("trash")) - self.del_btn.setObjectName("danger") - self.del_btn.setToolTip(tr("co4e.delete_step")) - self.del_btn.setFixedWidth(38) - self.del_btn.clicked.connect(lambda: self.delete_node.emit(self._node_id)) - foot = QHBoxLayout() - foot.addWidget(self.run_btn, 1) - foot.addWidget(self.run_from_btn, 1) - foot.addWidget(self.del_btn) - foot_w = QWidget(); foot_w.setLayout(foot) - outer.addWidget(foot_w) - # Without this, QVBoxLayout hands every child widget an EQUAL share of - # whatever extra height the scroll area's viewport has beyond the - # content's own sizeHint (setWidgetResizable(True) stretches `host` to - # fill it) — each collapsed header's card was measuring a true - # sizeHint of ~17px but rendering over 100px taller, and no amount of - # margin/padding/spacing on the header itself could touch that: the - # surplus was being spent on the cards, not around them. One trailing - # stretch absorbs all of it instead, so every section (and the - # footer) renders at exactly its own natural height. - outer.addStretch(1) - - self.setEnabled(False) - - # ---- load a step ------------------------------------------------------ - def load_step(self, node_id: str, step: Step, skill_names: List[str]) -> None: - self._loading = True - self._node_id = node_id - self._step = step - self.setEnabled(True) - self.label_edit.setText(step.label) - self.role_edit.setText(step.role) - self.icon_edit.setCurrentText(step.icon) - self.instructions_edit.setPlainText(step.instructions) - self.context_edit.setPlainText(getattr(step, "context", "")) - self.model_combo.setEditText(step.model) - idx = self.perm_combo.findData(step.permission_preset) - self.perm_combo.setCurrentIndex(idx if idx >= 0 else 0) - self.verify_chk.setChecked(step.self_verify) - self.rounds_spin.setValue(max(1, step.max_verify_rounds)) - # skills checklist - self.skills_list.clear() - for name in skill_names: - it = QListWidgetItem(name) - it.setFlags(it.flags() | Qt.ItemIsUserCheckable) - it.setCheckState(Qt.Checked if name in step.skills else Qt.Unchecked) - self.skills_list.addItem(it) - # attachments - self.attach_list.clear() - from pathlib import Path as _P - for path in step.attachments: - item = QListWidgetItem(_P(path).name) - item.setToolTip(path) - self.attach_list.addItem(item) - # parallel sub-agents — the whole "Agent song song" section only - # applies to parallel-variant steps, so the entire card (header - # included) is hidden for any other step, not just its rows. - is_par = step.is_parallel - self._parallel_card.setVisible(is_par) - self.sub_list.clear() - if is_par: - for sub in step.sub_agents: - self.sub_list.addItem(sub.agent) - self._loading = False - - def clear_step(self) -> None: - self._step = None - self._node_id = "" - self.setEnabled(False) - - # ---- edits write back to the Step ------------------------------------- - def _on_edit(self, *_a) -> None: - if self._loading or self._step is None: - return - s = self._step - s.label = self.label_edit.text() - s.role = self.role_edit.text().upper() or "AGENT" - s.icon = self.icon_edit.currentText().strip() - s.instructions = self.instructions_edit.toPlainText() - s.context = self.context_edit.toPlainText() - s.model = self.model_combo.currentText().strip() - s.permission_preset = self.perm_combo.currentData() or "inherit" - s.self_verify = self.verify_chk.isChecked() - s.max_verify_rounds = self.rounds_spin.value() - s.skills = [self.skills_list.item(i).text() - for i in range(self.skills_list.count()) - if self.skills_list.item(i).checkState() == Qt.Checked] - self.changed.emit() - - @staticmethod - def _available_agent_names() -> List[str]: - """Agents the user can pick as a parallel sub-agent: their own custom - agents first, then the built-in personas (kept for resolution even - though they're no longer in the palette).""" - from ..core import co4e - from ..core.co4e_builtins import BUILTIN_AGENTS - - names = [a.name for a in co4e.list_custom_agents()] - names += [a.name for a in BUILTIN_AGENTS if a.name not in names] - return names - - def _add_subagent(self) -> None: - if self._step is None: - return - from PySide6.QtWidgets import QInputDialog - - names = self._available_agent_names() - if names: - name, ok = QInputDialog.getItem(self, tr("co4e.pick_agent"), tr("co4e.pick_agent"), - names, 0, True) # editable: can type a new one - else: - name, ok = QInputDialog.getText(self, tr("co4e.pick_agent"), tr("co4e.pick_agent")) - name = (name or "").strip() - if not ok or not name: - return - self._step.sub_agents.append(SubAgent(agent=name)) - self.sub_list.addItem(name) - self.changed.emit() - - def _edit_subagent(self, item) -> None: - """Double-click a sub-agent row → re-pick from the list.""" - if self._step is None: - return - row = self.sub_list.row(item) - if not (0 <= row < len(self._step.sub_agents)): - return - from PySide6.QtWidgets import QInputDialog - - names = self._available_agent_names() - cur = self._step.sub_agents[row].agent - start = names.index(cur) if cur in names else 0 - name, ok = QInputDialog.getItem(self, tr("co4e.pick_agent"), tr("co4e.pick_agent"), - names or [cur], start, True) - name = (name or "").strip() - if ok and name: - self._step.sub_agents[row].agent = name - item.setText(name) - self.changed.emit() - - def _del_subagent(self) -> None: - if self._step is None: - return - row = self.sub_list.currentRow() - if 0 <= row < len(self._step.sub_agents): - self._step.sub_agents.pop(row) - self.sub_list.takeItem(row) - self.changed.emit() - - def _add_attachment(self) -> None: - if self._step is None: - return - from pathlib import Path as _P - - from PySide6.QtWidgets import QFileDialog - files, _ = QFileDialog.getOpenFileNames(self, tr("co4e.attach_add")) - for f in files: - if f and f not in self._step.attachments: - self._step.attachments.append(f) - item = QListWidgetItem(_P(f).name) - item.setToolTip(f) - self.attach_list.addItem(item) - if files: - self.changed.emit() - - def _del_attachment(self) -> None: - if self._step is None: - return - row = self.attach_list.currentRow() - if 0 <= row < len(self._step.attachments): - self._step.attachments.pop(row) - self.attach_list.takeItem(row) - self.changed.emit() - - def _ai_draft(self) -> None: - """Draft this step's instructions from its label (name) + role — first - asking for an optional description so the generated instructions can be - more specific/detailed than name+role alone would produce.""" - if self.ctx is None or self._step is None: - return - from ..core.worker import AgentWorker - - name = self.label_edit.text().strip() - role = self.role_edit.text().strip() - if not name and not role: - return - hint, ok = QInputDialog.getMultiLineText( - self, tr("co4e.ai_draft_hint_title"), tr("co4e.ai_draft_hint_label")) - if not ok: - return - hint = hint.strip() - self.gen_btn.setEnabled(False) - ctx = self.ctx - - def job(worker: AgentWorker): - from ..core.ai_task_planner import generate_agent_prompt - return {"text": generate_agent_prompt(ctx.build_active_provider(), name, role, hint, - cancel=worker.is_cancelled)} - - def done(result: dict): - self.gen_btn.setEnabled(True) - if result.get("text"): - self.instructions_edit.setPlainText(result["text"]) # _on_edit persists it - - w = AgentWorker(job) - w.finished_ok.connect(done) - w.failed.connect(lambda _e: self.gen_btn.setEnabled(True)) - self._draft_worker = w - w.start() - - def _load_models(self) -> None: - if self.ctx is None: - return - from ..core import preview_ai - from ..core.worker import AgentWorker - - self.load_models_btn.setEnabled(False) - ctx = self.ctx - - def job(_w): - return preview_ai.fetch_live_models(ctx) - - def done(result: dict): - self.load_models_btn.setEnabled(True) - models = [] - for lst in (result or {}).values(): - models.extend(lst) - cur = self.model_combo.currentText() - self.model_combo.blockSignals(True) - self.model_combo.clear() - self.model_combo.addItems(sorted(set(models))) - self.model_combo.setEditText(cur) - self.model_combo.blockSignals(False) - - w = AgentWorker(job) - w.finished_ok.connect(done) - w.failed.connect(lambda _e: self.load_models_btn.setEnabled(True)) - self._model_worker = w - w.start() +__all__ = ["StepConfigPanel"] diff --git a/ui/co4e_tab.py b/ui/co4e_tab.py index b829b89..68efe99 100644 --- a/ui/co4e_tab.py +++ b/ui/co4e_tab.py @@ -15,13 +15,11 @@ persona and ``/skill:`` applies a skill — same as Cowork. """ from __future__ import annotations -import json import re from pathlib import Path from typing import Dict, List, Optional -from PySide6.QtCore import QMimeData, QSize, Qt, Signal -from PySide6.QtGui import QDrag +from PySide6.QtCore import QSize, Qt, Signal from PySide6.QtWidgets import ( QComboBox, QFrame, QHBoxLayout, QHeaderView, QInputDialog, QLabel, QLineEdit, QListView, QListWidget, QListWidgetItem, QMenu, QMessageBox, QPushButton, @@ -36,9 +34,16 @@ from ..core.worker import AgentWorker from ..i18n import on_language_changed, tr from ..theme import current_palette from .chat_view import ChatView -from .co4e_canvas import CO4E_MIME, Co4ECanvas +from .co4e_canvas import Co4ECanvas from .co4e_config_panel import StepConfigPanel from .icons import icon +from ..presentation.co4e.agent_list_panel import AgentListPanel +from ..presentation.co4e.co4e_chat_view import ( + ChatPanel, _ChatInput, _agent_names, _directive_token, _skill_names, +) +from ..presentation.co4e.co4e_run_control_widget import RunsPagePanel +from ..presentation.co4e.palette_list import _PaletteList +from ..presentation.co4e.skills_list_panel import SkillsListPanel _PLAN_GLYPH = {"completed": "✓", "done": "✓", "in_progress": "▶", "running": "▶", @@ -57,19 +62,6 @@ def _fmt_plan(steps) -> str: return "\n".join(lines) -def _skill_names() -> List[str]: - try: - return [s.name for s in skills_mod.list_skills() + skills_mod.builtin_skills()] - except Exception: # noqa: BLE001 - return [] - - -def _agent_names() -> List[str]: - names = [a.name for a in co4e.list_custom_agents()] - names += [a.name for a in BUILTIN_AGENTS if a.name not in names] - return names - - class _EqualTabBar(QTabBar): """Icon-only sidebar tabs (Workflows / Agents / Skills), all the same width, sized to fill the sidebar with a comfortable minimum (~double the default @@ -93,138 +85,6 @@ class _EqualTabBar(QTabBar): self.updateGeometry() # re-hint tab widths when resized -class _PaletteList(QListWidget): - """A list whose rows can be dragged onto the canvas. Each item carries a - JSON-able drag payload (a step dict, or a workflow dict) in ``payload_role``. - Workflow rows also keep a (kind, id) tuple in Qt.UserRole for load/delete.""" - - def __init__(self, parent=None, payload_role=Qt.UserRole): - super().__init__(parent) - self._payload_role = payload_role - self.setDragEnabled(True) - self.setDragDropMode(QListWidget.DragOnly) - - def startDrag(self, _actions): # noqa: N802 - item = self.currentItem() - if item is None: - return - payload = item.data(self._payload_role) - if not payload: - return - md = QMimeData() - md.setData(CO4E_MIME, json.dumps(payload).encode("utf-8")) - drag = QDrag(self) - drag.setMimeData(md) - drag.exec(Qt.CopyAction) - - -def _directive_token(text: str, pos: int): - """Locate a ``/skill[:x]`` or ``/agent[:x]`` directive the cursor is on, - anywhere in the line. Returns ``(start, kind, partial)`` or ``None``.""" - before = text[:pos] - start = re.search(r"\S*$", before).start() - token = before[start:] - m = re.match(r"^/(skill|agent):?([\w\-.]*)$", token) - if m: - return start, m.group(1), m.group(2) - for kind in ("skill", "agent"): - if len(token) >= 2 and ("/" + kind).startswith(token): - return start, kind, "" - return None - - -class _ChatInput(QLineEdit): - """Chat box with ``/skill:`` and ``/agent:`` autocomplete (parity with the - Cowork composer). The popup never grabs focus, so typing keeps flowing.""" - - submit = Signal() - - def __init__(self, parent=None): - super().__init__(parent) - self._popup = QListWidget() - self._popup.setWindowFlags(Qt.Tool | Qt.FramelessWindowHint - | Qt.WindowStaysOnTopHint | Qt.NoDropShadowWindowHint) - self._popup.setAttribute(Qt.WA_ShowWithoutActivating, True) - self._popup.setFocusPolicy(Qt.NoFocus) - self._popup.itemClicked.connect(lambda _i: self._accept()) - self.textEdited.connect(self._maybe_popup) - - def _maybe_popup(self, *_a) -> None: - tok = _directive_token(self.text(), self.cursorPosition()) - if tok is None: - self._popup.hide() - return - _start, kind, partial = tok - f = partial.lower() - self._popup.clear() - if kind == "skill": - for name in _skill_names(): - if f in name.lower(): - self._add_row(name, f"/skill:{co4e.slugify(name)} ", name) - else: - for name in _agent_names(): - if f in name.lower(): - self._add_row(name, f"/agent:{name} ", name) - if self._popup.count() == 0: - self._popup.hide() - return - self._popup.setCurrentRow(0) - rows = min(7, self._popup.count()) - h = 8 + rows * 22 - self._popup.resize(max(280, self.width()), h) - tl = self.mapToGlobal(self.rect().topLeft()) - self._popup.move(tl.x(), tl.y() - h - 2) - self._popup.show() - - def _add_row(self, label: str, replacement: str, tip: str) -> None: - it = QListWidgetItem(label) - it.setData(Qt.UserRole, replacement) - it.setToolTip(tip) - self._popup.addItem(it) - - def _accept(self) -> None: - item = self._popup.currentItem() - self._popup.hide() - if item is None: - return - replacement = item.data(Qt.UserRole) - tok = _directive_token(self.text(), self.cursorPosition()) - start = tok[0] if tok else self.cursorPosition() - pos = self.cursorPosition() - full = self.text() - new_text = full[:start] + replacement + full[pos:] - self.setText(new_text) - self.setCursorPosition(start + len(replacement)) - self.setFocus() - - def focusOutEvent(self, e): # noqa: N802 - if not self._popup.underMouse(): - self._popup.hide() - super().focusOutEvent(e) - - def keyPressEvent(self, e): # noqa: N802 - if self._popup.isVisible(): - k = e.key() - n = self._popup.count() - if k in (Qt.Key_Down, Qt.Key_Up) and n: - step = 1 if k == Qt.Key_Down else -1 - self._popup.setCurrentRow((self._popup.currentRow() + step) % n) - return - if k in (Qt.Key_Tab,): - self._accept() - return - if k == Qt.Key_Escape: - self._popup.hide() - return - if k in (Qt.Key_Return, Qt.Key_Enter): - self._accept() - return - if e.key() in (Qt.Key_Return, Qt.Key_Enter): - self.submit.emit() - return - super().keyPressEvent(e) - - class Co4ETab(QWidget): status_message = Signal(str) @@ -546,38 +406,31 @@ class Co4ETab(QWidget): col.addWidget(self._section("co4e.tab_workflows", wf_body, self.wf_new_btn), 3) # --- AGENTS ------------------------------------------------------ - self.ag_new_btn = QPushButton(tr("co4e.new")); self.ag_new_btn.setIcon(icon("plus")) - self.ag_new_btn.setToolTip(tr("co4e.tt_new_agent")) - self.ag_new_btn.setObjectName("co4eSectionAction") - self.ag_new_btn.setFlat(True) - self.ag_new_btn.setCursor(Qt.PointingHandCursor) + # Widget cua khu vuc nay da doi sang AgentListPanel (xem + # presentation/co4e/agent_list_panel.py); o day chi con giu + # ag_new_btn/agent_list/ag_edit_btn/ag_del_btn nhu 4 ten thuoc tinh cu + # va tu noi signal - dung nguyen tac panel khong tu wire, Co4ETab moi + # biet _new_agent/_edit_agent/_delete_agent. + self._agent_panel = AgentListPanel() + self.ag_new_btn = self._agent_panel.new_btn self.ag_new_btn.clicked.connect(self._new_agent) - ag_body = QWidget(); al = QVBoxLayout(ag_body) - al.setContentsMargins(0, 0, 0, 0); al.setSpacing(4) - self.agent_list = _PaletteList() - al.addWidget(self.agent_list, 1) - ag_btns = QHBoxLayout(); ag_btns.setSpacing(4) - # Edit/delete act on the selected row, so they stay with the list. - self.ag_edit_btn = self._icon_btn("edit", "co4e.tt_edit_agent", self._edit_agent) - self.ag_del_btn = self._icon_btn("trash", "co4e.tt_del_agent", self._delete_agent) - ag_btns.addWidget(self.ag_edit_btn) - ag_btns.addWidget(self.ag_del_btn) - ag_btns.addStretch(1) - al.addLayout(ag_btns) - col.addWidget(self._section("co4e.tab_agents", ag_body, self.ag_new_btn), 3) + self.agent_list = self._agent_panel.list_widget + self.ag_edit_btn = self._agent_panel.edit_btn + self.ag_edit_btn.clicked.connect(self._edit_agent) + self.ag_del_btn = self._agent_panel.del_btn + self.ag_del_btn.clicked.connect(self._delete_agent) + col.addWidget(self._section("co4e.tab_agents", self._agent_panel, self.ag_new_btn), 3) # --- SKILLS ------------------------------------------------------ - self.sk_manage_btn = QPushButton(tr("co4e.manage_skills")) - self.sk_manage_btn.setToolTip(tr("co4e.tt_manage_skills")) - self.sk_manage_btn.setObjectName("co4eSectionAction") - self.sk_manage_btn.setFlat(True) - self.sk_manage_btn.setCursor(Qt.PointingHandCursor) + # Widget cua khu vuc nay da doi sang SkillsListPanel (xem + # presentation/co4e/skills_list_panel.py); o day chi con giu + # sk_manage_btn/skill_list nhu 2 ten thuoc tinh cu va tu noi signal - + # dung nguyen tac panel khong tu wire, Co4ETab moi biet _manage_skills. + self._skills_panel = SkillsListPanel() + self.sk_manage_btn = self._skills_panel.manage_btn self.sk_manage_btn.clicked.connect(self._manage_skills) - sk_body = QWidget(); sl = QVBoxLayout(sk_body) - sl.setContentsMargins(0, 0, 0, 0); sl.setSpacing(4) - self.skill_list = _PaletteList() - sl.addWidget(self.skill_list, 1) - col.addWidget(self._section("co4e.tab_skills", sk_body, self.sk_manage_btn), 2) + self.skill_list = self._skills_panel.list_widget + col.addWidget(self._section("co4e.tab_skills", self._skills_panel, self.sk_manage_btn), 2) # --- RUNS -------------------------------------------------------- # A short, always-visible view of the same runs the Flow Status page @@ -874,63 +727,32 @@ class Co4ETab(QWidget): def _build_runs_page(self) -> QWidget: """The pinned 'Runs' tab: a table of every flow run (name · status · steps done/total · creator · created) for tracking. Double-click a run to open - that flow's tab with its live status.""" - w = QWidget() - v = QVBoxLayout(w) - hdr = QHBoxLayout() - # The Runs page covers the flow toolbar, so it carries its own way back — - # otherwise the toggle that opened it is off screen. - self.runs_back_btn = QPushButton(tr("co4e.back_to_flow")) - self.runs_back_btn.setIcon(icon("chevron-left")) - self.runs_back_btn.setToolTip(tr("co4e.tt_back_to_flow")) + that flow's tab with its live status. + + Widget construction lives in ``RunsPagePanel`` (presentation/co4e/ + co4e_run_control_widget.py); this method just wires the panel's public + attributes to the handler methods that know about ``self`` (``_show_runs``, + ``_stop_selected_run``, ...) — the panel itself stays ignorant of ``Co4ETab``. + """ + panel = RunsPagePanel() + self.runs_back_btn = panel.back_btn self.runs_back_btn.clicked.connect(lambda: self._show_runs(False)) - hdr.addWidget(self.runs_back_btn) - self.runs_title = QLabel(tr("co4e.running_flows")) - self.runs_title.setObjectName("hint") - hdr.addWidget(self.runs_title) - # Show + open the workspace folder where flow outputs land (below the tab, - # next to the title) so the files a flow produced are easy to find. - self.ws_folder_btn = QPushButton() - self.ws_folder_btn.setIcon(icon("folder")) - self.ws_folder_btn.setFlat(True) - self.ws_folder_btn.setCursor(Qt.PointingHandCursor) + self.runs_title = panel.title_label + self.ws_folder_btn = panel.ws_folder_btn self.ws_folder_btn.clicked.connect(self._open_workspace_folder) self._refresh_ws_folder_btn() - hdr.addWidget(self.ws_folder_btn) - hdr.addStretch(1) - self.run_stop_btn = QPushButton(tr("co4e.stop")) - self.run_stop_btn.setIcon(icon("stop")) - self.run_stop_btn.setObjectName("danger") - self.run_stop_btn.setToolTip(tr("co4e.tt_stop_run")) + self.run_stop_btn = panel.stop_btn self.run_stop_btn.clicked.connect(self._stop_selected_run) - self.run_rename_btn = QPushButton(tr("co4e.rename_run")) - self.run_rename_btn.setIcon(icon("edit")) - self.run_rename_btn.setToolTip(tr("co4e.tt_rename_run")) + self.run_rename_btn = panel.rename_btn self.run_rename_btn.clicked.connect(self._rename_selected_run) - self.run_del_btn = QPushButton(tr("co4e.delete_run")) - self.run_del_btn.setIcon(icon("trash")) - self.run_del_btn.setToolTip(tr("co4e.tt_delete_run")) + self.run_del_btn = panel.del_btn self.run_del_btn.clicked.connect(self._delete_selected_run) - self.run_clear_btn = QPushButton(tr("co4e.clear_done")) - self.run_clear_btn.setToolTip(tr("co4e.tt_clear_runs")) + self.run_clear_btn = panel.clear_btn self.run_clear_btn.clicked.connect(lambda: self.manager.clear_finished()) - hdr.addWidget(self.run_stop_btn) - hdr.addWidget(self.run_rename_btn) - hdr.addWidget(self.run_del_btn) - hdr.addWidget(self.run_clear_btn) - v.addLayout(hdr) - self.runs_table = QTableWidget(0, 5) - self.runs_table.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch) - self.runs_table.verticalHeader().setVisible(False) - self.runs_table.setEditTriggers(QTableWidget.NoEditTriggers) - self.runs_table.setSelectionBehavior(QTableWidget.SelectRows) - self.runs_table.setToolTip(tr("co4e.tt_runs_list")) + self.runs_table = panel.table self.runs_table.itemDoubleClicked.connect(self._open_run_from_table) - # Right-click a run → Open / Delete (delete a single old run from history). - self.runs_table.setContextMenuPolicy(Qt.CustomContextMenu) self.runs_table.customContextMenuRequested.connect(self._runs_context_menu) - v.addWidget(self.runs_table, 1) - return w + return panel def _wrap_config(self) -> QWidget: """Wrap the step-config panel with a header that has an expand/collapse @@ -1063,69 +885,36 @@ class Co4ETab(QWidget): self.canvas.add_overlay(bar) def _build_chat(self) -> QWidget: - w = QWidget() - self._chat_widget = w - lay = QVBoxLayout(w) - lay.setContentsMargins(0, 0, 0, 0) - lay.setSpacing(0) - # "Messages" header at the TOP, above the chat box. Toggling it shows or - # hides the WHOLE chat box (message list + composer) below it. - self._mhdr = QWidget(); self._mhdr.setObjectName("msgHeader") - mh = QHBoxLayout(self._mhdr); mh.setContentsMargins(6, 3, 6, 3); mh.setSpacing(6) - self.msgs_icon = QLabel(); self.msgs_icon.setPixmap(icon("message").pixmap(14, 14)) - self.msgs_title = QLabel(tr("co4e.messages")); self.msgs_title.setObjectName("hint") - self.chat_toggle_btn = QPushButton() - self.chat_toggle_btn.setObjectName("msgToggle") - self.chat_toggle_btn.setFlat(True) - self.chat_toggle_btn.setIcon(icon("chevron-up")) # collapsed → points up (click to expand) - self.chat_toggle_btn.setFixedSize(22, 22) + """Widget construction lives in ``ChatPanel`` (presentation/co4e/ + co4e_chat_view.py); this method just wires the panel's public + attributes to the handler methods that know about ``self`` + (``_toggle_messages``, ``_chat_send``) and keeps the state that is + NOT part of the panel's own construction (``_flow_logs`` — per-flow + ChatView dict, ``_co4e_routed_provider`` — routing override, and + ``_vsplit_sizes``/``_msgs_collapsed`` — used by ``_toggle_messages`` + below to restore/collapse the splitter) — the panel itself stays + ignorant of ``Co4ETab``. + """ + panel = ChatPanel(self.ctx) + self._chat_widget = panel + self.msgs_icon = panel.msgs_icon + self.msgs_title = panel.msgs_title + self.chat_toggle_btn = panel.chat_toggle_btn self.chat_toggle_btn.clicked.connect(self._toggle_messages) - mh.addWidget(self.msgs_icon) - mh.addWidget(self.msgs_title) - mh.addStretch(1) - mh.addWidget(self.chat_toggle_btn) - lay.addWidget(self._mhdr) # header on top - # Point-conversation (message bubbles) like Cowork, not a flat textbox. - # ONE ChatView PER FLOW (keyed by workflow id) inside a stack, so each flow - # tab has its OWN separate conversation and they never bleed into each other. - from PySide6.QtWidgets import QStackedWidget - self.chat_stack = QStackedWidget() + self._mhdr = panel.header + self.chat_stack = panel.chat_stack self._flow_logs: Dict[str, ChatView] = {} - lay.addWidget(self.chat_stack, 1) - self.chat_input_row = QWidget() - crow = QVBoxLayout(self.chat_input_row) - crow.setContentsMargins(0, 4, 0, 0); crow.setSpacing(3) - # Running conversation token/cost TOTAL for this flow (↓in ↑out ▤ctx - # $cost) at the bottom, exactly like Cowork's conversation total. - self._usage_total_lbl = QLabel("") - self._usage_total_lbl.setObjectName("hint") - self._usage_total_lbl.setStyleSheet( - f"color: {current_palette().text_faint}; font-size: 11px;") - crow.addWidget(self._usage_total_lbl) - _inp = QWidget(); row = QHBoxLayout(_inp); row.setContentsMargins(0, 0, 0, 0) - self.chat_input = _ChatInput() - self.chat_input.setPlaceholderText(tr("co4e.chat_placeholder")) + self.chat_input_row = panel.chat_input_row + self._usage_total_lbl = panel.usage_total_lbl + self.chat_input = panel.chat_input self.chat_input.submit.connect(self._chat_send) - self.chat_send_btn = QPushButton(tr("co4e.send")); self.chat_send_btn.setIcon(icon("send")) + self.chat_send_btn = panel.chat_send_btn self.chat_send_btn.clicked.connect(self._chat_send) - row.addWidget(self.chat_input, 1) - # Off/Auto/Manual routing toggle for Co4E (surface key "co4e"). - from .routing_toggle import RoutingToggle - self.co4e_routing_toggle = RoutingToggle(self.ctx, "co4e") + self.co4e_routing_toggle = panel.co4e_routing_toggle self._co4e_routed_provider = None # routing provider override for the next turn - row.addWidget(self.co4e_routing_toggle) - row.addWidget(self.chat_send_btn) - crow.addWidget(_inp) - lay.addWidget(self.chat_input_row) - # Default = COLLAPSED: only the "Messages" header shows; the chat box is - # hidden and the canvas gets the room until the user expands it. self._vsplit_sizes = [540, 220] # sizes to restore when expanded self._msgs_collapsed = True - self.chat_stack.hide() - self.chat_input_row.hide() - self.chat_toggle_btn.setToolTip(tr("co4e.tt_expand_msgs")) - w.setMaximumHeight(self._mhdr.sizeHint().height() + 6) - return w + return panel def _toggle_messages(self) -> None: """Show/hide the WHOLE chat box (message list + composer) below the