Implement artifact-level render command with Markdown output and update docs

internal/trim/artifact.go

@@ -1,16 +1,16 @@
 package trim
 
 import (
-	"encoding/json"
 	"fmt"
 
+	artifactpkg "gitea.maximumdirect.net/eric/seriatim/internal/artifact"
 	"gitea.maximumdirect.net/eric/seriatim/schema"
 )
 
 const (
-	SchemaMinimal      = schema.OutputSchemaMinimal
-	SchemaIntermediate = schema.OutputSchemaIntermediate
-	SchemaFull         = schema.OutputSchemaFull
+	SchemaMinimal      = artifactpkg.OutputSchemaMinimal
+	SchemaIntermediate = artifactpkg.OutputSchemaIntermediate
+	SchemaFull         = artifactpkg.OutputSchemaFull
 )
 
 // Artifact stores a parsed seriatim output artifact of one supported schema.
@@ -31,42 +31,16 @@ type ApplyArtifactResult struct {
 
 // ParseArtifactJSON parses and validates a serialized seriatim output artifact.
 func ParseArtifactJSON(data []byte) (Artifact, error) {
-	var decoded any
-	if err := json.Unmarshal(data, &decoded); err != nil {
-		return Artifact{}, fmt.Errorf("input JSON is malformed: %w", err)
+	parsed, err := artifactpkg.ParseOutputArtifactJSON(data)
+	if err != nil {
+		return Artifact{}, err
 	}
-
-	var full schema.Transcript
-	if err := json.Unmarshal(data, &full); err == nil {
-		if err := schema.ValidateTranscript(full); err == nil {
-			return Artifact{
-				Schema: SchemaFull,
-				Full:   &full,
-			}, nil
-		}
-	}
-
-	var intermediate schema.IntermediateTranscript
-	if err := json.Unmarshal(data, &intermediate); err == nil {
-		if err := schema.ValidateIntermediateTranscript(intermediate); err == nil {
-			return Artifact{
-				Schema:       SchemaIntermediate,
-				Intermediate: &intermediate,
-			}, nil
-		}
-	}
-
-	var minimal schema.MinimalTranscript
-	if err := json.Unmarshal(data, &minimal); err == nil {
-		if err := schema.ValidateMinimalTranscript(minimal); err == nil {
-			return Artifact{
-				Schema:  SchemaMinimal,
-				Minimal: &minimal,
-			}, nil
-		}
-	}
-
-	return Artifact{}, fmt.Errorf("input JSON is not a valid seriatim output artifact")
+	return Artifact{
+		Schema:       parsed.Schema,
+		Full:         parsed.Full,
+		Intermediate: parsed.Intermediate,
+		Minimal:      parsed.Minimal,
+	}, nil
 }
 
 // ValidateArtifact validates an artifact against its declared schema.