Method Create

internal/instructions/store.go:261–296

Create persists a new instruction and writes its managed file.

(ctx context.Context, name, desc, content string)

// Create persists a new instruction and writes its managed file.
func (s *Store) Create(ctx context.Context, name, desc, content string) (Instruction, error) {
	if err := validateName(name); err != nil {
		return Instruction{}, err
	}
	if err := s.Init(ctx); err != nil {
		return Instruction{}, err
	}
	db, err := s.open()
	if err != nil {
		return Instruction{}, err
	}
	defer db.Close()

	exists, err := nameExists(ctx, db, name, 0)
	if err != nil {
		return Instruction{}, fmt.Errorf("instructions: check name: %w", err)
	}
	if exists {
		return Instruction{}, fmt.Errorf("%w: %q", ErrDuplicateName, name)
	}

	if err := writeManagedFile(name, content); err != nil {
		return Instruction{}, err
	}

	now := time.Now().UTC().Format(rfc)
	res, err := db.ExecContext(ctx, `INSERT INTO instructions(name, description, content, created_at, updated_at) VALUES(?, ?, ?, ?, ?)`, name, desc, content, now, now)
	if err != nil {
		if strings.Contains(err.Error(), "UNIQUE") {
			return Instruction{}, fmt.Errorf("%w: %q", ErrDuplicateName, name)
		}
		return Instruction{}, fmt.Errorf("instructions: insert: %w", err)
	}
	id, _ := res.LastInsertId()
	return s.Get(ctx, id)
}

// Update changes an instruction's name/description/content, keeps the managed
// file in sync, and re-targets symlink installs when the safe-name changes.