agent-tune-kit 2.3.2__tar.gz → 2.3.4__tar.gz

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-tune-kit",
-  "version": "2.3.2",
+  "version": "2.3.4",
   "description": "Local Codex plugin for batch Agent evaluation and session trace tuning with evidence-backed issues, focused changes, verification and offline review.",
   "author": {
     "name": "hustyichi",

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-tune-kit
-Version: 2.3.2
+Version: 2.3.4
 Summary: Local Codex plugin for iterative Agent tuning with guided Skills, reusable runner templates, versioned results, and static validation.
 Project-URL: Homepage, https://github.com/hustyichi/agent-tune-kit
 Project-URL: Repository, https://github.com/hustyichi/agent-tune-kit
@@ -171,15 +171,18 @@ These stages also refresh the project dashboard `.atk/traces/index.html`, which
 
 Use Trace IDs to locate evidence within the session and open issue details to read the retention reason. Review any retained content in the HTML before sharing it.
 
-### 3. Investigate, Fix, and Verify an Issue as Needed
+### 3. Investigate a Session or Specific Issues, Then Fix and Verify as Needed
 
 ```text
+$atk-trace-diagnose Investigate session <session-id> and propose repair and verification plans.
 $atk-trace-diagnose Investigate ISSUE-001 in session <session-id> and propose a repair and verification plan.
 $atk-trace-optimize Implement the selected plan for ISSUE-001 in session <session-id>.
 $atk-trace-verify Verify the candidate for ISSUE-001 in session <session-id> and check relevant behavior that should still work.
 ```
 
-Start with diagnosis when you already have a specific issue and session evidence. Each verification records a conclusion per issue. If the evidence cannot establish which candidate loaded or whether key verification conditions were met, the outcome is `inconclusive`. As new issues surface, work through them individually or start another analysis with a new session trace.
+Without specified issues, diagnosis reviews all available session traces and works through existing and newly found anomalies, prioritizing causes directly related to project code, configuration, tool contracts, Prompt or Skill. Findings established as unrelated to the existing implementation may be skipped with an explanation. Findings with uncertain relevance remain open for investigation. Specified issues or concrete symptoms limit the investigation scope. You can start directly with diagnosis without a separate detection invocation.
+
+Diagnoses and verification conclusions are saved per issue. If the evidence cannot establish which candidate loaded or whether key verification conditions were met, the verification outcome is `inconclusive`. Investigation results identify unread ranges and evidence gaps. As new issues surface, work through them individually or start another analysis with a new session trace.
 
 ### Where to Find Trace Outputs
 
@@ -192,3 +195,7 @@ Each session archive is stored under `.atk/traces/<session_id>/` in your Agent p
 | `issues/<issue-id>/` | Issue evidence, diagnoses, and changes. Each verification's `result.json` records its status, conclusion, and evidence references |
 
 [Trace tuning guide for source configuration, supported formats, and archive layout](docs/trace-tuning.md)
+
+[Multi-project attribution and filtering proposal (not yet implemented, Chinese)](docs/trace-project-attribution-design.md)
+
+Use `atk trace project` to register workspace projects and submodules. Issues can have multiple root-cause projects, filterable in the dashboard and session issue list. Repair details describe modification locations.

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/README.en.md

@@ -157,15 +157,18 @@ These stages also refresh the project dashboard `.atk/traces/index.html`, which
 
 Use Trace IDs to locate evidence within the session and open issue details to read the retention reason. Review any retained content in the HTML before sharing it.
 
-### 3. Investigate, Fix, and Verify an Issue as Needed
+### 3. Investigate a Session or Specific Issues, Then Fix and Verify as Needed
 
 ```text
+$atk-trace-diagnose Investigate session <session-id> and propose repair and verification plans.
 $atk-trace-diagnose Investigate ISSUE-001 in session <session-id> and propose a repair and verification plan.
 $atk-trace-optimize Implement the selected plan for ISSUE-001 in session <session-id>.
 $atk-trace-verify Verify the candidate for ISSUE-001 in session <session-id> and check relevant behavior that should still work.
 ```
 
-Start with diagnosis when you already have a specific issue and session evidence. Each verification records a conclusion per issue. If the evidence cannot establish which candidate loaded or whether key verification conditions were met, the outcome is `inconclusive`. As new issues surface, work through them individually or start another analysis with a new session trace.
+Without specified issues, diagnosis reviews all available session traces and works through existing and newly found anomalies, prioritizing causes directly related to project code, configuration, tool contracts, Prompt or Skill. Findings established as unrelated to the existing implementation may be skipped with an explanation. Findings with uncertain relevance remain open for investigation. Specified issues or concrete symptoms limit the investigation scope. You can start directly with diagnosis without a separate detection invocation.
+
+Diagnoses and verification conclusions are saved per issue. If the evidence cannot establish which candidate loaded or whether key verification conditions were met, the verification outcome is `inconclusive`. Investigation results identify unread ranges and evidence gaps. As new issues surface, work through them individually or start another analysis with a new session trace.
 
 ### Where to Find Trace Outputs
 
@@ -178,3 +181,7 @@ Each session archive is stored under `.atk/traces/<session_id>/` in your Agent p
 | `issues/<issue-id>/` | Issue evidence, diagnoses, and changes. Each verification's `result.json` records its status, conclusion, and evidence references |
 
 [Trace tuning guide for source configuration, supported formats, and archive layout](docs/trace-tuning.md)
+
+[Multi-project attribution and filtering proposal (not yet implemented, Chinese)](docs/trace-project-attribution-design.md)
+
+Use `atk trace project` to register workspace projects and submodules. Issues can have multiple root-cause projects, filterable in the dashboard and session issue list. Repair details describe modification locations.

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/README.md

@@ -157,15 +157,18 @@ $atk-visualize-trace 打开 <session-id> 的执行泳道，从问题跳到相关
 
 可用 Trace ID 定位会话内的证据，在问题详情中查看保留理由。分享 HTML 前请核对其中留存的正文。
 
-### 3. 按问题调查、修复和验证（按需）
+### 3. 调查会话或指定问题，按需修复和验证
 
 ```text
+$atk-trace-diagnose 调查 <session-id>，给出修复和验证方案。
 $atk-trace-diagnose 调查 <session-id> 的 ISSUE-001，给出修复和验证方案。
 $atk-trace-optimize 实施 <session-id> 的 ISSUE-001 已选定的方案。
 $atk-trace-verify 验证 <session-id> 的 ISSUE-001 对应候选，并检查相关正常行为。
 ```
 
-已有明确问题和会话证据时，可以从调查开始。每次验证按问题保存结论。证据不足以确认实际加载的候选或关键验证条件时，效果记为 `inconclusive`（无法判断）。后续发现新的问题，可继续按问题处理，或用新会话的轨迹开始下一次分析。
+未指定异常时，调查默认检查会话中可用的全部轨迹，逐项处理已记录和新发现的异常，优先定位与项目代码、配置、工具契约、Prompt 或 Skill 直接相关的原因。证据确认与现有实现无关的异常可以忽略，并说明理由。关联尚不明确的异常保留待查。指定异常或具体症状时，按指定范围调查。可以直接从调查开始，无需先单独执行检测。
+
+诊断和验证结论分别按问题保存。证据不足以确认实际加载的候选或关键验证条件时，验证效果记为 `inconclusive`（无法判断）。调查结果会说明未检查的范围和证据缺口。后续发现新的问题，可继续按问题处理，或用新会话的轨迹开始下一次分析。
 
 ### 查看轨迹产物
 
@@ -178,3 +181,7 @@ $atk-trace-verify 验证 <session-id> 的 ISSUE-001 对应候选，并检查相
 | `issues/<issue-id>/` | 查看问题证据、诊断和改动。各次验证的 `result.json` 记录验证状态、结论和证据引用 |
 
 [轨迹调优指南，包含来源配置、支持格式和归档结构](docs/trace-tuning.md)
+
+[多工程关联与项目筛选方案（待实现）](docs/trace-project-attribution-design.md)
+
+支持通过 `atk trace project` 登记工作区及子模块；诊断可记录多个根因项目，大盘与会话问题栏按根因项目筛选。修改位置在修复详情中说明。

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/agent_tune_kit/__init__.py

@@ -1,3 +1,3 @@
 """Agent Tune Kit package."""
 
-__version__ = "2.3.2"
+__version__ = "2.3.4"

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/agent_tune_kit/cli/trace.py

@@ -34,6 +34,13 @@ def register(subparsers):
     init.add_argument("--config", help="non-secret configuration JSON file")
     init.add_argument("--project-file", help="project context Markdown file")
     init.add_argument("--json", action="store_true")
+    project = actions.add_parser("project", help="discover, list or update workspace projects")
+    project.add_argument("--project-root", default=".")
+    mode = project.add_mutually_exclusive_group(required=True)
+    mode.add_argument("--discover", action="store_true")
+    mode.add_argument("--list", action="store_true")
+    mode.add_argument("--data")
+    project.add_argument("--json", action="store_true")
     category = actions.add_parser("category", help="list or update the project issue category vocabulary")
     category.add_argument("--project-root", default=".")
     mode = category.add_mutually_exclusive_group(required=True)
@@ -100,9 +107,18 @@ def register(subparsers):
             parser.add_argument("--issue-id", required=True)
             parser.add_argument("--file", required=True, help="root cause and repair/verification plan Markdown")
             parser.add_argument("--diagnosis-id")
+            parser.add_argument("--expected-revision", type=int)
 
 
 def execute(args):
+    if args.action == "project":
+        from agent_tune_kit.traces.projects import discover_projects, load_projects, save_project
+
+        if args.discover:
+            return discover_projects(args.project_root)
+        if args.list:
+            return load_projects(store.trace_root(args.project_root))
+        return save_project(args.project_root, read_json(args.data))
     if args.action == "init":
         text = Path(args.project_file).read_text(encoding="utf-8") if args.project_file else None
         return store.init_workspace(args.project_root, config=read_json(args.config), project_text=text)
@@ -162,6 +178,7 @@ def execute(args):
             args.issue_id,
             Path(args.file).read_text(encoding="utf-8"),
             diagnosis_id=args.diagnosis_id,
+            expected_revision=args.expected_revision,
         )
     data = read_json(args.data)
     if args.action == "issue":

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/agent_tune_kit/traces/archive.py

