Operation

The class IS the operation — its identity, declared where a human writes it and an agent reads it. This is the intent half of greenhouse decisions/0212: «what changes authority is DECLARED; what a type already says is DERIVED». Everything this attribute carries is intent — a name a human types, a sentence that explains the purpose, the surfaces it is allowed to appear on. Nothing here can be inferred from a signature, which is exactly why it is written down. The mechanics — the input schema, the admissible values of an enum, the output shape — are NOT here: they are read off the constructor and the return type by {@see DeclaredOperation}. ```php #[Operation(name: 'hola:greet', description: 'Write a greeting into var/greetings.txt')] #[Mutates(Mutation::Persistent, Externality::None, Reversibility::Guaranteed, subject: Subject::Data)] final class Greet { public function __construct(#[Target] #[Because('who to greet')] public readonly string $name) {} public function run(Greetings $greetings): array { return $greetings->write($this->name); } } ```

public function __construct(string $name, string $description, ?string $version = null, ?string $path = null, ?array $surfaces = null):

Parameters