/aget-check-sessions

Monitor the health of the sessions/ directory by checking file organization, naming conventions, and disk usage.

Purpose

Provide self-diagnostic capability for AGET agents to assess their sessions directory health. Detects organizational anomalies like date-based subdirectories which indicate non-standard structure.

Execution

When invoked, perform these checks:

1. Structure Check

# Check for date subdirectories (anomaly indicator)
find sessions -type d -name "20[0-9][0-9]-*" 2>/dev/null | wc -l

# Check for checkpoints subdirectory (expected)
test -d sessions/checkpoints && echo "yes" || echo "no"

2. File Inventory

# Count session files (excluding checkpoints)
find sessions -maxdepth 1 -type f -name "*.md" | wc -l

# Count checkpoint files
find sessions/checkpoints -type f -name "*.yaml" 2>/dev/null | wc -l

3. Naming Convention Check

Valid session pattern: session_YYYY-MM-DD_*.md

# Count valid session names
find sessions -maxdepth 1 -type f -name "session_20[0-9][0-9]-[0-9][0-9]-[0-9][0-9]_*.md" | wc -l

# Find non-conforming files
find sessions -maxdepth 1 -type f -name "*.md" ! -name "session_20[0-9][0-9]-[0-9][0-9]-[0-9][0-9]_*.md"

4. Disk Usage

du -sh sessions

Thresholds

Metric	OK	WARN	CRITICAL
Total files	<200	200-500	>500
Date subdirectories	0	1+ (anomaly)	-
Disk size	<50MB	50-100MB	>100MB

Note: Thresholds inherited from supervisor defaults. Research AGET baseline (2026-02-08): 77 files, 544K.

Output Format

=== /aget-check-sessions ===

Directory: sessions/

Structure:
  Date subdirectories: [count] (0 = OK, >0 = anomaly)
  Checkpoints dir:     [yes/no]

File Counts:
  Session files: [count]
  Checkpoints:   [count]
  Non-conforming: [count]

Disk Usage: [size]

Non-Conforming Files:
  [list any files not matching expected patterns]

Health Status: [OK | WARN | CRITICAL]
Alerts:
  [list any threshold violations or anomalies]

Health Status Logic

IF total_files > 500 OR disk > 100MB:
  CRITICAL
ELIF total_files > 200 OR disk > 50MB OR date_subdirs > 0:
  WARN
ELSE:
  OK

Constraints

• C1: Read-only operation. Never modify files.
• C2: Date subdirectories are anomaly indicators, not errors.
• C3: Checkpoints subdirectory is expected and excluded from anomaly detection.

Related Skills

• /aget-check-evolution - Evolution directory health
• /aget-check-kb - Knowledge base health
• /aget-save-state - Create checkpoints

Traceability

Link	Reference
POC	POC-017
Project	prior internal authoring plan
Source	Fleet Skill Deployment Report (supervisor)
Baseline	77 files, 544K (2026-02-08)

---

aget-check-sessions v1.0.0 Category: Monitoring POC-017 Phase 1