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

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

@@ -1,6 +1,6 @@
 {
   "name": "agent-tune-kit",
-  "version": "2.3.4",
+  "version": "2.4.0",
   "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.4 → agent_tune_kit-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-tune-kit
-Version: 2.3.4
+Version: 2.4.0
 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
@@ -180,7 +180,7 @@ $atk-trace-optimize Implement the selected plan for ISSUE-001 in session <sessio
 $atk-trace-verify Verify the candidate for ISSUE-001 in session <session-id> and check relevant behavior that should still work.
 ```
 
-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.
+Without specified issues, diagnosis reviews all available session traces and works through existing and newly found issues, 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.
 
@@ -196,6 +196,6 @@ Each session archive is stored under `.atk/traces/<session_id>/` in your Agent p
 
 [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)
+[Multi-project attribution and filtering details (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.
+Use `atk trace project` to register workspace projects and submodules. Record associated projects with reasonable causal explanations for human review, and filter them in the dashboard and session issue list. Associations do not require a completed or verified fix; reasons describe uncertainty, and repair details describe modification locations.

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

@@ -166,7 +166,7 @@ $atk-trace-optimize Implement the selected plan for ISSUE-001 in session <sessio
 $atk-trace-verify Verify the candidate for ISSUE-001 in session <session-id> and check relevant behavior that should still work.
 ```
 
-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.
+Without specified issues, diagnosis reviews all available session traces and works through existing and newly found issues, 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.
 
@@ -182,6 +182,6 @@ Each session archive is stored under `.atk/traces/<session_id>/` in your Agent p
 
 [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)
+[Multi-project attribution and filtering details (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.
+Use `atk trace project` to register workspace projects and submodules. Record associated projects with reasonable causal explanations for human review, and filter them in the dashboard and session issue list. Associations do not require a completed or verified fix; reasons describe uncertainty, and repair details describe modification locations.

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

@@ -153,7 +153,7 @@ $atk-visualize-trace 打开 <session-id> 的执行泳道，从问题跳到相关
 
 采集、分析、诊断、修复和验证 Skill 在阶段结束后默认生成或更新 `.atk/traces/<session_id>/preview.html`，不自动打开浏览器。需要打开时使用 `$atk-visualize-trace`；已打开的页面在文件更新后需刷新。初始化没有会话轨迹，不生成空页面。
 
-这些阶段同时刷新项目大盘 `.atk/traces/index.html`，按会话或异常分类查看全部会话的问题和实际进度，并可跳回各会话页。需要打开时发送 `$atk-visualize-trace 打开轨迹大盘`。早于分类功能的问题显示为“未分类”，对应会话重新分析时补上。
+这些阶段同时刷新项目大盘 `.atk/traces/index.html`，按会话或问题分类查看全部会话的问题和实际进度，并可跳回各会话页。需要打开时发送 `$atk-visualize-trace 打开轨迹大盘`。早于分类功能的问题显示为“未分类”，对应会话重新分析时补上。
 
 可用 Trace ID 定位会话内的证据，在问题详情中查看保留理由。分享 HTML 前请核对其中留存的正文。
 
@@ -166,7 +166,7 @@ $atk-trace-optimize 实施 <session-id> 的 ISSUE-001 已选定的方案。
 $atk-trace-verify 验证 <session-id> 的 ISSUE-001 对应候选，并检查相关正常行为。
 ```
 
-未指定异常时，调查默认检查会话中可用的全部轨迹，逐项处理已记录和新发现的异常，优先定位与项目代码、配置、工具契约、Prompt 或 Skill 直接相关的原因。证据确认与现有实现无关的异常可以忽略，并说明理由。关联尚不明确的异常保留待查。指定异常或具体症状时，按指定范围调查。可以直接从调查开始，无需先单独执行检测。
+未指定问题时，调查默认检查会话中可用的全部轨迹，逐项处理已记录和新发现的问题，优先定位与项目代码、配置、工具契约、Prompt 或 Skill 直接相关的原因。证据确认与现有实现无关的问题可以忽略，并说明理由。关联尚不明确的问题保留待查。指定问题或具体症状时，按指定范围调查。可以直接从调查开始，无需先单独执行检测。
 
 诊断和验证结论分别按问题保存。证据不足以确认实际加载的候选或关键验证条件时，验证效果记为 `inconclusive`（无法判断）。调查结果会说明未检查的范围和证据缺口。后续发现新的问题，可继续按问题处理，或用新会话的轨迹开始下一次分析。
 
@@ -182,6 +182,6 @@ $atk-trace-verify 验证 <session-id> 的 ISSUE-001 对应候选，并检查相
 
 [轨迹调优指南，包含来源配置、支持格式和归档结构](docs/trace-tuning.md)
 
-[多工程关联与项目筛选方案（待实现）](docs/trace-project-attribution-design.md)
+[多工程关联与项目筛选说明](docs/trace-project-attribution-design.md)
 
-支持通过 `atk trace project` 登记工作区及子模块；诊断可记录多个根因项目，大盘与会话问题栏按根因项目筛选。修改位置在修复详情中说明。
+支持通过 `atk trace project` 登记工作区及子模块；诊断按合理的原因解释记录“关联项目”，供人工审核，大盘与会话问题栏均可筛选。关联不以修复完成或验证通过为前提；不确定性写在关联理由中，修改位置在修复详情中说明。

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

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

{agent_tune_kit-2.3.4 → agent_tune_kit-2.4.0}/agent_tune_kit/traces/projects.py

@@ -1,4 +1,4 @@
-"""Workspace project registry and evidence-backed attribution."""
+"""Workspace project registry and issue associations for human review."""
 
 import configparser
 import hashlib
@@ -150,14 +150,12 @@ def validate_links(session_dir, links):
     projects = project_map(Path(session_dir).parent)
     seen = set()
     for link in links:
-        if not isinstance(link, dict):
+        if not isinstance(link, dict) or set(link) - {"project_id", "reason", "evidence", "source_paths"}:
             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:
+        key = link.get("project_id")
+        if not isinstance(key, str) or key 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()
@@ -176,26 +174,84 @@ def validate_links(session_dir, links):
     return links
 
 
-def root_projects(root, issue):
-    projects = project_map(root)
+def _display_name(entry, project_id):
+    return entry.get("abbreviation") or entry.get("name") or project_id
+
+
+def linked_projects(root, issue, projects=None):
+    """Return the display identity of each project an issue links to, once per project.
+
+    Pages only need the stable ID, the shown name and aliases for search; the rest of the registry stays out of them.
+    Pass ``projects`` (from ``project_map``) when resolving many issues so the registry is read once.
+    """
+    projects = project_map(root) if projects is None else projects
     result = []
     links = issue.get("project_links", [])
     if not isinstance(links, list):
         return result
+    seen = set()
     for link in links:
-        if (
-            not isinstance(link, dict)
-            or not isinstance(link.get("project_id"), str)
-            or link.get("role") != "root_cause"
-        ):
+        if not isinstance(link, dict) or not isinstance(link.get("project_id"), str) or link["project_id"] in seen:
             continue
-        entry = projects.get(link["project_id"], {})
+        project_id = link["project_id"]
+        seen.add(project_id)
+        entry = projects.get(project_id, {})
+        aliases = entry.get("aliases")
+        result.append(
+            {
+                "id": project_id,
+                "name": _display_name(entry, project_id),
+                "aliases": [alias for alias in aliases if isinstance(alias, str)] if isinstance(aliases, list) else [],
+            }
+        )
+    return result
+
+
+def project_index(root, linked, projects=None):
+    """Summarize the projects that issues actually link to, for the pages' single-choice project filter.
+
+    ``linked`` yields ``(session_key, linked_projects)`` per issue. Registered projects without any linked issue are
+    left out: nothing could be found by choosing them. A linked ID missing from the registry stays in, shown by its ID,
+    so its issues remain reachable. Counts are per project; an issue linked to several projects counts once in each,
+    so the entries must not be added up as an issue total.
+    """
+    projects = project_map(root) if projects is None else projects
+    found = {}
+    for session, items in linked:
+        for item in items:
+            entry = found.setdefault(
+                item["id"], {"id": item["id"], "name": item["name"], "issues": 0, "sessions": set()}
+            )
+            entry["issues"] += 1
+            entry["sessions"].add(session)
+    names = {}
+    for entry in found.values():
+        names.setdefault(entry["name"], []).append(entry["id"])
+    result = []
+    for entry in found.values():
+        registered = projects.get(entry["id"])
+        name = entry["name"]
+        if len(names[name]) > 1:
+            # Two projects share an abbreviation: tell the filter's choices apart by where each one lives.
+            tail = Path(registered["path"]).name if registered and registered.get("path") else entry["id"]
+            name = f"{name} · {tail or entry['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",
+                "id": entry["id"],
+                "name": name,
+                "issues": entry["issues"],
+                "sessions": len(entry["sessions"]),
+                "registered": registered is not None,
+                "deprecated": bool(registered and registered.get("deprecated") is True),
             }
         )
+    result.sort(
+        key=lambda item: (
+            item["deprecated"],
+            not item["registered"],
+            -item["issues"],
+            item["name"].casefold(),
+            item["id"],
+        )
+    )
     return result

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

@@ -172,6 +172,7 @@ def prepare_issue(session_dir, data, *, dry_run=False):
             "created_at": now(),
             "status": "open",
             "segments": [],
+            "project_links": [],
         }
     )
     if "project_links" in data:
@@ -347,9 +348,10 @@ def save_diagnosis(session_dir, issue_id, text, diagnosis_id=None, expected_revi
         "description": issue["description"],
         "evidence": issue["evidence"],
         "segments": issue.get("segments", []),
+        "project_links": validate_links(directory, issue.get("project_links", [])),
         "created_at": now(),
     }
-    for optional in ("selection_reason", "category", "project_links"):
+    for optional in ("selection_reason", "category"):
         if optional in issue:
             snapshot[optional] = issue[optional]
     if issue.get("project_links"):

{agent_tune_kit-2.3.4 → agent_tune_kit-2.4.0}/agent_tune_kit/visualize/assets/dataset/app.js

@@ -720,7 +720,7 @@
     box.appendChild(el("p", { text: "导出后由 atk-dataset 导入生效；修改答案不会继承旧确认。" }));
     var feedback = el("textarea", {
       class: "review-note",
-      placeholder: "仅异常项填写：用一句明确反馈描述预期结果或验收标准应如何调整…",
+      placeholder: "仅问题项填写：用一句明确反馈描述预期结果或验收标准应如何调整…",
       oninput: function (ev) {
         setFeedback(row, ev.target.value);
         renderMeta();

{agent_tune_kit-2.3.4 → agent_tune_kit-2.4.0}/agent_tune_kit/visualize/assets/failures/app.js

@@ -17,7 +17,7 @@
     input: "输入",
     expected: "期望",
     actual: "实际输出",
-    reason: "异常原因",
+    reason: "问题原因",
     log: "日志",
   };
 
@@ -488,7 +488,7 @@
       var isAbnormal = ["true", "1", "yes", "y", "异常", "失败", "fail", "failed", "bad"].indexOf(value.toLowerCase()) >= 0;
       if (isAbnormal) {
         return el("div", { class: "cell-text" }, [
-          el("span", { class: "badge issue", text: "● 异常" })
+          el("span", { class: "badge issue", text: "● 问题" })
         ]);
       } else if (value.toLowerCase() === "false") {
         return el("div", { class: "cell-text" }, [
@@ -567,7 +567,7 @@
   function openInspector(row) {
     state.selectedRowNumber = row.rowNumber;
     setText("inspector-row-badge", "#" + row.rowNumber);
-    setText("inspector-title", "异常数据详情");
+    setText("inspector-title", "问题数据详情");
     setText("inspector-subtitle", "case " + rowId(row) + " · " + (roleField("reason") || "保留全部 failure_cases.csv 字段"));
     renderInspectorBody(row);
     if ($("inspector-overlay-pane")) $("inspector-overlay-pane").hidden = false;
@@ -717,8 +717,8 @@
       
       var reasonText = reasonField ? normalizeText(row.values[reasonField]) : "";
       var descBox = el("div", { class: "status-banner-desc-box" });
-      var label = el("strong", { class: "status-banner-desc-label" }, ["异常原因描述："]);
-      var textVal = el("span", { class: "status-banner-desc-val", text: reasonText || "无异常原因描述" });
+      var label = el("strong", { class: "status-banner-desc-label" }, ["问题原因描述："]);
+      var textVal = el("span", { class: "status-banner-desc-val", text: reasonText || "尚未记录问题原因" });
       descBox.appendChild(label);
       descBox.appendChild(textVal);
       content.appendChild(descBox);
@@ -873,14 +873,14 @@
       },
     }, [
       el("option", { value: "", text: "未审阅" }),
-      el("option", { value: "confirmed_failure", text: "确认异常" }),
-      el("option", { value: "false_positive", text: "误报/非异常" }),
+      el("option", { value: "confirmed_failure", text: "确认问题" }),
+      el("option", { value: "false_positive", text: "误报/无问题" }),
       el("option", { value: "needs_followup", text: "需继续分析" }),
     ]);
     select.value = getStatus(row);
     var note = el("textarea", {
       class: "review-note",
-      placeholder: "审阅备注（可选）：记录异常原因、修复建议或复核结论…",
+      placeholder: "审阅备注（可选）：记录问题原因、修复建议或复核结论…",
       oninput: function (ev) {
         setNote(row, ev.target.value);
         renderMeta();
@@ -1248,7 +1248,7 @@
       }
     }, [
       el("span", { html: '<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="#ef4444" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" style="vertical-align: middle;"><circle cx="12" cy="12" r="10"></circle><line x1="12" y1="8" x2="12" y2="12"></line><line x1="12" y1="16" x2="12.01" y2="16"></line></svg>' }),
-      "异常 (" + counts.abnormal + ")"
+      "问题 (" + counts.abnormal + ")"
     ]);
 
     container.appendChild(allBtn);

{agent_tune_kit-2.3.4 → agent_tune_kit-2.4.0}/agent_tune_kit/visualize/assets/failures/page.html

@@ -63,7 +63,7 @@ __ATK_STYLES__
           </div>
 
           <div id="empty-state-all" class="empty-state" hidden>
-            <strong>当前版本没有异常行</strong>
+            <strong>当前版本没有问题样本</strong>
             <span>No failure rows in current failure_cases.csv</span>
           </div>
           <div id="empty-state-filtered" class="empty-state" hidden>
@@ -132,7 +132,7 @@ __ATK_STYLES__
                 </svg>
               </span>
               <div>
-                <span class="stat-label">合并异常用例</span>
+                <span class="stat-label">合并问题用例</span>
                 <strong id="stat-abnormal">0</strong>
                 <span id="stat-abnormal-rate" class="stat-subvalue">失败率 0%</span>
               </div>
@@ -171,7 +171,7 @@ __ATK_STYLES__
           <div class="inspector-title-wrap">
             <span id="inspector-row-badge" class="row-badge">#</span>
             <div>
-              <h2 id="inspector-title">异常数据详情</h2>
+              <h2 id="inspector-title">问题数据详情</h2>
               <p id="inspector-subtitle"></p>
             </div>
           </div>

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

@@ -11,6 +11,7 @@
   --tint: #fff4e9;
   --track: #537b8e;
   --drawer-width: 480px;
+  --control-height: 34px;
   --mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
   --p-pending: #b7c4ce;
   --p-diagnosed: #d8892f;
@@ -37,7 +38,7 @@ h3 { font-size: 14px }
 .topbar { background: white; border-bottom: 1px solid var(--line); position: sticky; top: 0; z-index: 5; flex-shrink: 0 }
 .topbar-inner { max-width: none; margin: 0; padding-inline: clamp(12px, 2vw, 24px); min-height: 52px; display: flex; align-items: center; justify-content: space-between; gap: 16px }
 .brand-line, .topbar-meta { display: flex; align-items: center; gap: 10px }
-.brand-line { min-width: 0 }
+.brand-line { min-width: 0; max-width: 100% }
 .brand { background: var(--brand); color: #fff; border-radius: 6px; padding: 2px 6px; font-weight: 850; letter-spacing: -.04em }
 .brand-line strong { white-space: nowrap }
 .session-id { border-left: 1px solid var(--line); padding-left: 12px; color: var(--muted); font-size: 12px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap }
@@ -62,15 +63,16 @@ h3 { font-size: 14px }
 .progress-dot.excluded { background: transparent; box-shadow: inset 0 0 0 1.5px var(--p-pending) }
 .category-tag { display: inline-block; max-width: 100%; background: #fff8f1; color: var(--accent); font-size: 11px; line-height: 1.5; padding: 2px 6px; border-radius: 4px; text-decoration: none; overflow: hidden; text-overflow: ellipsis; white-space: nowrap }
 a.category-tag:hover { background: #ffe8d2 }
-select {
-  display: block; height: 34px; max-width: 100%; padding: 0 11px;
+input:not([type=checkbox]), select {
+  display: block; height: var(--control-height); min-width: 0; max-width: 100%; padding: 0 11px;
   font-size: 13px; line-height: normal; border-color: #cdd8e1;
 }
 select {
   appearance: none; padding-right: 32px; text-overflow: ellipsis;
   background: white url("data:image/svg+xml;charset=UTF-8,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='%2364748b' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'%3e%3cpolyline points='6 9 12 15 18 9'%3e%3c/polyline%3e%3c/svg%3e") no-repeat right 11px center / 14px;
 }
-select:hover { border-color: #9baebb }
+input:not([type=checkbox]):hover, select:hover { border-color: #9baebb }
+input[type=checkbox] { width: 16px; height: 16px; margin: 0; padding: 0; flex-shrink: 0; accent-color: var(--brand) }
 @media (forced-colors: active) {
   select { appearance: auto; background-image: none; padding-right: 8px }
 }
@@ -89,16 +91,8 @@ select:hover { border-color: #9baebb }
 @media(max-width:800px) {
   .topbar-inner { align-items: flex-start; flex-direction: column; gap: 4px; padding-top: 8px; padding-bottom: 8px }
   h1 { font-size: 18px }
-  .drawer { inset: auto 0 0; width: 100% !important; height: 48vh; height: 48dvh; border-radius: 12px 12px 0 0; border-left: 0; border-top: 1px solid var(--line) }
+  .drawer { inset: auto 0 0; width: 100% !important; max-width: 100%; height: 48vh; height: 48dvh; border-radius: 12px 12px 0 0; border-left: 0; border-top: 1px solid var(--line) }
   .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 }