Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[workshop-sync] side-quest-25-01-audit-reference.md: wrong artifact file names (safeoutputs.jsonl, mcp-logs/) and unverifiable "⌖ AIC" terminolo

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#4,451 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
84/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
javascript
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với workshop/side-quest-25-01-audit-reference.md và đối chiếu tên các hiện vật cùng thuật ngữ AIC với những hiện vật được tham chiếu và tài liệu về kiểm toán cũng như quản lý chi phí. Cập nhật các tên tệp được liệt kê, hướng dẫn về nhật ký MCP và cách diễn đạt AIC của bộ phân loại để khớp với các tài liệu tham chiếu đó. Công việc hoàn tất khi tệp workshop sử dụng các tên đã được tài liệu hóa và mô tả AIC của bộ phân loại trong ngữ cảnh Model Routing.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

documentation

Workshop file reviewed

workshop/side-quest-25-01-audit-reference.md

Problem

  1. The agent artifact file table lists:

| safeoutputs.jsonl | Every safe-output declaration the agent emitted |

The live reference/artifacts/ doc names this file agent_output.json, not safeoutputs.jsonl — that filename does not appear anywhere in the artifacts documentation.

  1. The same table lists:

| mcp-logs/ | One log file per MCP server, listing every tool call and result |

Searching the raw HTML of both reference/artifacts/ and reference/audit/ for "mcp-logs" and "mcp_logs" returns zero matches. The documented structure for MCP/network traffic is the firewall-audit-logs artifact (downloaded via --artifacts mcp, per the Artifact Sets table: "mcp → firewall-audit-logs → MCP gateway traffic logs") or sandbox/firewall/logs/api-proxy-logs/ within the unified agent artifact — not a per-MCP-server mcp-logs/ directory.

  1. The file repeatedly uses a "⌖ AIC" / "Threat-detection AIC" metric:

**Threat-detection AIC (⌖ AIC)** — credits consumed by the firewall's threat-detection model, reported separately from agent inference
| ⌖ AIC | 3 | (in the sample audit report)
The **⌖ AIC** column in gh aw logs output shows credits consumed by the threat-detection model

Exhaustive searches of reference/audit/, reference/cost-management/, and the full gh aw CLI help snapshot found zero matches for "⌖" or "Threat-detection AIC". The actual documented term is "classifier AIC", part of the Model Routing summary for routed runs — a distinct concept from firewall threat detection.

Current correct behaviour

  • Safe-output data file: agent_output.json (per reference/artifacts/ → "agent" artifact section)
  • MCP/network traffic logs: firewall-audit-logs artifact or sandbox/firewall/logs/api-proxy-logs/ (per Artifact Sets table)
  • AIC routing terminology: "classifier AIC" (per reference/cost-management/ and reference/audit/), not "⌖ AIC" / "Threat-detection AIC"

The --parse flag, log.md/firewall.md output filenames, network.allowed frontmatter syntax, and the gh aw audit <run-id> --parse / gh aw logs <workflow-id> --artifacts all command forms in this file are all accurate and need no changes.

Suggested fix

  • Replace safeoutputs.jsonl with agent_output.json in the artifact file table.
  • Replace the mcp-logs/ row and the "Explore MCP tool calls" exercise with the documented sandbox/firewall/logs/api-proxy-logs/ path or firewall-audit-logs artifact (--artifacts mcp), and update the .github/aw/logs/<run-id>/mcp-logs/ path reference accordingly.
  • Replace "Threat-detection AIC (⌖ AIC)" and all "⌖ AIC" mentions (including in the sample report table and checkpoint) with the documented "classifier AIC" terminology, correcting the description to match its Model Routing context (routed runs only), or remove the bullet if no direct equivalent exists.

References: https://github.github.com/gh-aw/reference/artifacts/, https://github.github.com/gh-aw/reference/audit/, https://github.github.com/gh-aw/reference/cost-management/ (all confirmed reachable, HTTP 200)

Generated by 🔍 Workshop Sync Check · copilot · auto · 239.5 AIC · ⌖ 8.28 AIC · ⊞ 9.2K · ◷

  • expires on Oct 12, 2026, 5:49 AM UTC
Ngôn ngữ chính
JavaScript
Star
53
Fork
35
Merge trung bình
13 giờ 50 phút
Pull request đã merge (30 ngày)
14

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

  • Không có Dockerfile hay tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của githubnext/gh-aw-workshop

Tất cả issue của githubnext/gh-aw-workshop

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.