Skip to content

v0.2.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 30 Dec 23:13
· 1301 commits to main since this release
v0.2.0
16f26b7
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Highlights

  • Session Report Command: New agentsh report CLI command for generating markdown reports summarizing session activity for human operators and CI/CD pipelines.
  • Automatic Findings Detection: Reports automatically detect and highlight policy violations, anomalies, sensitive path access, and notable operations.
  • CI/CD Integration: Documentation and examples for integrating session reports into GitHub Actions and GitLab CI pipelines.

What's New

Session Report Command

Generate comprehensive reports of agent session activity:

# Quick summary of latest session (~1 page)
agentsh report latest --level=summary

# Detailed investigation report
agentsh report <session-id> --level=detailed --output=report.md

# Offline mode (query local database directly)
agentsh report latest --level=summary --direct-db

Report Levels

Level Content
Summary Decision counts, key findings, top activity by category
Detailed Full event timeline, blocked operations table, command history, all file paths, all network hosts

Automatic Findings Detection

Reports automatically detect and highlight:

Finding Severity Description
Blocked operations Critical Operations denied by policy
Denied approvals Critical Requests rejected by operator
Sensitive path access Warning Access to credentials, SSH keys, .env files
Direct IP connections Warning Network connections to IPs instead of domains
Unusual port connections Warning Connections to non-standard ports (not 80/443)
High host diversity Warning More than 10 unique network destinations
Soft-deleted files Warning Files moved to trash (recoverable)
Redirected operations Info Commands/paths substituted by policy
Granted approvals Info Operations approved by operator
Failed commands Info Commands with non-zero exit codes

New Files

Package Files
internal/report types.go, findings.go, generator.go, markdown.go
internal/cli report.go
internal/integration report_e2e_test.go
docs cicd-integration.md, updated spec.md and README.md

CI/CD Integration

New documentation with examples for:

  • GitHub Actions workflow with artifact upload and job summary
  • GitLab CI pipeline with report artifacts
  • Best practices for automated session auditing

Downloads

Platform Architecture Format
Linux amd64, arm64 tar.gz, deb, rpm, pkg.tar.zst
macOS amd64, arm64 tar.gz
Windows amd64, arm64 zip

Changelog

  • feat(report): add session report command (#41)
Assets 15
Loading