Skip to content

feat: specsmith watch — live governance daemon #16

@tbitcs

Description

@tbitcs

Problem

Governance drift happens gradually — code changes without ledger updates, new files without REQ coverage, CI modifications without tool registry alignment. Currently you have to manually run \specsmith audit\ to catch drift.

Proposed Solution

\specsmith watch --project-dir .\ runs a background daemon that:

  1. Watches for file changes via filesystem events
  2. Auto-validates governance consistency in real-time
  3. Alerts when LEDGER.md hasn't been updated after code changes
  4. Alerts when REQ↔TEST coverage drops below threshold
  5. Alerts when CI config diverges from tool registry
  6. Provides pre-commit hook integration (beyond just lint)
  7. WebSocket feed for the React dashboard
  8. Desktop notifications (optional)

Use Cases

  • Developer makes code changes → daemon alerts 'LEDGER.md not updated'
  • Someone edits CI manually → daemon alerts 'CI no longer matches tool registry'
  • New test file added → daemon suggests 'add Covers: REQ-xxx reference'

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions