This section contains internal documentation for two audiences:

  • Core contributors working on the daemon, CLI, trigger engine, or infrastructure packages.
  • Plugin authors building new trigger or action plugins that run as external binaries.

Sub-pages

  • Architecture Deep Dive – package structure, request flows, and key interfaces inside the daemon.
  • Writing a Plugin – step-by-step tutorial for creating a new trigger or action plugin.
  • Testing Guide – unit test patterns, mock strategies, and coverage enforcement.
  • Debugging – practical tips for diagnosing daemon, plugin, and recurfile issues.
  • Release Process – how tag-based releases are built and published via GitHub Actions.

Prerequisites

This guide assumes you have already read CONTRIBUTING.md, have a working Go toolchain, and can run:

  task build && task test

For build setup details, see the Contributing section. For formal API and manifest specs, see the Reference section.