Health Pulse

Health Pulse Skill

Canonical source of truth for the Health Pulse feature. The extension reads these rules; the brain defines them.

Data Model

type HealthStatus = 'healthy' | 'attention' | 'critical';

interface HealthPulse {
  status: HealthStatus;

  // Connections
  connectionCount: number;
  connectionHealth: number; // percentage 0-100

  // Rituals
  lastDreamDate: Date | null;
  dreamNeeded: boolean;
  lastMeditationDate: Date | null;
  meditationCount: number;

  // Architecture
  trifectaCompleteness: number; // percentage 0-100
  architectureVersion: string;
  extensionVersion: string;
  syncStale: boolean;

  // Chat memory
  chatMemoryLines: number;
  chatMemoryWarning: boolean;
}

B1: Health Status Rules

Three states, evaluated in priority order. First matching rule wins.

Critical

Attention

Healthy

All other cases. No conditions matched above.

Status Computation

function computeHealthStatus(pulse: HealthPulse): HealthStatus {
  const daysSinceDream = pulse.lastDreamDate
    ? daysBetween(pulse.lastDreamDate, now())
    : Infinity;
  const daysSinceMeditation = pulse.lastMeditationDate
    ? daysBetween(pulse.lastMeditationDate, now())
    : Infinity;

  // Critical rules
  if (pulse.connectionHealth < 90) return 'critical';
  if (pulse.syncStale && daysSinceDream > 3) return 'critical';
  if (pulse.dreamNeeded && daysSinceDream > 14) return 'critical';

  // Attention rules
  if (pulse.dreamNeeded) return 'attention';
  if (daysSinceDream > 7) return 'attention';
  if (pulse.chatMemoryWarning) return 'attention';
  if (pulse.syncStale) return 'attention';
  if (daysSinceMeditation > 7) return 'attention';
  if (pulse.trifectaCompleteness < 80) return 'attention';

  return 'healthy';
}

B2: Meditation History Parsing

Meditation history is tracked through file artifacts, not a dedicated log.

Sources

Metrics

Heuristic

Since meditation doesn't write to a central log, detect it by:

1. Check git log for commits with meditation keywords in the message
2. Check modification dates on /memories/repo/ files
3. Check .github/quality/ for recent reports
4. Fall back to workspace state stored by the extension

B3: Dream State Markers

Dream produces diagnostic artifacts. These markers tell the extension when dream last ran and what it found.

Primary Marker

File: .github/quality/dream-report.json

{
  "timestamp": "2026-04-16T03:00:00Z",
  "skills": 173,
  "instructions": 133,
  "prompts": 81,
  "agents": 17,
  "trifectaIssues": 12,
  "brokenRefs": 3,
  "status": "ATTENTION_REQUIRED"
}

Derived Flags

No Report Found

If .github/quality/dream-report.json doesn't exist:

• dreamNeeded = true
• lastDreamDate = null
• daysSinceLastDream = Infinity
• Nudge: "Run /dream to establish a health baseline"

B4: Connection Health Scoring

Connection health measures the integrity of applyTo patterns and file references across the architecture.

Algorithm

function computeConnectionHealth(dreamReport: DreamReport): number {
  const total = dreamReport.skills + dreamReport.instructions + dreamReport.prompts;
  if (total === 0) return 100;

  const brokenRatio = dreamReport.brokenRefs / total;
  const health = Math.round((1 - brokenRatio) * 100);
  return Math.max(0, Math.min(100, health));
}

Thresholds

What Counts as a Broken Connection

B5: Chat Memory Audit Thresholds

VS Code Copilot Chat memory (/memories/) accumulates over time. Large memories waste context tokens.

Thresholds

Audit Procedure

1. Count total lines across all files in /memories/ (excluding /memories/session/ and /memories/repo/)
2. Flag entries that are:
   • Duplicated across files
   • Outdated (references old versions, removed features)
   • Too verbose (>5 lines for a single fact)
3. Suggest consolidation: merge related entries, remove stale facts

Memory Efficiency Score

function computeMemoryEfficiency(lines: number): number {
  if (lines <= 150) return 100;
  if (lines <= 200) return Math.round(100 - ((lines - 150) / 50) * 30);
  return Math.max(0, Math.round(70 - ((lines - 200) / 100) * 70));
}

Visual Indicators

Extension Integration

The extension reads these rules by:

1. Running dream-cli.cjs to produce the dream report
2. Parsing .github/quality/dream-report.json for markers
3. Applying the status computation algorithm above
4. Rendering the Health Pulse card with the computed status

The skill defines the rules; the extension implements the computation.