@@ -19,7 +19,7 @@ def component(value):
         raise UserActionRequired("An explicit nonempty native ID is required.")
     name = quote(value, safe="")
     # Names of the files that live beside session directories at the archive root.
-    reserved = {"project.md", "config.json", "categories.json", "index.html", "_export_summary"}
+    reserved = {"project.md", "config.json", "categories.json", "projects.json", "index.html", "_export_summary"}
     if name.startswith(".") or name.casefold() in reserved:
         name = "%" + format(ord(name[0]), "02X") + name[1:]
     if len(name) > 200:

agent_tune_kit-2.3.4/agent_tune_kit/traces/projects.py

@@ -0,0 +1,201 @@
+"""Workspace project registry and evidence-backed attribution."""
+
+import configparser
+import hashlib
+import subprocess
+from pathlib import Path
+
+from agent_tune_kit.errors import UserActionRequired
+from agent_tune_kit.results.evidence import safe_path, write_manifest
+
+from .store import ensure_workspace, read_json, session_write_lock, validate_ref
+
+
+def load_projects(root):
+    path = safe_path(Path(root), "projects.json")
+    if not path.exists():
+        return {"schema_version": 1, "revision": 0, "projects": []}
+    value = read_json(path)
+    if (
+        value.get("schema_version") != 1
+        or type(value.get("revision")) is not int
+        or not isinstance(value.get("projects"), list)
+    ):
+        raise UserActionRequired("Invalid project registry.")
+    seen = set()
+    for item in value["projects"]:
+        if (
+            not isinstance(item, dict)
+            or any(not isinstance(item.get(k), str) or not item[k] for k in ("id", "name", "path"))
+            or item["id"] in seen
+        ):
+            raise UserActionRequired("Invalid project entry.")
+        seen.add(item["id"])
+    return value
+
+
+def project_map(root):
+    try:
+        return {item["id"]: item for item in load_projects(root)["projects"]}
+    except (UserActionRequired, KeyError, TypeError):
+        return {}
+
+
+def save_project(project_root, data):
+    if not isinstance(data, dict) or not isinstance(data.get("id"), str) or not data["id"].strip():
+        raise UserActionRequired("Project needs a stable id.")
+    root, _ = ensure_workspace(project_root)
+    with session_write_lock(root):
+        catalog = load_projects(root)
+        if type(data.get("revision", 0)) is not int or data.get("revision", 0) != catalog["revision"]:
+            raise UserActionRequired("Stale project registry revision.")
+        entries = {item["id"]: item for item in catalog["projects"]}
+        entry = {**entries.get(data["id"], {}), **{k: v for k, v in data.items() if k != "revision"}}
+        for key in ("name", "path"):
+            if not isinstance(entry.get(key), str) or not entry[key].strip():
+                raise UserActionRequired(f"Project needs {key}.")
+        base = Path(project_root).resolve()
+        target = (base / entry["path"]).resolve()
+        if Path(entry["path"]).is_absolute() or not target.is_relative_to(base):
+            raise UserActionRequired("Project path must stay within workspace.")
+        entry["path"] = target.relative_to(base).as_posix()
+        if entry.get("kind", "directory") not in {"repository", "submodule", "directory"}:
+            raise UserActionRequired("Invalid project kind.")
+        for key in ("abbreviation", "description"):
+            if key in entry and not isinstance(entry[key], str):
+                raise UserActionRequired(f"Project {key} must be text.")
+        for key in ("aliases", "entrypoints"):
+            if key in entry and (not isinstance(entry[key], list) or not all(isinstance(v, str) for v in entry[key])):
+                raise UserActionRequired(f"Project {key} must be a list of strings.")
+        if entry.get("parent_id") is not None and not isinstance(entry["parent_id"], str):
+            raise UserActionRequired("Invalid parent project.")
+        if "deprecated" in entry and not isinstance(entry["deprecated"], bool):
+            raise UserActionRequired("deprecated must be boolean.")
+        entries[entry["id"]] = entry
+        for item in entries.values():
+            seen = {item["id"]}
+            parent = item.get("parent_id")
+            while parent:
+                if parent in seen or parent not in entries:
+                    raise UserActionRequired("Unknown or cyclic parent project.")
+                seen.add(parent)
+                parent = entries[parent].get("parent_id")
+        if len({e["path"] for e in entries.values()}) != len(entries):
+            raise UserActionRequired("Project path already registered.")
+        catalog.update(revision=catalog["revision"] + 1, projects=list(entries.values()))
+        write_manifest(root / "projects.json", catalog)
+        return catalog
+
+
+def discover_projects(project_root):
+    base = Path(project_root).resolve()
+    found = []
+    visited = set()
+
+    def visit(path, parent=None):
+        if path in visited:
+            return
+        visited.add(path)
+        relative = path.relative_to(base).as_posix()
+        project_id = "project-" + hashlib.sha256(relative.encode()).hexdigest()[:16]
+        readable = path.is_dir() and (parent is None or (path / ".git").exists())
+        found.append(
+            {
+                "id": project_id,
+                "name": path.name,
+                "path": relative,
+                "parent_id": parent,
+                "kind": "submodule" if parent else "repository",
+                "readable": readable,
+                "entrypoints": [
+                    str(f.relative_to(base))
+                    for f in path.iterdir()
+                    if f.is_file() and f.name.lower() in {"readme.md", "claude.md", "agents.md", "rules.md"}
+                ]
+                if readable
+                else [],
+            }
+        )
+        modules = path / ".gitmodules"
+        children = set()
+        if modules.is_file():
+            config = configparser.ConfigParser()
+            config.read(modules)
+            for section in config.sections():
+                child = (path / config.get(section, "path")).resolve()
+                if not child.is_relative_to(base) or child == path or path.is_relative_to(child):
+                    raise UserActionRequired("Submodule path escapes project.")
+                children.add(child)
+
+        if readable:
+            result = subprocess.run(
+                ["git", "-C", str(path), "ls-files", "--stage", "-z"], capture_output=True, check=False
+            )
+            if result.returncode == 0:
+                for row in result.stdout.decode("utf-8", errors="replace").split("\0"):
+                    if row.startswith("160000 ") and "\t" in row:
+                        children.add((path / row.split("\t", 1)[1]).resolve())
+        for child in sorted(children):
+            if not child.is_relative_to(base) or child == path or path.is_relative_to(child):
+                raise UserActionRequired("Submodule path escapes project.")
+            visit(child, project_id)
+
+    visit(base)
+    return {"projects": found}
+
+
+def validate_links(session_dir, links):
+    if not isinstance(links, list):
+        raise UserActionRequired("project_links must be a list.")
+    projects = project_map(Path(session_dir).parent)
+    seen = set()
+    for link in links:
+        if not isinstance(link, dict):
+            raise UserActionRequired("Invalid project link.")
+        key = (link.get("project_id"), link.get("role"))
+        if not all(isinstance(k, str) for k in key) or key[0] not in projects or key in seen:
+            raise UserActionRequired("Unknown or duplicate project link.")
+        seen.add(key)
+        if key[1] not in {"root_cause", "improvement"} or link.get("evidence_state") not in {"hypothesis", "supported"}:
+            raise UserActionRequired("Invalid project attribution state.")
+        if (
+            not isinstance(link.get("reason"), str)
+            or not link["reason"].strip()
+            or not isinstance(link.get("evidence"), list)
+            or not link["evidence"]
+        ):
+            raise UserActionRequired("Project attribution needs reason and retained evidence.")
+        for ref in link["evidence"]:
+            validate_ref(session_dir, ref)
+        if not isinstance(link.get("source_paths", []), list):
+            raise UserActionRequired("source_paths must be a list.")
+        for path in link.get("source_paths", []):
+            if not isinstance(path, str):
+                raise UserActionRequired("Source path must be workspace relative text.")
+            safe_path(Path(session_dir).parent.parent.parent, path)
+    return links
+
+
+def root_projects(root, issue):
+    projects = project_map(root)
+    result = []
+    links = issue.get("project_links", [])
+    if not isinstance(links, list):
+        return result
+    for link in links:
+        if (
+            not isinstance(link, dict)
+            or not isinstance(link.get("project_id"), str)
+            or link.get("role") != "root_cause"
+        ):
+            continue
+        entry = projects.get(link["project_id"], {})
+        result.append(
+            {
+                **entry,
+                "id": link["project_id"],
+                "name": entry.get("abbreviation") or entry.get("name") or link["project_id"],
+                "pending": link.get("evidence_state") != "supported",
+            }
+        )
+    return result

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/agent_tune_kit/traces/records.py

