automod: more doc comments

automod/cachestore/doc.go

···
-// Automod component for caching arbitary data (as JSON strings) with a fixed TTL and purging.
+// Automod component for caching arbitrary data (as JSON strings) with a fixed TTL and purging.
 //
 // Includes an interface and implementations using redis and in-process memory.
 //

automod/countstore/doc.go

···
-// Interface for fast atomic counters, and separate implmentations using redis and in-process memory.
+// Interface for fast atomic counters, and separate implementations using redis and in-process memory.
 package countstore

automod/engine/fetchaccountmeta.go

···
 	"github.com/bluesky-social/indigo/atproto/syntax"
 )
 
+// Helper to hydrate metadata about an account from several sources: PDS (if access), mod service (if access), public identity resolution
 func (e *Engine) GetAccountMeta(ctx context.Context, ident *identity.Identity) (*AccountMeta, error) {
 
 	// wipe parsed public key; it's a waste of space and can't serialize

automod/engine/ruleset.go

···
 	lexutil "github.com/bluesky-social/indigo/lex/util"
 )
 
+// Holds configuration of which rules of various types should be run, and helps dispatch events to those rules.
 type RuleSet struct {
 	PostRules         []PostRuleFunc
 	ProfileRules      []ProfileRuleFunc
···
 	BlobRules         []BlobRuleFunc
 }
 
+// Executes all the various record-related rules. Only dispatches execution, does no other de-dupe or pre/post processing.
 func (r *RuleSet) CallRecordRules(c *RecordContext) error {
 	// first the generic rules
 	for _, f := range r.RecordRules {
···
 	return nil
 }
 
+// NOTE: this will probably be removed and merged in to `CallRecordRules`
 func (r *RuleSet) CallRecordDeleteRules(c *RecordContext) error {
 	for _, f := range r.RecordDeleteRules {
 		err := f(c)
···
 	return nil
 }
 
+// Executes rules for identity update events.
 func (r *RuleSet) CallIdentityRules(c *AccountContext) error {
 	for _, f := range r.IdentityRules {
 		err := f(c)