aios-core/.aios-core/development/tasks/ids-health.md

Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework

# IDS Registry Health Check Task

## Purpose

Run a self-healing health check on the IDS entity registry to detect and auto-fix data integrity issues.

---

## Pre-Conditions

- Entity registry exists at `.aios-core/data/entity-registry.yaml`
- IDS modules are installed (IDS-1, IDS-3, IDS-4a)

---

## Execution

### Step 1: Run Health Check

```bash
node bin/aios-ids.js ids:health
```

Review the output for any detected issues.

### Step 2: Auto-Heal (Optional)

If auto-fixable issues are detected, run with `--fix`:

```bash
node bin/aios-ids.js ids:health --fix
```

This will:
- Create a backup of the registry before changes
- Auto-fix issues: checksum mismatches, orphaned references, missing keywords, stale timestamps
- Skip non-auto-healable issues (missing files) and emit warnings
- Log all healing actions to `.aios-core/data/registry-healing-log.jsonl`

### Step 3: JSON Output (Machine-Readable)

```bash
node bin/aios-ids.js ids:health --json
node bin/aios-ids.js ids:health --fix --json
```

### Step 4: Review Warnings

If critical issues are found (missing files), the command exits with code 1.
Review the warnings and take manual action as suggested.

---

## Post-Conditions

- Registry integrity issues are detected and reported
- Auto-healable issues are fixed (with --fix)
- Non-auto-healable issues generate warnings with suggested actions
- Healing actions are logged for audit trail
- Registry backup is created before any modifications

---

## Exit Codes

| Code | Meaning |
|------|---------|
| 0 | No critical issues |
| 1 | Critical issues found (e.g., missing files) |

---

## Programmatic Usage

```javascript
const { RegistryHealer } = require('.aios-core/core/ids/registry-healer');

const healer = new RegistryHealer();
const healthResult = healer.runHealthCheck();

if (healthResult.summary.total > 0) {
  const healResult = healer.heal(healthResult.issues, { autoOnly: true });
  console.log(`Healed: ${healResult.healed.length}, Skipped: ${healResult.skipped.length}`);
}
```

---

*Story IDS-4a | Self-Healing Data Integrity*