broadcast: fix issues with filepaths and hash characters

* Fix traceback when using `cylc broadcast -F` with a relative filepath
* Fix `#` char bug in `cylc broadcast`

add example workflows

* Partially addresses cylc/cylc-doc#627
* Add some examples of Cylc workflow implementation patterns.

---------

Co-authored-by: Hilary James Oliver <[email protected]>
Co-authored-by: Ronnie Dutta <[email protected]>

* Closes cylc#5939
* Support offsets (measured from the ICP) for the `stop after cycle point`
  to mirror the behaviour of the `final cycle point`.
* Add integration test to lock-down `stop after cycle point`
  interactions.

Merge 8.2.x-sync into master

doc: correct spelling

…examples for each of the built in xtriggers.

- Xrandom validate function
- Init test xrandom validate function
- Add unit tests for validation of built in xtriggers

Co-authored-by: Ronnie Dutta <[email protected]>

Bumps [codecov/codecov-action](https://github.com/codecov/codecov-action) from 3 to 4.
- [Release notes](https://github.com/codecov/codecov-action/releases)
- [Changelog](https://github.com/codecov/codecov-action/blob/main/CHANGELOG.md)
- [Commits](codecov/codecov-action@v3...v4)

---
updated-dependencies:
- dependency-name: codecov/codecov-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <[email protected]>

…f `tool.cylc.lint`

Co-authored-by: Ronnie Dutta <[email protected]>

Co-authored-by: Ronnie Dutta <[email protected]>

* Remove redundant try block.

* Fix changelog

* Automatically validate xtrigger function signature

---------

Co-authored-by: Hilary James Oliver <[email protected]>

Co-authored-by: Ronnie Dutta <[email protected]>

Don't record satisfied xtriggers in the DB

* Closes cylc#5911
* Test that no wall_clock xtriggers are saved to the DB for a retry.

---------

Co-authored-by: Ronnie Dutta <[email protected]>
Co-authored-by: Oliver Sanders <[email protected]>

…cov/codecov-action-4

build(deps): bump codecov/codecov-action from 3 to 4

added suite state xtrigger for back commpat
extended back compat a unit test
added deprecation log message
Replace icky unit test with functional test (#4)

---------

Co-authored-by: Mark Dawson <[email protected]>

🤖 Merge 8.2.x-sync into master

Co-authored-by: Mark Dawson <[email protected]>

cylc lint: deprecate `[cylc-lint]` in favour of `[tool.cylc.lint]` in `pyproject.toml`

stop after cycle point: support offsets

🤖 Merge 8.2.x-sync into master

* Improve xtrigger validation

* wall_clock: use placeholder function for signature validation & autodocs

* Fix docstring for autodoc [skip ci]