@@ -10,6 +10,7 @@ from agent_tune_kit.results.evidence import json_bytes, now, safe_path, write_ma
 from agent_tune_kit.utils.files import write_text_atomic
 
 from .categories import check_issue_category
+from .projects import load_projects, validate_links
 from .segments import resolve_segments, segments_for_storage
 from .store import (
     STATES,
@@ -173,6 +174,8 @@ def prepare_issue(session_dir, data, *, dry_run=False):
             "segments": [],
         }
     )
+    if "project_links" in data:
+        issue["project_links"] = validate_links(directory, data["project_links"])
     if "category" in data:
         data["category"] = check_issue_category(
             directory.parent, data["category"], previous.get("category") if previous else None
@@ -227,6 +230,7 @@ def prepare_issue(session_dir, data, *, dry_run=False):
                     "description",
                     "selection_reason",
                     "category",
+                    "project_links",
                     "evidence",
                     "segments",
                     "status",
@@ -325,9 +329,11 @@ def save_detection(session_dir, data):
 
 
 @_locked_write
-def save_diagnosis(session_dir, issue_id, text, diagnosis_id=None):
+def save_diagnosis(session_dir, issue_id, text, diagnosis_id=None, expected_revision=None):
     directory = Path(session_dir)
     issue = load_issue(directory, issue_id)
+    if expected_revision is not None and expected_revision != issue["revision"]:
+        raise UserActionRequired("Stale diagnosis issue revision.")
     if not isinstance(text, str) or not text.strip():
         raise UserActionRequired("Diagnosis must contain an explanation and a plan.")
     diagnosis_id = _id(diagnosis_id, "DIA")
@@ -343,9 +349,11 @@ def save_diagnosis(session_dir, issue_id, text, diagnosis_id=None):
         "segments": issue.get("segments", []),
         "created_at": now(),
     }
