Document D&D extractor contract

internal/modules/dnd/extract/combatturns/extractor.go

@@ -14,7 +14,6 @@ import (
 
 const (
 	Key           = "dnd/combat-turns"
-	ArtifactType  = "dnd.combat_turn"
 	mappingPolicy = "dnd.combat_turns.extract_mapping.v2"
 )
 

internal/modules/dnd/extract/spells/extractor.go

@@ -14,7 +14,6 @@ import (
 )
 
 const Key = "dnd/spells"
-const ArtifactType = "dnd.spell_cast"
 const SchemaVersion = "v1"
 
 const mappingPolicy = "dnd.spells.extract_mapping.v2"
@@ -122,6 +121,9 @@ func (e *Extractor) ReferenceSlots() []contracts.ReferenceSlot {
 }
 
 func (e *Extractor) ManifestMetadata() map[string]any {
+	if e == nil {
+		return nil
+	}
 	metadata := map[string]any{
 		"prompt_id":               PromptID,
 		"prompt_version":          SchemaVersion,

internal/modules/dnd/extract/spells/extractor_test.go

@@ -174,6 +174,13 @@ func TestExtractorManifestMetadataIncludesLLMSchemaProvenance(t *testing.T) {
 	}
 }
 
+func TestNilExtractorManifestMetadata(t *testing.T) {
+	var extractor *Extractor
+	if metadata := extractor.ManifestMetadata(); metadata != nil {
+		t.Fatalf("nil extractor metadata = %#v, want nil", metadata)
+	}
+}
+
 func TestExtractPassesReferencesAsPromptInputs(t *testing.T) {
 	client := &fakeSpellsLLMClient{response: extractionResponse{SpellCasts: []spellCastResponse{}}}
 	req := extractionRequest()