@fx-data/ai-diagnostics 0.1.20261026070913 → 0.1.20261107142011

package/content/knowledge/update/diagnostic/observability/lookups/analysis-update-load-operation.json

@@ -1,108 +0,0 @@
-{
-  "lookup_id": "analysis-update-load-operation",
-  "logical_event": "physical-load-operation",
-  "lifecycle_stage": "load",
-  "graph_kind": "execution",
-  "signal_status": "missing",
-  "signals": {
-    "span_names": [],
-    "attribute_keys": [],
-    "structured_fields": [],
-    "log_signatures": [],
-    "metric_names": []
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "No stable signal uniquely brackets entry and terminal outcome of every selected TableUpdateManager.load call.",
-  "correlations": [
-    {
-      "edge_id": "edge-load-decision-to-load-operation",
-      "from_unit": "load-decision",
-      "to_unit": "load-operation",
-      "correlation_keys": [
-        "node object within the same execution scope"
-      ],
-      "semantics": "Only the branch that passes activity, availability, execution-mode, and type-specific load gates invokes the manager load.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process",
-      "durability": "execution-scope",
-      "coverage_limit": "There is no native load-operation ID."
-    },
-    {
-      "edge_id": "edge-load-operation-to-engine-task",
-      "from_unit": "load-operation",
-      "to_unit": "engine-task",
-      "correlation_keys": [
-        "server call scope",
-        "engine task ID returned in writer metric on success"
-      ],
-      "semantics": "A load operation creates an engine task only when it enters a Polars write executor.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-conditional",
-      "durability": "result-dependent",
-      "coverage_limit": "Failed and retried engine attempts are not fully exposed as a server-side durable lineage."
-    }
-  ],
-  "counting_unit": "load-operation",
-  "input_units": [
-    "load-decision"
-  ],
-  "output_units": [
-    "load-operation",
-    "optional-engine-task"
-  ],
-  "state_owner": "Analysis-table load utility and selected table update manager.",
-  "reads": [
-    "current entry metadata",
-    "source entity and parameter/user context",
-    "type-specific manager and engine execution mode"
-  ],
-  "writes": [
-    "writer metric result or load exception",
-    "physical data only through the selected downstream engine or data-source boundary"
-  ],
-  "success_condition": "The selected manager returns a writer result; an engine task is optional and must be confirmed separately.",
-  "failure_recovery": [
-    {
-      "branch": "server-side preparation or manager load fails",
-      "outcome": "The node primary result becomes failure unless a distinct infrastructure branch stops execution.",
-      "recovery": "Engine-internal retry and dispatch recovery are kept separate."
-    },
-    {
-      "branch": "manager returns a non-executed or zero result",
-      "outcome": "The load operation has no engine task.",
-      "recovery": "The primary result preserves the no-engine boundary."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed",
-  "edge_refs": [
-    "edge-load-decision-to-load-operation",
-    "edge-load-operation-to-engine-task"
-  ],
-  "field_presence_preflight": [],
-  "coverage_limits": [
-    "Different table types may cross a synchronizer or direct engine boundary; Phase 2 stops at the explicit main-server handoff.",
-    "Full Load:id = {}, transferName = {} is emitted before TableUpdateManager.needLoad, so it cannot identify a physical load operation.",
-    "polarsConsumed and engine taskId cover only conditional downstream paths and must not be promoted to a general load-operation identity.",
-    "UpdateUtils records update.load_data duration/result through UpdateLoadDataMetrics, with bounded scene/execution_mode/result labels. It has no table, chain, load or attempt identity and cannot bracket one selected operation. Collection at the current backend remains unverified.",
-    "Calculation row restrictions now depend on DefaultAnalysisEntryInfo.hasEnabledCalculationStep. ComputeEntity loads with no enabled calculation step use etlWithoutCalculationRowRestriction; lake-source loads also receive an UpdateTaskProfile. Do not infer that every analysis-table update applies the same calculation-row limit."
-  ],
-  "invalidators": [
-    {
-      "kind": "revision-change",
-      "event": "The frozen main-server revision or build anchor changes.",
-      "effect": "needs_revalidation"
-    },
-    {
-      "kind": "signal-drift",
-      "event": "A named span, attribute, structured field, log template, metric, or its production condition changes.",
-      "effect": "needs_revalidation"
-    },
-    {
-      "kind": "scope-change",
-      "event": "The dispatch, update, queue, listener, or engine-handoff service boundary changes.",
-      "effect": "needs_revalidation"
-    }
-  ]
-}

package/content/knowledge/update/diagnostic/observability/lookups/analysis-update-lock-requeued.json

@@ -1,108 +0,0 @@
-{
-  "lookup_id": "analysis-update-lock-requeued",
-  "logical_event": "attempt-lock-requeued",
-  "lifecycle_stage": "consumer",
-  "graph_kind": "execution",
-  "signal_status": "source-confirmed",
-  "signals": {
-    "span_names": [],
-    "attribute_keys": [],
-    "structured_fields": [],
-    "log_signatures": [
-      "resend execute info, nodeTaskId {}, id {}, chainId {}"
-    ],
-    "metric_names": []
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "RabbitNodeTaskMQListener emits the stable resend template after producer.sendNodeTask returns for ReQueueException; frozen source has one ReQueueException producer, the node-lock timeout.",
-  "correlations": [
-    {
-      "edge_id": "edge-attempt-to-lock-requeue",
-      "from_unit": "execution-attempt",
-      "to_unit": "requeue",
-      "correlation_keys": [
-        "execution detail ID",
-        "node table ID",
-        "update chain ID"
-      ],
-      "semantics": "A node-running lock timeout republishes the same execution detail to the main queue.",
-      "asynchronous": true,
-      "correlation_status": "source-confirmed-payload",
-      "durability": "message-lifetime",
-      "coverage_limit": "No attempt or requeue ID is added."
-    },
-    {
-      "edge_id": "edge-lock-requeue-to-attempt",
-      "from_unit": "requeue",
-      "to_unit": "execution-attempt",
-      "correlation_keys": [
-        "execution detail ID"
-      ],
-      "semantics": "The republished detail may create a later main-consumer attempt.",
-      "asynchronous": true,
-      "correlation_status": "source-confirmed-payload",
-      "durability": "message-lifetime",
-      "coverage_limit": "Repeated delivery count is not persisted."
-    }
-  ],
-  "counting_unit": "requeue",
-  "input_units": [
-    "execution-attempt"
-  ],
-  "output_units": [
-    "requeue"
-  ],
-  "state_owner": "Distributed node-running lock and main consumer.",
-  "reads": [
-    "node-running lock",
-    "effective lock wait configuration"
-  ],
-  "writes": [
-    "main-queue republication of the same execution detail"
-  ],
-  "success_condition": "A lock timeout ends the current attempt without primary node work and republishes the same detail.",
-  "failure_recovery": [
-    {
-      "branch": "lock becomes available on a later delivery",
-      "outcome": "The later attempt proceeds to merge and node work.",
-      "recovery": "No attempt lineage beyond the reused detail ID is persisted."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed",
-  "edge_refs": [
-    "edge-attempt-to-lock-requeue",
-    "edge-lock-requeue-to-attempt"
-  ],
-  "field_presence_preflight": [
-    {
-      "field": "resend execute info, nodeTaskId {}, id {}, chainId {}",
-      "signal_type": "log-signature",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    }
-  ],
-  "coverage_limits": [
-    "The node requeue flag used by node metrics is not set by this current lock-requeue branch.",
-    "The execution-detail ID is reused and there is no requeue ID or ordinal.",
-    "The log template is the signal; rendered dynamic arguments or temporal proximity are not correlation keys."
-  ],
-  "invalidators": [
-    {
-      "kind": "revision-change",
-      "event": "The frozen main-server revision or build anchor changes.",
-      "effect": "needs_revalidation"
-    },
-    {
-      "kind": "signal-drift",
-      "event": "A named span, attribute, structured field, log template, metric, or its production condition changes.",
-      "effect": "needs_revalidation"
-    },
-    {
-      "kind": "scope-change",
-      "event": "The dispatch, update, queue, listener, or engine-handoff service boundary changes.",
-      "effect": "needs_revalidation"
-    }
-  ]
-}

package/content/knowledge/update/diagnostic/observability/lookups/analysis-update-logical-dependency-expansion.json

@@ -1,129 +0,0 @@
-{
-  "lookup_id": "analysis-update-logical-dependency-expansion",
-  "logical_event": "logical-dependency-expanded",
-  "lifecycle_stage": "control",
-  "graph_kind": "logical",
-  "signal_status": "source-confirmed",
-  "signals": {
-    "span_names": [
-      "dispatch_get_ancestors",
-      "dispatch_get_ancestors_batch",
-      "dispatch_get_descendants"
-    ],
-    "attribute_keys": [],
-    "structured_fields": [],
-    "log_signatures": [
-      "getAncestors error {}",
-      "getDescendants error {}"
-    ],
-    "metric_names": []
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "DispatchDependencyManager emits the named span for each single, batch, or descendant dependency-provider call and emits the stable error template on provider failure.",
-  "correlations": [
-    {
-      "edge_id": "edge-logical-parent-to-child",
-      "from_unit": "dag-node",
-      "to_unit": "dag-node",
-      "correlation_keys": [
-        "parent table ID",
-        "child table ID",
-        "chain or merged-chain scope"
-      ],
-      "semantics": "A current dependency-provider relation allows a parent result to gate and eventually release a child.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-logical",
-      "durability": "not-snapshotted",
-      "coverage_limit": "Later current lineage cannot prove the earlier historical edge."
-    }
-  ],
-  "counting_unit": "logical-dag-edge",
-  "input_units": [
-    "effective-root",
-    "dag-node"
-  ],
-  "output_units": [
-    "dag-node",
-    "logical-dag-edge"
-  ],
-  "state_owner": "Current lineage and linked-dependency providers.",
-  "reads": [
-    "lineage ancestors and descendants",
-    "linked parent and child relations"
-  ],
-  "writes": [
-    "in-memory dependency views used for root selection, start scope, parent gates, and child release"
-  ],
-  "success_condition": "The dependency manager composes the required current views without treating a single provider as the whole DAG.",
-  "failure_recovery": [
-    {
-      "branch": "dependency provider is unavailable",
-      "outcome": "The current stage is unknown and the execution path may route to infrastructure recovery.",
-      "recovery": "Re-evaluate from the current dependency providers after availability returns."
-    },
-    {
-      "branch": "a direct child forms a detected cycle with current parent evidence",
-      "outcome": "That child is excluded from the current release set.",
-      "recovery": "Other non-cyclic children may continue."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed",
-  "edge_refs": [
-    "edge-logical-parent-to-child"
-  ],
-  "field_presence_preflight": [
-    {
-      "field": "dispatch_get_ancestors",
-      "signal_type": "span-name",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "dispatch_get_ancestors_batch",
-      "signal_type": "span-name",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "dispatch_get_descendants",
-      "signal_type": "span-name",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "getAncestors error {}",
-      "signal_type": "log-signature",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "getDescendants error {}",
-      "signal_type": "log-signature",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    }
-  ],
-  "coverage_limits": [
-    "The graph is incrementally re-read and is not persisted as a historical snapshot.",
-    "The spans contain no parent-child pair, chain scope, dependency revision, or result cardinality; they confirm calls, not the historical logical graph."
-  ],
-  "invalidators": [
-    {
-      "kind": "revision-change",
-      "event": "The frozen main-server revision or build anchor changes.",
-      "effect": "needs_revalidation"
-    },
-    {
-      "kind": "signal-drift",
-      "event": "A named span, attribute, structured field, log template, metric, or its production condition changes.",
-      "effect": "needs_revalidation"
-    },
-    {
-      "kind": "scope-change",
-      "event": "The dispatch, update, queue, listener, or engine-handoff service boundary changes.",
-      "effect": "needs_revalidation"
-    }
-  ]
-}

package/content/knowledge/update/diagnostic/observability/lookups/analysis-update-merge-decision.json

@@ -1,174 +0,0 @@
-{
-  "lookup_id": "analysis-update-merge-decision",
-  "logical_event": "node-merge-decided",
-  "lifecycle_stage": "consumer",
-  "graph_kind": "execution",
-  "signal_status": "source-confirmed",
-  "signals": {
-    "span_names": [],
-    "attribute_keys": [
-      "merge_count",
-      "merge_round_count",
-      "wait_merge_time"
-    ],
-    "structured_fields": [],
-    "log_signatures": [
-      "merge isolationMode {}, executeId {} nodeTaskId: {}, merge mergeExecuteIds {} chainIds {}"
-    ],
-    "metric_names": []
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "DefaultNodeTaskMergedStrategy emits the selection template for every merge evaluation; it decorates the update span with merge attributes only when more than one context is merged.",
-  "correlations": [
-    {
-      "edge_id": "edge-attempt-to-merge",
-      "from_unit": "execution-attempt",
-      "to_unit": "merge-decision",
-      "correlation_keys": [
-        "execution detail ID",
-        "node table ID"
-      ],
-      "semantics": "An attempt holding the node lock queries eligible same-node frontier details and selects a merge result.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process",
-      "durability": "execution-scope",
-      "coverage_limit": "No merge-decision ID is persisted."
-    },
-    {
-      "edge_id": "edge-merge-member-to-effective-execution",
-      "from_unit": "execution-detail",
-      "to_unit": "dag-node",
-      "correlation_keys": [
-        "merged execution detail IDs",
-        "merged chain IDs",
-        "node table ID"
-      ],
-      "semantics": "Multiple eligible details and chain contexts may converge on one selected node task and one primary result.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process",
-      "durability": "execution-scope",
-      "coverage_limit": "Merge membership does not establish a one-to-one load or engine-task relation."
-    },
-    {
-      "edge_id": "edge-merge-to-load-decision",
-      "from_unit": "merge-decision",
-      "to_unit": "load-decision",
-      "correlation_keys": [
-        "node table ID",
-        "merged chain IDs"
-      ],
-      "semantics": "The selected merged node and context enter parent gating and load decision once.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process",
-      "durability": "execution-scope",
-      "coverage_limit": "The load decision has no independent ID."
-    },
-    {
-      "edge_id": "edge-effective-execution-to-listener-before",
-      "from_unit": "dag-node",
-      "to_unit": "listener-invocation",
-      "correlation_keys": [
-        "update chain or merged-chain context",
-        "node table ID",
-        "listener name and onBefore phase"
-      ],
-      "semantics": "After merge selects an effective node task, each selected named listener receives onBefore before parent-failure evaluation and node work; no primary node result exists yet.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process",
-      "durability": "listener-specific",
-      "coverage_limit": "This edge does not carry a node-primary-result and does not prove that later node work succeeds.",
-      "callback_phases": [
-        "onBefore"
-      ]
-    }
-  ],
-  "counting_unit": "merge-decision",
-  "input_units": [
-    "execution-attempt",
-    "execution-detail",
-    "update-chain"
-  ],
-  "output_units": [
-    "merge-decision",
-    "dag-node"
-  ],
-  "state_owner": "Node-task merge strategy and merged node-task context.",
-  "reads": [
-    "same-node frontier details in mergeable status",
-    "scene and dynamic merge policy",
-    "merge mode, submit-time window, submitter partition, and merge round"
-  ],
-  "writes": [
-    "in-memory main context with merged chain IDs, listeners, earliest submit time, and incremented merge round"
-  ],
-  "success_condition": "Eligible frontier details converge on one selected node task without erasing the member chain identities.",
-  "failure_recovery": [
-    {
-      "branch": "no mergeable detail remains",
-      "outcome": "The delivery performs no node work because another execution may already own the merged members.",
-      "recovery": "Member cleanup belongs to the execution that obtained the details."
-    },
-    {
-      "branch": "merge round reaches its configured limit",
-      "outcome": "A child that would otherwise remain INIT may become READY instead of waiting across chains.",
-      "recovery": "Execution progresses without claiming full-chain exactly-once behavior."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed-with-enabled-test",
-  "edge_refs": [
-    "edge-attempt-to-merge",
-    "edge-merge-member-to-effective-execution",
-    "edge-merge-to-load-decision",
-    "edge-effective-execution-to-listener-before"
-  ],
-  "field_presence_preflight": [
-    {
-      "field": "merge_count",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "merge_round_count",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "wait_merge_time",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "merge isolationMode {}, executeId {} nodeTaskId: {}, merge mergeExecuteIds {} chainIds {}",
-      "signal_type": "log-signature",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    }
-  ],
-  "coverage_limits": [
-    "A merge decision proves neither one request nor one chain nor one physical load.",
-    "The attributes are absent for the zero-or-one-member path and no merge-decision ID or durable member ledger exists.",
-    "Rendered collection values are not safe standalone correlation identities."
-  ],
-  "invalidators": [
-    {
-      "kind": "revision-change",
-      "event": "The frozen main-server revision or build anchor changes.",
-      "effect": "needs_revalidation"
-    },
-    {
-      "kind": "signal-drift",
-      "event": "A named span, attribute, structured field, log template, metric, or its production condition changes.",
-      "effect": "needs_revalidation"
-    },
-    {
-      "kind": "scope-change",
-      "event": "The dispatch, update, queue, listener, or engine-handoff service boundary changes.",
-      "effect": "needs_revalidation"
-    }
-  ]
-}