I'll inspect the referenced packages to understand the behavior accurately before writing the documentation.I have enough context. The serve command currently returns ErrNotImplemented. Let me write the documentation.

title: phpbotscout serve description: Runs the phpbotscout daemon as a long-running background process. date: 2026-07-28 tags: [cli, command, serve, daemon] authors: [Claude (claude-opus-4-8)]

phpbotscout serve¶

The serve command starts the phpbotscout daemon, a long-running background process intended to handle continuous, event-driven, or scheduled workloads.

Not Yet Implemented

This command is currently a placeholder. Invoking it will return a "command not yet implemented" error and exit without starting a daemon. The documentation below describes the intended behaviour and interface.

Usage¶

$ phpbotscout serve [flags]

Description¶

The serve command runs the phpbotscout daemon. It is designed to be a persistent, long-lived process rather than a one-shot command — the sort of process you would typically manage under a service supervisor such as systemd, supervisord, or a container runtime.

When invoked, the command performs the following:

Sets up the error handler's usage printer so that any usage-related errors can render the command's help text.
Delegates to the internal RunServe routine, passing along the shared application properties (logger, configuration, filesystem, and error handler), the command options, and any positional arguments.

At present, RunServe returns the framework's ErrNotImplemented sentinel error. This means the daemon does not yet start any workloads.

Shared Application Properties

Like all phpbotscout commands, serve receives a shared Props container that provides access to the configured logger, configuration reader, filesystem abstraction, and error handling pipeline. This ensures consistent behaviour and diagnostics across every command in the tool.

Debug Diagnostics

The phpbotscout error handler emits full stack traces and detailed error information only when the logger has debug output enabled. If you need richer diagnostics while this command is under development, enable debug-level logging.

Flags¶

The serve command does not define any of its own flags. It inherits only the global (persistent) flags provided by the phpbotscout root command.

Name	Description	Default	Required
`-h`, `--help`	Displays help information for the `serve` command.	`false`	No

Global Flags

Any persistent flags defined on the root phpbotscout command (for example, logging or configuration flags) are also available here. Run phpbotscout serve --help to see the complete, up-to-date list for your installed version.

Examples¶

Start the daemon:

$ phpbotscout serve

Display help for the command:

$ phpbotscout serve --help

Current Behaviour

Because the command is not yet implemented, the examples above will currently terminate with a "command not yet implemented" error rather than launching a running daemon.