ln-629-lifecycle-auditor

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

Receives contextStore with tech stack, deployment type, codebase root.

1) Parse context

2) Check lifecycle patterns

3) Collect findings

4) Calculate score

5) Return JSON

1. Bootstrap Initialization Order

Detection:

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

Severity:

• HIGH: Incorrect order causes startup failures

Recommendation: Initialize in correct order: config → DB → routes → server

Effort: M (refactor startup)

2. Graceful Shutdown

Detection:

• Grep for SIGTERM, SIGINT handlers
• Check process.on('SIGTERM') (Node.js)
• Check signal.Notify (Go)

Severity:

• HIGH: No shutdown handler (abrupt termination)

Recommendation: Add SIGTERM handler, close connections gracefully

Effort: M (add shutdown logic)

3. Resource Cleanup on Exit

Detection:

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

Severity:

• MEDIUM: Resource leaks on shutdown

Recommendation: Close all resources in shutdown handler

Effort: S-M (add cleanup calls)

4. Signal Handling

Detection:

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

Severity:

• MEDIUM: Missing signal handlers

Recommendation: Handle all standard signals

Effort: S (add signal handlers)

5. Liveness/Readiness Probes

Detection (for containerized apps):

• Check for /live, /ready endpoints
• Verify Kubernetes probe configuration

Severity:

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

Recommendation: Add /live (is running) and /ready (ready for traffic)

Effort: S (add endpoints)

```

penalty = (high 1.0) + (medium 0.5) + (low * 0.2)

score = max(0, 10 - penalty)

```

```json

{

"category": "Lifecycle",

"score": 7,

"total_issues": 4,

"high": 1,

"medium": 3,

"low": 0,

"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"

}

]

}

```

---

Version: 3.0.0

Last Updated: 2025-12-23