stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
22390057fca89776bf376bf972e67dbe1365bdbd
git.stella-ops.org/src/__Libraries/StellaOps.Plugin/AGENTS.md
StellaOps Bot 22390057fc stop syncing with TASKS.md
2025-12-26 11:44:40 +02:00

1.6 KiB
Raw Blame History

Plugin Platform Guild Charter

Mission

Maintain the shared plugin infrastructure used across StellaOps services (Scanner analyzers, Notifier channels, Surface extensions). The library must provide deterministic discovery, dependency injection helpers, and security safeguards for restart-time plug-ins.

Scope

  • Core abstractions and DI helpers under StellaOps.Plugin.
  • Plugin manifest format, loading order, capability flags, and validation.
  • Sample host integrations and test harnesses verifying plugin lifecycle.
  • Documentation guiding guilds on authoring and packaging plug-ins.

Required Reading

  • docs/modules/platform/architecture-overview.md
  • docs/dev/plugins/README.md
  • docs/modules/scanner/architecture.md
  • docs/modules/notify/architecture.md
  • docs/modules/excititor/architecture.md

Working Agreement

  1. Status sync: update task state to DOING/DONE in corresponding sprint file docs/implplan/SPRINT_*.md whenever work begins/ends.
  2. Deterministic loading: maintain ordered, reproducible plugin discovery; enforce hash verification/whitelists as documented.
  3. Security: validate manifests, restrict assembly loading paths, and expose capability checks to hosts; document hardening guidance.
  4. Compatibility: version public APIs carefully; provide migration guides when breaking changes occur.
  5. Testing: cover unit/integration scenarios (manifest parsing, dependency injection, failure paths); ensure cross-platform compatibility.
  6. Documentation: keep plugin developer guides current; update sample manifests when configuration changes; coordinate with host guilds for rollout plans.