-    for optional in ("selection_reason", "category"):
+    for optional in ("selection_reason", "category", "project_links"):
         if optional in issue:
             snapshot[optional] = issue[optional]
+    if issue.get("project_links"):
+        snapshot["project_registry"] = load_projects(directory.parent)
     _refs(directory, issue["evidence"])
     for segment in snapshot["segments"]:
         _refs(directory, segment["evidence"])
@@ -502,6 +510,19 @@ def save_change(session_dir, issue_id, data):
     if not previous and change["status"] != "running":
         raise UserActionRequired("Save a running change before applying the implementation.")
     _validate_change_summary(change)
+    for summary in change.get("change_summary", []):
+        if isinstance(summary, dict) and "project_id" in summary:
+            from .projects import project_map
+
+            entry = project_map(directory.parent).get(summary["project_id"])
+            if entry is None:
+                raise UserActionRequired("Unknown modification project.")
+            base = directory.parent.parent.parent.resolve()
+            project_path = (base / entry["path"]).resolve()
+            for file in summary.get("files", []):
+                target = safe_path(base, file)
+                if not target.resolve().is_relative_to(project_path):
+                    raise UserActionRequired("Modification file is outside its project.")
     for field in ("verifications", "schema_version", "owner_issue", "created_at"):
         if field in data and (not previous or data[field] != previous.get(field)):
             raise UserActionRequired(f"Change {field} is managed by its dedicated operation.")

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/agent_tune_kit/traces/store.py

