Skip to content

STANDING: Implement standard healer diagnostic hooks in entity template #9

@koad

Description

@koad

Standing Healing Maintenance

Healer: Salus

Currently, entities have only the executed-without-arguments hook. For Salus to efficiently diagnose health issues, entities need standard diagnostic hooks that expose:

  1. gap — File a structural gap (missing file, misconfigured setting, spec violation)
  2. reconcile — Compare entity state against specs; suggest fixes
  3. health — Run self-diagnostics; report findings to Salus

These hooks should be optional but recommended. Salus can then:

  • Invoke entity gap during daily heal to detect new gaps
  • Call entity reconcile to identify spec violations
  • Check entity health status before/after healing

Reference:

  • VESTA-SPEC-009-DAEMON, Section 2.3 (buttons array shows hook pattern)
  • VESTA-SPEC-008 (hooks catalog) — add these to catalog

Standing Work:
When gestation creates a new entity, include these hooks in the template. For existing 12 entities, flag any that don't have them.

Design Note:
Hooks should output structured data (JSON or YAML) so Salus can parse findings automatically. Don't require them to be interactive.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions