Documentation
¶
Overview ¶
Package audit records structured execution and error telemetry for PTC runs.
Index ¶
- func ClassifyError(phase, msg string, traces []sandbox.OpTrace) string
- func DiscoverLogDirs(explicitDataDir string) []string
- func FormatFullStreamCard(e Entry) string
- func FormatLogs(entries []Entry, usedFiles []string, tail int, runID string) string
- func FormatStats(entries []Entry) string
- func PayloadKeyLengths(payloads map[string]string) map[string]int
- type Entry
- type Logger
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func ClassifyError ¶
ClassifyError assigns an actionable optimization category to compile, runtime, or capability errors.
func DiscoverLogDirs ¶
DiscoverLogDirs returns candidate AgyPTC / MCPlex log directories ordered by priority. When explicitDataDir is non-empty, only that directory is inspected so tests and isolated runs never mix with global logs.
func FormatFullStreamCard ¶
FormatFullStreamCard renders a compact live monitor card showing input code, host ops, and return result for `agy-ptc logs -f`.
func FormatLogs ¶
FormatLogs renders recent entries or a full single-run diagnostic view (`runID != ""`).
func FormatStats ¶
FormatStats aggregates execution logs into an actionable optimization report (error categories & failing capabilities).
Types ¶
type Entry ¶
type Entry struct {
ID string `json:"id"`
Timestamp string `json:"timestamp"`
Cwd string `json:"cwd"`
Title string `json:"title"`
Status string `json:"status"` // "ok" | "partial_op_error" | "compile_error" | "runtime_error" | "timeout"
ErrorCategory string `json:"errorCategory,omitempty"`
ErrorMessage string `json:"errorMessage,omitempty"`
DurationMs int64 `json:"durationMs"`
HostOps int `json:"hostOps"`
FailedOps int `json:"failedOps"`
ResponseBytes int `json:"responseBytes"`
AutoSpilled bool `json:"autoSpilled,omitempty"`
PayloadKeys map[string]int `json:"payloadKeys,omitempty"` // key -> byte length (values omitted for secret safety)
Traces []sandbox.OpTrace `json:"traces,omitempty"`
Logs []string `json:"logs,omitempty"`
Warnings []string `json:"warnings,omitempty"`
Code string `json:"code,omitempty"`
ResultPreview string `json:"resultPreview,omitempty"`
}
Entry represents a single recorded `mcp_agy-ptc_vm_exec` run in `executions.jsonl` / `errors.jsonl`.