Lifecycle Auditor (L3 Worker)

Purpose & Scope

• Worker in ln-620 coordinator pipeline
• Audit lifecycle (Category 12: Medium Priority)
• Check bootstrap, shutdown, signal handling, probes
• Calculate compliance score (X/10)

Inputs (from Coordinator)

contextStore

Workflow

1. Parse context
2. Check lifecycle patterns
3. Collect findings
4. Calculate score
5. Return JSON

Audit Rules

1. Bootstrap Initialization Order

• Check main/index file for initialization sequence
• Verify dependencies loaded before usage (DB before routes)

• HIGH: Incorrect order causes startup failures

2. Graceful Shutdown

• Grep for

  SIGTERM

  ,

  SIGINT

  handlers
• Check

  process.on('SIGTERM')

  (Node.js)
• Check

  signal.Notify

  (Go)

• HIGH: No shutdown handler (abrupt termination)

3. Resource Cleanup on Exit

• Check if DB connections closed on shutdown
• Verify file handles released
• Check worker threads stopped

• MEDIUM: Resource leaks on shutdown

4. Signal Handling

• Check handlers for SIGTERM, SIGINT, SIGHUP
• Verify proper signal propagation to child processes

• MEDIUM: Missing signal handlers

5. Liveness/Readiness Probes

• Check for

  /live

  ,

  /ready

  endpoints
• Verify Kubernetes probe configuration

• MEDIUM: No probes (Kubernetes can't detect health)

/live

/ready

Scoring Algorithm

shared/references/audit_scoring.md

Output Format

{
  "category": "Lifecycle",
  "score": 7,
  "total_issues": 4,
  "critical": 0,
  "high": 1,
  "medium": 3,
  "low": 0,
  "checks": [
    {"id": "bootstrap_order", "name": "Bootstrap Order", "status": "passed", "details": "Initialization sequence correct: config -> DB -> routes -> server"},
    {"id": "graceful_shutdown", "name": "Graceful Shutdown", "status": "failed", "details": "No SIGTERM handler found"},
    {"id": "resource_cleanup", "name": "Resource Cleanup", "status": "warning", "details": "DB connection closed, but file handles not released"},
    {"id": "signal_handling", "name": "Signal Handling", "status": "warning", "details": "SIGINT handled, SIGTERM missing"},
    {"id": "probes", "name": "Liveness/Readiness Probes", "status": "passed", "details": "/health and /ready endpoints present"}
  ],
  "findings": [
    {
      "severity": "HIGH",
      "location": "src/index.ts:1-50",
      "issue": "No SIGTERM handler for graceful shutdown",
      "principle": "Graceful Shutdown / Resource Management",
      "recommendation": "Add SIGTERM handler to close DB connections and server gracefully",
      "effort": "M"
    }
  ]
}

Reference Files

• Audit scoring formula:

  shared/references/audit_scoring.md

• Audit output schema:

  shared/references/audit_output_schema.md