feat(core): add ValidateFiles method for bulk file validation

[jmgilman]

Summary

• Add ValidateFiles(paths ...string) ([]string, error) method to Blob for bulk file validation
• Add ValidationError type with Path and Reason fields for detailed error reporting
• Re-export ValidationError from top-level package

This enables fail-fast validation for commands like cat that need to verify all files exist before starting output.

Key features

• Normalizes paths internally (accepts /file.txt, file.txt/, etc.)
• Returns normalized paths suitable for use with Open, ReadFile, etc.
• Reports specific error reasons: "not found", "is a directory", "not a regular file", "invalid path"
• Preserves original path in error messages for user-friendly output

Example usage

normalized, err := archive.ValidateFiles("/etc/hosts", "config.json")
if err != nil {
    var valErr *blob.ValidationError
    if errors.As(err, &valErr) {
        fmt.Printf("%s: %s\n", valErr.Reason, valErr.Path)
    }
    return err
}

// Use normalized paths with Open/ReadFile
for _, path := range normalized {
    content, _ := archive.ReadFile(path)
    // ...
}

Test plan

• Unit tests for all validation scenarios (valid files, not found, directories, invalid paths)
• Test that returned normalized paths work with Open
• just ci passes

🤖 Generated with Claude Code

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	blob	ab2dc71	Commit Preview URL Branch Preview URL	Jan 23 2026, 06:13 AM