bonecode 1.0.0 → 1.2.0

package/bone/output/rag/src/failure_rules.ts

@@ -1,315 +1,315 @@
-// Generated by BoneScript compiler. DO NOT EDIT.
-// Implements spec/10 §6 (Failure Rules)
-//
-// Each rule has: condition, detection, remediation, escalation.
-// Rules are derived from the program's constraints, state machines,
-// dependencies, events, and flows. All rule-based — no ML.
-
-import { logger } from "./logger";
-import { counter, gauge } from "./metrics";
-
-export interface FailureRule {
-  id: string;
-  condition: string;
-  detection: string;
-  remediation: () => Promise<void>;
-  rollback: boolean;
-}
-
-export const RULES: FailureRule[] = [
-  {
-    id: "invalid_transition_KnowledgeBase",
-    condition: "Attempted state transition not in declared machine",
-    detection: "Log with error_code=INVALID_TRANSITION",
-    remediation: async () => {
-      counter("constraint.violated", { entity: "KnowledgeBase", kind: "invalid_transition" });
-      logger.warn("invalid_transition_blocked", { entity_id: "KnowledgeBase", error_code: "INVALID_TRANSITION" });
-    },
-    rollback: false,
-  },
-  {
-    id: "invalid_transition_CodeFile",
-    condition: "Attempted state transition not in declared machine",
-    detection: "Log with error_code=INVALID_TRANSITION",
-    remediation: async () => {
-      counter("constraint.violated", { entity: "CodeFile", kind: "invalid_transition" });
-      logger.warn("invalid_transition_blocked", { entity_id: "CodeFile", error_code: "INVALID_TRANSITION" });
-    },
-    rollback: false,
-  },
-  {
-    id: "invalid_transition_MemoryEntry",
-    condition: "Attempted state transition not in declared machine",
-    detection: "Log with error_code=INVALID_TRANSITION",
-    remediation: async () => {
-      counter("constraint.violated", { entity: "MemoryEntry", kind: "invalid_transition" });
-      logger.warn("invalid_transition_blocked", { entity_id: "MemoryEntry", error_code: "INVALID_TRANSITION" });
-    },
-    rollback: false,
-  },
-  {
-    id: "invalid_transition_IndexingJob",
-    condition: "Attempted state transition not in declared machine",
-    detection: "Log with error_code=INVALID_TRANSITION",
-    remediation: async () => {
-      counter("constraint.violated", { entity: "IndexingJob", kind: "invalid_transition" });
-      logger.warn("invalid_transition_blocked", { entity_id: "IndexingJob", error_code: "INVALID_TRANSITION" });
-    },
-    rollback: false,
-  },
-  {
-    id: "dependency_failure_KnowledgeBaseService_to_KnowledgeBaseStore",
-    condition: "Dependency unreachable or returning errors",
-    detection: "Error rate > 50% in 30s window",
-    remediation: async () => {
-      counter("circuit_breaker.opened", { service: "KnowledgeBaseService", target: "KnowledgeBaseStore" });
-      gauge("circuit_breaker.open", 1, { service: "KnowledgeBaseService", target: "KnowledgeBaseStore" });
-      logger.error("circuit_breaker_open", { service: "KnowledgeBaseService" });
-    },
-    rollback: false,
-  },
-  {
-    id: "dependency_failure_CodeFileService_to_CodeFileStore",
-    condition: "Dependency unreachable or returning errors",
-    detection: "Error rate > 50% in 30s window",
-    remediation: async () => {
-      counter("circuit_breaker.opened", { service: "CodeFileService", target: "CodeFileStore" });
-      gauge("circuit_breaker.open", 1, { service: "CodeFileService", target: "CodeFileStore" });
-      logger.error("circuit_breaker_open", { service: "CodeFileService" });
-    },
-    rollback: false,
-  },
-  {
-    id: "dependency_failure_CodeChunkService_to_CodeChunkStore",
-    condition: "Dependency unreachable or returning errors",
-    detection: "Error rate > 50% in 30s window",
-    remediation: async () => {
-      counter("circuit_breaker.opened", { service: "CodeChunkService", target: "CodeChunkStore" });
-      gauge("circuit_breaker.open", 1, { service: "CodeChunkService", target: "CodeChunkStore" });
-      logger.error("circuit_breaker_open", { service: "CodeChunkService" });
-    },
-    rollback: false,
-  },
-  {
-    id: "dependency_failure_MemoryEntryService_to_MemoryEntryStore",
-    condition: "Dependency unreachable or returning errors",
-    detection: "Error rate > 50% in 30s window",
-    remediation: async () => {
-      counter("circuit_breaker.opened", { service: "MemoryEntryService", target: "MemoryEntryStore" });
-      gauge("circuit_breaker.open", 1, { service: "MemoryEntryService", target: "MemoryEntryStore" });
-      logger.error("circuit_breaker_open", { service: "MemoryEntryService" });
-    },
-    rollback: false,
-  },
-  {
-    id: "dependency_failure_IndexingJobService_to_IndexingJobStore",
-    condition: "Dependency unreachable or returning errors",
-    detection: "Error rate > 50% in 30s window",
-    remediation: async () => {
-      counter("circuit_breaker.opened", { service: "IndexingJobService", target: "IndexingJobStore" });
-      gauge("circuit_breaker.open", 1, { service: "IndexingJobService", target: "IndexingJobStore" });
-      logger.error("circuit_breaker_open", { service: "IndexingJobService" });
-    },
-    rollback: false,
-  },
-  {
-    id: "dependency_failure_APIGateway_to_KnowledgeBaseService",
-    condition: "Dependency unreachable or returning errors",
-    detection: "Error rate > 50% in 30s window",
-    remediation: async () => {
-      counter("circuit_breaker.opened", { service: "APIGateway", target: "KnowledgeBaseService" });
-      gauge("circuit_breaker.open", 1, { service: "APIGateway", target: "KnowledgeBaseService" });
-      logger.error("circuit_breaker_open", { service: "APIGateway" });
-    },
-    rollback: false,
-  },
-  {
-    id: "dependency_failure_APIGateway_to_CodeFileService",
-    condition: "Dependency unreachable or returning errors",
-    detection: "Error rate > 50% in 30s window",
-    remediation: async () => {
-      counter("circuit_breaker.opened", { service: "APIGateway", target: "CodeFileService" });
-      gauge("circuit_breaker.open", 1, { service: "APIGateway", target: "CodeFileService" });
-      logger.error("circuit_breaker_open", { service: "APIGateway" });
-    },
-    rollback: false,
-  },
-  {
-    id: "dependency_failure_APIGateway_to_CodeChunkService",
-    condition: "Dependency unreachable or returning errors",
-    detection: "Error rate > 50% in 30s window",
-    remediation: async () => {
-      counter("circuit_breaker.opened", { service: "APIGateway", target: "CodeChunkService" });
-      gauge("circuit_breaker.open", 1, { service: "APIGateway", target: "CodeChunkService" });
-      logger.error("circuit_breaker_open", { service: "APIGateway" });
-    },
-    rollback: false,
-  },
-  {
-    id: "dependency_failure_APIGateway_to_MemoryEntryService",
-    condition: "Dependency unreachable or returning errors",
-    detection: "Error rate > 50% in 30s window",
-    remediation: async () => {
-      counter("circuit_breaker.opened", { service: "APIGateway", target: "MemoryEntryService" });
-      gauge("circuit_breaker.open", 1, { service: "APIGateway", target: "MemoryEntryService" });
-      logger.error("circuit_breaker_open", { service: "APIGateway" });
-    },
-    rollback: false,
-  },
-  {
-    id: "dependency_failure_APIGateway_to_IndexingJobService",
-    condition: "Dependency unreachable or returning errors",
-    detection: "Error rate > 50% in 30s window",
-    remediation: async () => {
-      counter("circuit_breaker.opened", { service: "APIGateway", target: "IndexingJobService" });
-      gauge("circuit_breaker.open", 1, { service: "APIGateway", target: "IndexingJobService" });
-      logger.error("circuit_breaker_open", { service: "APIGateway" });
-    },
-    rollback: false,
-  },
-  {
-    id: "event_delivery_failure_CodebaseIngestionStarted",
-    condition: "Event not acknowledged within TTL",
-    detection: "Event age > 604800000 ms",
-    remediation: async () => {
-      counter("event.delivery_failed", { event: "CodebaseIngestionStarted" });
-      logger.error("event_delivery_failed", { event: "CodebaseIngestionStarted", error_code: "DELIVERY_TIMEOUT" });
-    },
-    rollback: false,
-  },
-  {
-    id: "event_delivery_failure_CodebaseIngestionCompleted",
-    condition: "Event not acknowledged within TTL",
-    detection: "Event age > 2592000000 ms",
-    remediation: async () => {
-      counter("event.delivery_failed", { event: "CodebaseIngestionCompleted" });
-      logger.error("event_delivery_failed", { event: "CodebaseIngestionCompleted", error_code: "DELIVERY_TIMEOUT" });
-    },
-    rollback: true,
-  },
-  {
-    id: "event_delivery_failure_FileIndexed",
-    condition: "Event not acknowledged within TTL",
-    detection: "Event age > 604800000 ms",
-    remediation: async () => {
-      counter("event.delivery_failed", { event: "FileIndexed" });
-      logger.error("event_delivery_failed", { event: "FileIndexed", error_code: "DELIVERY_TIMEOUT" });
-    },
-    rollback: false,
-  },
-  {
-    id: "event_delivery_failure_MemoryStored",
-    condition: "Event not acknowledged within TTL",
-    detection: "Event age > 2592000000 ms",
-    remediation: async () => {
-      counter("event.delivery_failed", { event: "MemoryStored" });
-      logger.error("event_delivery_failed", { event: "MemoryStored", error_code: "DELIVERY_TIMEOUT" });
-    },
-    rollback: false,
-  },
-  {
-    id: "flow_step_failure_ingest_codebase_pipeline_scan",
-    condition: "Flow step failed after max retries",
-    detection: "Step returns error after retry policy exhausted",
-    remediation: async () => {
-      counter("flow.step_failed", { flow: "ingest_codebase_pipeline", step: "scan" });
-      // Trigger compensation: mark_kb_error(knowledge_base)
-      logger.error("flow_step_failed", { event: "ingest_codebase_pipeline.scan", error_code: "STEP_FAILED" });
-    },
-    rollback: true,
-  },
-  {
-    id: "flow_step_failure_ingest_codebase_pipeline_chunk",
-    condition: "Flow step failed after max retries",
-    detection: "Step returns error after retry policy exhausted",
-    remediation: async () => {
-      counter("flow.step_failed", { flow: "ingest_codebase_pipeline", step: "chunk" });
-      // Trigger compensation: delete_partial_chunks(knowledge_base)
-      logger.error("flow_step_failed", { event: "ingest_codebase_pipeline.chunk", error_code: "STEP_FAILED" });
-    },
-    rollback: true,
-  },
-  {
-    id: "flow_step_failure_ingest_codebase_pipeline_embed",
-    condition: "Flow step failed after max retries",
-    detection: "Step returns error after retry policy exhausted",
-    remediation: async () => {
-      counter("flow.step_failed", { flow: "ingest_codebase_pipeline", step: "embed" });
-      // Trigger compensation: delete_embeddings(knowledge_base)
-      logger.error("flow_step_failed", { event: "ingest_codebase_pipeline.embed", error_code: "STEP_FAILED" });
-    },
-    rollback: true,
-  },
-  {
-    id: "flow_step_failure_ingest_codebase_pipeline_finalize",
-    condition: "Flow step failed after max retries",
-    detection: "Step returns error after retry policy exhausted",
-    remediation: async () => {
-      counter("flow.step_failed", { flow: "ingest_codebase_pipeline", step: "finalize" });
-      // Trigger compensation: mark_kb_error(knowledge_base)
-      logger.error("flow_step_failed", { event: "ingest_codebase_pipeline.finalize", error_code: "STEP_FAILED" });
-    },
-    rollback: true,
-  },
-  {
-    id: "flow_step_failure_reindex_file_pipeline_delete_old",
-    condition: "Flow step failed after max retries",
-    detection: "Step returns error after retry policy exhausted",
-    remediation: async () => {
-      counter("flow.step_failed", { flow: "reindex_file_pipeline", step: "delete_old" });
-      // Trigger compensation: restore_old_chunks(knowledge_base, file_path)
-      logger.error("flow_step_failed", { event: "reindex_file_pipeline.delete_old", error_code: "STEP_FAILED" });
-    },
-    rollback: true,
-  },
-  {
-    id: "flow_step_failure_reindex_file_pipeline_chunk",
-    condition: "Flow step failed after max retries",
-    detection: "Step returns error after retry policy exhausted",
-    remediation: async () => {
-      counter("flow.step_failed", { flow: "reindex_file_pipeline", step: "chunk" });
-      // Trigger compensation: delete_new_chunks(knowledge_base, file_path)
-      logger.error("flow_step_failed", { event: "reindex_file_pipeline.chunk", error_code: "STEP_FAILED" });
-    },
-    rollback: true,
-  },
-  {
-    id: "flow_step_failure_reindex_file_pipeline_embed",
-    condition: "Flow step failed after max retries",
-    detection: "Step returns error after retry policy exhausted",
-    remediation: async () => {
-      counter("flow.step_failed", { flow: "reindex_file_pipeline", step: "embed" });
-      // Trigger compensation: delete_new_embeddings(knowledge_base, file_path)
-      logger.error("flow_step_failed", { event: "reindex_file_pipeline.embed", error_code: "STEP_FAILED" });
-    },
-    rollback: true,
-  },
-  {
-    id: "flow_step_failure_reindex_file_pipeline_update",
-    condition: "Flow step failed after max retries",
-    detection: "Step returns error after retry policy exhausted",
-    remediation: async () => {
-      counter("flow.step_failed", { flow: "reindex_file_pipeline", step: "update" });
-      // Trigger compensation: restore_old_file_record(knowledge_base, file_path)
-      logger.error("flow_step_failed", { event: "reindex_file_pipeline.update", error_code: "STEP_FAILED" });
-    },
-    rollback: true,
-  },
-];
-
-export function findRule(id: string): FailureRule | undefined {
-  return RULES.find(r => r.id === id);
-}
-
-export async function triggerRule(id: string): Promise<void> {
-  const rule = findRule(id);
-  if (!rule) {
-    logger.warn("unknown_rule_triggered", { event: "rule_lookup", error_code: "UNKNOWN_RULE", metadata: { id } });
-    return;
-  }
-  try {
-    await rule.remediation();
-  } catch (e: any) {
-    logger.error("remediation_failed", { event: id, error_code: "REMEDIATION_FAILED", metadata: { error: e.message } });
-  }
+// Generated by BoneScript compiler. DO NOT EDIT.
+// Implements spec/10 §6 (Failure Rules)
+//
+// Each rule has: condition, detection, remediation, escalation.
+// Rules are derived from the program's constraints, state machines,
+// dependencies, events, and flows. All rule-based — no ML.
+
+import { logger } from "./logger";
+import { counter, gauge } from "./metrics";
+
+export interface FailureRule {
+  id: string;
+  condition: string;
+  detection: string;
+  remediation: () => Promise<void>;
+  rollback: boolean;
+}
+
+export const RULES: FailureRule[] = [
+  {
+    id: "invalid_transition_KnowledgeBase",
+    condition: "Attempted state transition not in declared machine",
+    detection: "Log with error_code=INVALID_TRANSITION",
+    remediation: async () => {
+      counter("constraint.violated", { entity: "KnowledgeBase", kind: "invalid_transition" });
+      logger.warn("invalid_transition_blocked", { entity_id: "KnowledgeBase", error_code: "INVALID_TRANSITION" });
+    },
+    rollback: false,
+  },
+  {
+    id: "invalid_transition_CodeFile",
+    condition: "Attempted state transition not in declared machine",
+    detection: "Log with error_code=INVALID_TRANSITION",
+    remediation: async () => {
+      counter("constraint.violated", { entity: "CodeFile", kind: "invalid_transition" });
+      logger.warn("invalid_transition_blocked", { entity_id: "CodeFile", error_code: "INVALID_TRANSITION" });
+    },
+    rollback: false,
+  },
+  {
+    id: "invalid_transition_MemoryEntry",
+    condition: "Attempted state transition not in declared machine",
+    detection: "Log with error_code=INVALID_TRANSITION",
+    remediation: async () => {
+      counter("constraint.violated", { entity: "MemoryEntry", kind: "invalid_transition" });
+      logger.warn("invalid_transition_blocked", { entity_id: "MemoryEntry", error_code: "INVALID_TRANSITION" });
+    },
+    rollback: false,
+  },
+  {
+    id: "invalid_transition_IndexingJob",
+    condition: "Attempted state transition not in declared machine",
+    detection: "Log with error_code=INVALID_TRANSITION",
+    remediation: async () => {
+      counter("constraint.violated", { entity: "IndexingJob", kind: "invalid_transition" });
+      logger.warn("invalid_transition_blocked", { entity_id: "IndexingJob", error_code: "INVALID_TRANSITION" });
+    },
+    rollback: false,
+  },
+  {
+    id: "dependency_failure_KnowledgeBaseService_to_KnowledgeBaseStore",
+    condition: "Dependency unreachable or returning errors",
+    detection: "Error rate > 50% in 30s window",
+    remediation: async () => {
+      counter("circuit_breaker.opened", { service: "KnowledgeBaseService", target: "KnowledgeBaseStore" });
+      gauge("circuit_breaker.open", 1, { service: "KnowledgeBaseService", target: "KnowledgeBaseStore" });
+      logger.error("circuit_breaker_open", { service: "KnowledgeBaseService" });
+    },
+    rollback: false,
+  },
+  {
+    id: "dependency_failure_CodeFileService_to_CodeFileStore",
+    condition: "Dependency unreachable or returning errors",
+    detection: "Error rate > 50% in 30s window",
+    remediation: async () => {
+      counter("circuit_breaker.opened", { service: "CodeFileService", target: "CodeFileStore" });
+      gauge("circuit_breaker.open", 1, { service: "CodeFileService", target: "CodeFileStore" });
+      logger.error("circuit_breaker_open", { service: "CodeFileService" });
+    },
+    rollback: false,
+  },
+  {
+    id: "dependency_failure_CodeChunkService_to_CodeChunkStore",
+    condition: "Dependency unreachable or returning errors",
+    detection: "Error rate > 50% in 30s window",
+    remediation: async () => {
+      counter("circuit_breaker.opened", { service: "CodeChunkService", target: "CodeChunkStore" });
+      gauge("circuit_breaker.open", 1, { service: "CodeChunkService", target: "CodeChunkStore" });
+      logger.error("circuit_breaker_open", { service: "CodeChunkService" });
+    },
+    rollback: false,
+  },
+  {
+    id: "dependency_failure_MemoryEntryService_to_MemoryEntryStore",
+    condition: "Dependency unreachable or returning errors",
+    detection: "Error rate > 50% in 30s window",
+    remediation: async () => {
+      counter("circuit_breaker.opened", { service: "MemoryEntryService", target: "MemoryEntryStore" });
+      gauge("circuit_breaker.open", 1, { service: "MemoryEntryService", target: "MemoryEntryStore" });
+      logger.error("circuit_breaker_open", { service: "MemoryEntryService" });
+    },
+    rollback: false,
+  },
+  {
+    id: "dependency_failure_IndexingJobService_to_IndexingJobStore",
+    condition: "Dependency unreachable or returning errors",
+    detection: "Error rate > 50% in 30s window",
+    remediation: async () => {
+      counter("circuit_breaker.opened", { service: "IndexingJobService", target: "IndexingJobStore" });
+      gauge("circuit_breaker.open", 1, { service: "IndexingJobService", target: "IndexingJobStore" });
+      logger.error("circuit_breaker_open", { service: "IndexingJobService" });
+    },
+    rollback: false,
+  },
+  {
+    id: "dependency_failure_APIGateway_to_KnowledgeBaseService",
+    condition: "Dependency unreachable or returning errors",
+    detection: "Error rate > 50% in 30s window",
+    remediation: async () => {
+      counter("circuit_breaker.opened", { service: "APIGateway", target: "KnowledgeBaseService" });
+      gauge("circuit_breaker.open", 1, { service: "APIGateway", target: "KnowledgeBaseService" });
+      logger.error("circuit_breaker_open", { service: "APIGateway" });
+    },
+    rollback: false,
+  },
+  {
+    id: "dependency_failure_APIGateway_to_CodeFileService",
+    condition: "Dependency unreachable or returning errors",
+    detection: "Error rate > 50% in 30s window",
+    remediation: async () => {
+      counter("circuit_breaker.opened", { service: "APIGateway", target: "CodeFileService" });
+      gauge("circuit_breaker.open", 1, { service: "APIGateway", target: "CodeFileService" });
+      logger.error("circuit_breaker_open", { service: "APIGateway" });
+    },
+    rollback: false,
+  },
+  {
+    id: "dependency_failure_APIGateway_to_CodeChunkService",
+    condition: "Dependency unreachable or returning errors",
+    detection: "Error rate > 50% in 30s window",
+    remediation: async () => {
+      counter("circuit_breaker.opened", { service: "APIGateway", target: "CodeChunkService" });
+      gauge("circuit_breaker.open", 1, { service: "APIGateway", target: "CodeChunkService" });
+      logger.error("circuit_breaker_open", { service: "APIGateway" });
+    },
+    rollback: false,
+  },
+  {
+    id: "dependency_failure_APIGateway_to_MemoryEntryService",
+    condition: "Dependency unreachable or returning errors",
+    detection: "Error rate > 50% in 30s window",
+    remediation: async () => {
+      counter("circuit_breaker.opened", { service: "APIGateway", target: "MemoryEntryService" });
+      gauge("circuit_breaker.open", 1, { service: "APIGateway", target: "MemoryEntryService" });
+      logger.error("circuit_breaker_open", { service: "APIGateway" });
+    },
+    rollback: false,
+  },
+  {
+    id: "dependency_failure_APIGateway_to_IndexingJobService",
+    condition: "Dependency unreachable or returning errors",
+    detection: "Error rate > 50% in 30s window",
+    remediation: async () => {
+      counter("circuit_breaker.opened", { service: "APIGateway", target: "IndexingJobService" });
+      gauge("circuit_breaker.open", 1, { service: "APIGateway", target: "IndexingJobService" });
+      logger.error("circuit_breaker_open", { service: "APIGateway" });
+    },
+    rollback: false,
+  },
+  {
+    id: "event_delivery_failure_CodebaseIngestionStarted",
+    condition: "Event not acknowledged within TTL",
+    detection: "Event age > 604800000 ms",
+    remediation: async () => {
+      counter("event.delivery_failed", { event: "CodebaseIngestionStarted" });
+      logger.error("event_delivery_failed", { event: "CodebaseIngestionStarted", error_code: "DELIVERY_TIMEOUT" });
+    },
+    rollback: false,
+  },
+  {
+    id: "event_delivery_failure_CodebaseIngestionCompleted",
+    condition: "Event not acknowledged within TTL",
+    detection: "Event age > 2592000000 ms",
+    remediation: async () => {
+      counter("event.delivery_failed", { event: "CodebaseIngestionCompleted" });
+      logger.error("event_delivery_failed", { event: "CodebaseIngestionCompleted", error_code: "DELIVERY_TIMEOUT" });
+    },
+    rollback: true,
+  },
+  {
+    id: "event_delivery_failure_FileIndexed",
+    condition: "Event not acknowledged within TTL",
+    detection: "Event age > 604800000 ms",
+    remediation: async () => {
+      counter("event.delivery_failed", { event: "FileIndexed" });
+      logger.error("event_delivery_failed", { event: "FileIndexed", error_code: "DELIVERY_TIMEOUT" });
+    },
+    rollback: false,
+  },
+  {
+    id: "event_delivery_failure_MemoryStored",
+    condition: "Event not acknowledged within TTL",
+    detection: "Event age > 2592000000 ms",
+    remediation: async () => {
+      counter("event.delivery_failed", { event: "MemoryStored" });
+      logger.error("event_delivery_failed", { event: "MemoryStored", error_code: "DELIVERY_TIMEOUT" });
+    },
+    rollback: false,
+  },
+  {
+    id: "flow_step_failure_ingest_codebase_pipeline_scan",
+    condition: "Flow step failed after max retries",
+    detection: "Step returns error after retry policy exhausted",
+    remediation: async () => {
+      counter("flow.step_failed", { flow: "ingest_codebase_pipeline", step: "scan" });
+      // Trigger compensation: mark_kb_error(knowledge_base)
+      logger.error("flow_step_failed", { event: "ingest_codebase_pipeline.scan", error_code: "STEP_FAILED" });
+    },
+    rollback: true,
+  },
+  {
+    id: "flow_step_failure_ingest_codebase_pipeline_chunk",
+    condition: "Flow step failed after max retries",
+    detection: "Step returns error after retry policy exhausted",
+    remediation: async () => {
+      counter("flow.step_failed", { flow: "ingest_codebase_pipeline", step: "chunk" });
+      // Trigger compensation: delete_partial_chunks(knowledge_base)
+      logger.error("flow_step_failed", { event: "ingest_codebase_pipeline.chunk", error_code: "STEP_FAILED" });
+    },
+    rollback: true,
+  },
+  {
+    id: "flow_step_failure_ingest_codebase_pipeline_embed",
+    condition: "Flow step failed after max retries",
+    detection: "Step returns error after retry policy exhausted",
+    remediation: async () => {
+      counter("flow.step_failed", { flow: "ingest_codebase_pipeline", step: "embed" });
+      // Trigger compensation: delete_embeddings(knowledge_base)
+      logger.error("flow_step_failed", { event: "ingest_codebase_pipeline.embed", error_code: "STEP_FAILED" });
+    },
+    rollback: true,
+  },
+  {
+    id: "flow_step_failure_ingest_codebase_pipeline_finalize",
+    condition: "Flow step failed after max retries",
+    detection: "Step returns error after retry policy exhausted",
+    remediation: async () => {
+      counter("flow.step_failed", { flow: "ingest_codebase_pipeline", step: "finalize" });
+      // Trigger compensation: mark_kb_error(knowledge_base)
+      logger.error("flow_step_failed", { event: "ingest_codebase_pipeline.finalize", error_code: "STEP_FAILED" });
+    },
+    rollback: true,
+  },
+  {
+    id: "flow_step_failure_reindex_file_pipeline_delete_old",
+    condition: "Flow step failed after max retries",
+    detection: "Step returns error after retry policy exhausted",
+    remediation: async () => {
+      counter("flow.step_failed", { flow: "reindex_file_pipeline", step: "delete_old" });
+      // Trigger compensation: restore_old_chunks(knowledge_base, file_path)
+      logger.error("flow_step_failed", { event: "reindex_file_pipeline.delete_old", error_code: "STEP_FAILED" });
+    },
+    rollback: true,
+  },
+  {
+    id: "flow_step_failure_reindex_file_pipeline_chunk",
+    condition: "Flow step failed after max retries",
+    detection: "Step returns error after retry policy exhausted",
+    remediation: async () => {
+      counter("flow.step_failed", { flow: "reindex_file_pipeline", step: "chunk" });
+      // Trigger compensation: delete_new_chunks(knowledge_base, file_path)
+      logger.error("flow_step_failed", { event: "reindex_file_pipeline.chunk", error_code: "STEP_FAILED" });
+    },
+    rollback: true,
+  },
+  {
+    id: "flow_step_failure_reindex_file_pipeline_embed",
+    condition: "Flow step failed after max retries",
+    detection: "Step returns error after retry policy exhausted",
+    remediation: async () => {
+      counter("flow.step_failed", { flow: "reindex_file_pipeline", step: "embed" });
+      // Trigger compensation: delete_new_embeddings(knowledge_base, file_path)
+      logger.error("flow_step_failed", { event: "reindex_file_pipeline.embed", error_code: "STEP_FAILED" });
+    },
+    rollback: true,
+  },
+  {
+    id: "flow_step_failure_reindex_file_pipeline_update",
+    condition: "Flow step failed after max retries",
+    detection: "Step returns error after retry policy exhausted",
+    remediation: async () => {
+      counter("flow.step_failed", { flow: "reindex_file_pipeline", step: "update" });
+      // Trigger compensation: restore_old_file_record(knowledge_base, file_path)
+      logger.error("flow_step_failed", { event: "reindex_file_pipeline.update", error_code: "STEP_FAILED" });
+    },
+    rollback: true,
+  },
+];
+
+export function findRule(id: string): FailureRule | undefined {
+  return RULES.find(r => r.id === id);
+}
+
+export async function triggerRule(id: string): Promise<void> {
+  const rule = findRule(id);
+  if (!rule) {
+    logger.warn("unknown_rule_triggered", { event: "rule_lookup", error_code: "UNKNOWN_RULE", metadata: { id } });
+    return;
+  }
+  try {
+    await rule.remediation();
+  } catch (e: any) {
+    logger.error("remediation_failed", { event: id, error_code: "REMEDIATION_FAILED", metadata: { error: e.message } });
+  }
 }