From 16bb12face431310dee2f452cbe013e2ea21bc31 Mon Sep 17 00:00:00 2001
From: Eric Rakestraw <eric@rakestraw.us>
Date: Sun, 24 May 2026 15:08:03 +0000
Subject: [PATCH] Complete cleanup sweep and align internal artifact docs

---
 docs/internal/artifacts.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/internal/artifacts.md b/docs/internal/artifacts.md
index 421b7a8..f18df28 100644
--- a/docs/internal/artifacts.md
+++ b/docs/internal/artifacts.md
@@ -76,6 +76,12 @@ Trim invariants:
 - retained order follows input transcript order.
 - output IDs are reassigned to `1..N`.
 
+Run layer (`run.go`):
+
+- executes end-to-end trim orchestration from validated config
+- writes output JSON
+- optionally writes report JSON with `trim-audit`
+
 ## Normalize internals
 
 `internal/normalize` canonicalizes transcript-like JSON input into a selected