Package io.agentscope.harness.agent.skill.curator

Class SkillAuditLog

java.lang.Object

io.agentscope.harness.agent.skill.curator.SkillAuditLog

public class SkillAuditLog
extends Object

Append-only audit log for the skill self-learning loop. Every skill_manage write, promotion decision, and curator transition lands as one JSON line in workspace/skills/.audit/YYYY-MM-DD.jsonl.

This is intentionally separate from OTel / trace spans (which other code paths emit concurrently). The on-disk JSONL is the recovery / forensic copy: it survives OTel collector outages and gives operators a queryable record without standing up a metrics stack. agent.queryAudit(predicate) reads back every entry from the latest day file.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	SkillAuditLog.Entry	A single audit row.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	AUDIT_DIR

Constructor Summary

Constructors

Constructor	Description
SkillAuditLog(AbstractFilesystem filesystem, WorkspaceManager workspaceManager)

Method Summary

Modifier and Type	Method	Description
void	append(SkillAuditLog.Entry entry)	Append a new entry.
static SkillAuditLog.Entry	curatorEntry(SkillCurator.CuratorRunReport report, String mode)	Convenience builder for curator.run.
static SkillAuditLog.Entry	manageEntry(String actor, String name, String action, String draftOrMain, String verdict)	Convenience builder for the common skill_manage entry shape.
static SkillAuditLog.Entry	promoteEntry(String reviewer, String name, String decision, String scanVerdict, List<String> environments)	Convenience builder for the promote audit entry.
List<SkillAuditLog.Entry>	query(String dayUtc, Predicate<SkillAuditLog.Entry> filter)	Read the audit log for a given day, parse every line into SkillAuditLog.Entry, then filter via the predicate.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

AUDIT_DIR

public static final String AUDIT_DIR

See Also:

• Constant Field Values

Constructor Details

SkillAuditLog

public SkillAuditLog(AbstractFilesystem filesystem,
 WorkspaceManager workspaceManager)

Method Details

append

public void append(SkillAuditLog.Entry entry)

Append a new entry. Best-effort: failures are logged but never thrown.

query

public List<SkillAuditLog.Entry> query(String dayUtc,
 Predicate<SkillAuditLog.Entry> filter)

Read the audit log for a given day, parse every line into SkillAuditLog.Entry, then filter via the predicate. Pass null for dayUtc to query "today".

manageEntry

public static SkillAuditLog.Entry manageEntry(String actor,
 String name,
 String action,
 String draftOrMain,
 String verdict)

Convenience builder for the common skill_manage entry shape.

promoteEntry

public static SkillAuditLog.Entry promoteEntry(String reviewer,
 String name,
 String decision,
 String scanVerdict,
 List<String> environments)

Convenience builder for the promote audit entry.

curatorEntry

public static SkillAuditLog.Entry curatorEntry(SkillCurator.CuratorRunReport report,
 String mode)

Convenience builder for curator.run.