@@ -199,6 +199,7 @@ def load_session(session_dir):
         manifest = value.get("archive")
         if (
             directory.name != archive.component(value.get("session_id"))
+            and not (directory.name == "projects.json" and value.get("session_id") == "projects.json")
             or value.get("source") != normalize_source(value.get("source"))
             or not isinstance(manifest, dict)
             or not isinstance(manifest.get("files"), list)

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/shared/base.css

@@ -93,3 +93,12 @@ select:hover { border-color: #9baebb }
   .drawer.above-record { inset: 0 0 auto; border-radius: 0 0 12px 12px; border-top: 0; border-bottom: 1px solid var(--line) }
   .drawer-resizer { display: none }
 }
+
+/* Project attribution belongs to issues; the menu is shared by both issue views. */
+.project-choice { position: relative; margin-bottom: 7px; font-size: 13px }
+.project-choice summary { height: 34px; padding: 6px 12px; border: 1px solid #cdd8e1; border-radius: 6px; background: white }
+.project-choice summary:hover { border-color: #9baebb }
+.project-menu { position: absolute; right: 0; z-index: 20; width: min(300px, 80vw); max-height: 320px; overflow: auto; padding: 12px; border: 1px solid var(--line); border-radius: 6px; background: white; box-shadow: 0 6px 20px #0002 }
+.project-menu p { margin: 0 0 8px }
+#project-filter label { display: flex; align-items: center; gap: 8px; padding: 6px 0 }
+#project-filter input { width: 16px; height: 16px; min-width: 16px; padding: 0 }

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/trace/app.js

@@ -21,6 +21,33 @@
   let investigation = null, scopeBefore = null, previewIssue = null, expandedFolds = new Set(), railFilter = null;
   const captureById = new Map(data.captures.map(c => [c.id, c]));
   const issueById = new Map(data.issues.map(item => [item.record.id, item]));
+
+  const projectSelection = new Set(new URLSearchParams(location.hash.slice(1)).getAll("project"));
+  const projectMatches = item => !projectSelection.size || [...projectSelection].some(id => {
+    const roots = item.root_projects || [];
+    if (id === "~unattributed") return !roots.length;
+    return roots.some(root => { let current = root.id; const seen = new Set(); while (current && !seen.has(current)) { if (current === id) return true; seen.add(current); current = data.projects?.[current]?.parent_id; } return false; });
+  });
+  const projectText = item => (item.root_projects || []).map(p => p.name + (p.pending ? "（待确认）" : "")).join("、") || "待归因";
+  const projectInputs = [];
+  for (const p of [{id: "~unattributed", name: "待归因"}, ...Object.values(data.projects || {})]) {
+    const label = el("label"), input = el("input");
+    input.type = "checkbox"; input.value = p.id;
+    input.checked = projectSelection.has(p.id);
+    label.append(input, document.createTextNode(p.abbreviation || p.name));
+    $("project-filter").append(label); projectInputs.push(input);
+    input.onchange = () => $("project-filter").onchange();
+  }
+  const updateProjectSummary = () => {
+    $("project-summary").textContent = projectSelection.size ? `关联项目：已选 ${projectSelection.size} 项` : "关联项目：全部";
+  };
+  updateProjectSummary();
+  $("project-clear").onclick = () => { projectInputs.forEach(input => { input.checked = false; }); $("project-filter").onchange(); };
+  $("project-choice").onkeydown = event => { if (event.key === "Escape") { $("project-choice").open = false; $("project-summary").focus(); } };
+  document.addEventListener("click", event => {
+    if (!event.target.closest("#project-choice")) $("project-choice").open = false;
+  });
+
   const filters = ["trace-filter", "type-filter", "trace-search", "record-mode"];
   const list = $("trace-list"), scroller = $("trace-scroll");
   const scope = () => $("trace-filter").value === "" ? null : Number($("trace-filter").value);
@@ -257,6 +284,7 @@
       return;
     }
     for (const [index, diagnosis] of item.diagnoses.slice().reverse().entries()) {
+      const snapshot = diagnosis.snapshot;
       const body = diagnosis.error ? el("p", diagnosis.error, "warning") : renderDiagnosis(diagnosis.text);
       const headings = [...body.children].filter(node => node.tagName === "H2").map(node => node.textContent);
       const structured = headings.join("|") === "异常描述|异常根因|最小修复方案"
@@ -275,6 +303,11 @@
         container.append(description);
       }
       const details = el("details", undefined, "detail-section");
+      if (snapshot?.project_links) {
+        const entries = new Map((snapshot.project_registry?.projects || []).map(p => [p.id, p]));
+        const names = snapshot.project_links.filter(p => p.role === "root_cause").map(p => { const entry = entries.get(p.project_id); return (entry?.abbreviation || entry?.name || p.project_id) + (p.evidence_state === "supported" ? "" : "（待确认）"); });
+        body.prepend(el("p", `诊断时的关联项目：${names.join("、") || "待归因"}`));
+      }
       const name = diagnosis.reference.path.split("/").pop();
       details.append(el("summary", `展开原诊断 · ${name}`), body);
       container.append(details);
@@ -373,7 +406,7 @@
     $("drawer-content").append(tabs);
     if (stage === "issue") {
       const description = section("问题描述");
-      description.append(el("p", issue.description || issue.title));
+      description.append(el("p", `关联项目：${projectText(item)}`), el("p", issue.description || issue.title));
       $("drawer-content").append(description);
       if (typeof issue.selection_reason === "string" && issue.selection_reason.trim()) {
         const reason = section("保留理由");
@@ -969,6 +1002,7 @@
     const text = $("issue-search").value.toLocaleLowerCase();
     const status = $("issue-status").value;
     const filtered = data.issues.filter(item => {
+      if (!projectMatches(item) && new URLSearchParams(location.hash.slice(1)).get("issue") !== item.record.id) return false;
       if (railFilter && !railFilter.ids.includes(item.record.id)) return false;
       const progress = progressOf(item).label;
       if (status && progress !== status) return false;
@@ -994,6 +1028,11 @@
       const head = el("div", undefined, "issue-card-head");
       head.append(el("span", issue.id, "issue-id-text"), el("span", undefined, `progress-dot ${progress.klass}`));
       const body = el("div", undefined, "issue-card-body");
+      const projects = el("p", `关联项目：${projectText(item)}`);
+      if (data.dashboard.available) for (const project of item.root_projects || []) {
+        const link = el("a", project.name); link.href = dashboardHash(`view=category&project=${encodeURIComponent(project.id)}`); projects.append(link);
+      }
+      body.append(projects);
       body.append(el("h3", issue.title || "问题"), el("div", progress.label, "issue-progress"));
       const tag = categoryTag(issue.category);
       if (tag) body.append(tag);
@@ -1083,6 +1122,7 @@
   $("capture-filter").closest("label").hidden = Boolean(currentCapture?.current);
   options($("capture-filter"), data.captures.map(c => c.id));
   if (currentCapture) $("capture-filter").value = currentCapture.id;
+  $("project-filter").onchange = () => { projectSelection.clear(); for (const input of projectInputs) if (input.checked) projectSelection.add(input.value); updateProjectSummary(); const params = new URLSearchParams(location.hash.slice(1)); params.delete("project"); for (const id of projectSelection) params.append("project", id); history.replaceState(null, "", `#${params}`); renderIssueRail(); };
   $("capture-filter").onchange = () => { investigation = null; scopeBefore = null; railFilter = null; chooseCapture(); renderIssueRail(); renderTraces(); };
   $("trace-filter").onchange = () => focusTrace(scope());
   for (const id of ["trace-search","type-filter","record-mode"]) $(id).addEventListener(id === "trace-search" ? "input" : "change", () => renderTraces());

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/trace/page.html

@@ -21,7 +21,8 @@
       </div>
       <div class="rail-filters">
         <label class="search-label"><span class="sr-only">搜索问题</span><input id="issue-search" type="search" placeholder="搜索问题"></label>
-        <label><span class="sr-only">状态</span><select id="issue-status"></select></label>
+        <details id="project-choice" class="project-choice"><summary id="project-summary">关联项目：全部</summary><div class="project-menu"><p>含子项目</p><button id="project-clear" type="button">清空筛选</button><div id="project-filter" role="group" aria-label="关联项目"></div></div></details>
+      <label><span class="sr-only">状态</span><select id="issue-status"></select></label>
       </div>
       <div id="issue-rail-list" class="rail-list"></div>
     </aside>

{agent_tune_kit-2.3.2 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/trace/styles.css

@@ -30,6 +30,9 @@ body.rail-collapsed #rail-toggle { transform: rotate(180deg) }
 .rail-filters .search-label { flex: 1; min-width: 0 }
 .rail-filters input, .rail-filters select { width: 100%; height: 32px; font-size: 12px; padding: 0 8px }
 .rail-filters select { width: auto; min-width: 88px }
+.rail-filters .project-choice { margin-bottom: 0; font-size: 12px }
+.rail-filters .project-choice summary { height: 32px; padding: 6px 8px; white-space: nowrap }
+.rail-filters .project-menu { left: 0; right: auto }
 .rail-list { flex: 1; min-height: 0; overflow: auto; padding: 8px; display: flex; flex-direction: column; gap: 8px }
 .issue-card { display: flex; flex-direction: column; gap: 6px; width: 100%; text-align: left; padding: 10px }
 .issue-card-head { justify-content: space-between; gap: 6px; width: 100% }