mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
The shared AGENTS.md workflow is dashboard-only, so users had no written reference for how shared files attach, what restore puts back, or where drift backups go. Adds a how-to page in every locale, documents single-file extras and the target `instructions` key, and brings the translated extras collect section up to date with English.
127 lines
3.8 KiB
Go
127 lines
3.8 KiB
Go
package config
|
|
|
|
import (
|
|
"fmt"
|
|
"regexp"
|
|
"slices"
|
|
"strings"
|
|
)
|
|
|
|
var extraNameRegex = regexp.MustCompile(`^[a-zA-Z0-9][a-zA-Z0-9_-]*$`)
|
|
|
|
var reservedExtraNames = map[string]bool{
|
|
"skills": true,
|
|
"extras": true,
|
|
}
|
|
|
|
// ValidateExtraName checks that a name is safe for use as an extras directory.
|
|
// It rejects empty names, reserved words, and names that don't match the
|
|
// allowed character set (alphanumeric, hyphens, underscores; must start with
|
|
// alphanumeric).
|
|
func ValidateExtraName(name string) error {
|
|
if name == "" {
|
|
return fmt.Errorf("extra name cannot be empty")
|
|
}
|
|
if reservedExtraNames[name] {
|
|
return fmt.Errorf("extra name %q is reserved", name)
|
|
}
|
|
if !extraNameRegex.MatchString(name) {
|
|
return fmt.Errorf("extra name %q is invalid: must start with a letter or digit and contain only letters, digits, hyphens, or underscores", name)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// ExtraSyncModes is the authoritative list of valid extras sync modes. It is
|
|
// its own list (not ValidSyncModes) because "import" is valid only for
|
|
// single-file extras and must never be accepted for skills.
|
|
var ExtraSyncModes = []string{"merge", "symlink", "copy", "import"}
|
|
|
|
// ValidateExtraMode checks that mode is a valid sync mode.
|
|
// Empty string is allowed (defaults to "merge" at runtime).
|
|
func ValidateExtraMode(mode string) error {
|
|
if mode == "" {
|
|
return nil
|
|
}
|
|
if !slices.Contains(ExtraSyncModes, mode) {
|
|
return fmt.Errorf("invalid mode %q: must be merge, copy, symlink, or import", mode)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// ValidateExtraFlatten checks that flatten is not used with symlink mode.
|
|
func ValidateExtraFlatten(flatten bool, mode string) error {
|
|
if flatten && mode == "symlink" {
|
|
return fmt.Errorf("flatten cannot be used with symlink mode (symlink links the entire directory)")
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// ValidateExtraNameUnique checks that the name doesn't duplicate an existing
|
|
// extra. Names differing only in case count as duplicates: the name is a
|
|
// directory name, and macOS and Windows file systems ignore case.
|
|
func ValidateExtraNameUnique(name string, existing []ExtraConfig) error {
|
|
for _, e := range existing {
|
|
if e.Name == name {
|
|
return fmt.Errorf("extra name %q already exists", name)
|
|
}
|
|
if strings.EqualFold(e.Name, name) {
|
|
return fmt.Errorf("extra name %q is too close to %q: names cannot differ only in case", name, e.Name)
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// ValidateExtraConfig checks an extra's single-file settings and target modes.
|
|
// file and as must be plain filenames; as, import mode, and the absence of
|
|
// flatten are tied to file; an extension cannot transform a single file.
|
|
func ValidateExtraConfig(extra ExtraConfig) error {
|
|
if extra.File != "" {
|
|
if err := validateExtraFilename("file", extra.File); err != nil {
|
|
return fmt.Errorf("extra %q: %w", extra.Name, err)
|
|
}
|
|
}
|
|
for _, t := range extra.Targets {
|
|
if err := validateExtraTarget(extra.File, t); err != nil {
|
|
return fmt.Errorf("extra %q target %s: %w", extra.Name, t.Path, err)
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func validateExtraTarget(file string, t ExtraTargetConfig) error {
|
|
if err := ValidateExtraMode(t.Mode); err != nil {
|
|
return err
|
|
}
|
|
if err := ValidateExtraFlatten(t.Flatten, t.Mode); err != nil {
|
|
return err
|
|
}
|
|
if file == "" {
|
|
if t.As != "" {
|
|
return fmt.Errorf("as requires file")
|
|
}
|
|
if t.Mode == "import" {
|
|
return fmt.Errorf("import mode requires file")
|
|
}
|
|
return nil
|
|
}
|
|
if t.As != "" {
|
|
if err := validateExtraFilename("as", t.As); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
if t.Flatten {
|
|
return fmt.Errorf("flatten cannot be used with a single-file extra")
|
|
}
|
|
if t.Extension != "" {
|
|
return fmt.Errorf("extension cannot be used with a single-file extra")
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func validateExtraFilename(field, name string) error {
|
|
if name == "." || name == ".." || strings.ContainsAny(name, `/\`) {
|
|
return fmt.Errorf("%s %q must be a plain filename", field, name)
|
|
}
|
|
return nil
|
|
}
|