builtins

Documentation

Overview

Package builtins ships byre's built-in skills embedded in the binary and materializes them into ~/.byre/skills/ so they are loadable (and inspectable and editable) like any hand-dropped skill.

Index

• func MaterializeSkills(destDir string) error
• func MaterializeTemplates(destDir string) error
• type Change
  • func UpdateSkills(destDir string) ([]Change, error)
  • func UpdateTemplates(destDir string) ([]Change, error)

Functions

func MaterializeSkills

func MaterializeSkills(destDir string) error

MaterializeSkills writes the built-in skills into destDir (~/.byre/skills).

func MaterializeTemplates

func MaterializeTemplates(destDir string) error

MaterializeTemplates writes the built-in templates into destDir (~/.byre/templates).

Types

type Change

type Change struct {
	Name   string
	Backup string
}

Change records one skill or template changed by an update: its name and where its prior copy is kept (Backup is the backup slot, or a leftover stash path if the backup couldn't be published; "" only when newly installed).

func UpdateSkills

func UpdateSkills(destDir string) ([]Change, error)

UpdateSkills re-materializes the built-in skills into destDir, OVERWRITING existing copies with the shipped version (unlike Materialize, which never clobbers). A replaced copy that differs is preserved in an append-only backup under the sibling skills.bak/ dir. Returns the changes (installed or updated), sorted by name. Hand-dropped (non-built-in) skills are not touched.

func UpdateTemplates

func UpdateTemplates(destDir string) ([]Change, error)

UpdateTemplates is UpdateSkills for the built-in templates (backups land in templates.bak/) — so shipped template changes have the same pickup path as shipped skill changes.