@fx-data/ai-diagnostics 0.1.20261026070913 → 0.1.20261107142011

package/content/knowledge/update/diagnostic/observability/lookups/analysis-update-primary-node-result.json

@@ -1,318 +0,0 @@
-{
-  "lookup_id": "analysis-update-primary-node-result",
-  "logical_event": "primary-node-result-produced",
-  "lifecycle_stage": "consumer",
-  "graph_kind": "execution",
-  "signal_status": "source-confirmed",
-  "signals": {
-    "span_names": [],
-    "attribute_keys": [
-      "dagId",
-      "tableId",
-      "rowCount",
-      "updateType",
-      "requeue",
-      "rootErrorId",
-      "dispatchConsumed",
-      "businessConsumed"
-    ],
-    "structured_fields": [
-      "traceId",
-      "dagId",
-      "tableId",
-      "status",
-      "rows",
-      "actualWrite",
-      "dataModify",
-      "errorMsg",
-      "requeue",
-      "triggerId",
-      "tenantId",
-      "dispatchConsumed",
-      "businessConsumed",
-      "polarsConsumed"
-    ],
-    "log_signatures": [
-      "finish to exec task, nodeTaskId = {}, chainId = {}, cost = {}ms",
-      "task exec error, nodeTaskId {}, chainIds {}, {}"
-    ],
-    "metric_names": [
-      "XS03"
-    ]
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "UpdateMetricListener constructs an XS03 UpdateNodeTaskPoint in onSuccess or ordinary onFail and decorates the update span in onComplete; DispatchTraceContext submits the recorded point only after the main handler returns normally.",
-  "correlations": [
-    {
-      "edge_id": "edge-no-load-to-primary-result",
-      "from_unit": "load-decision",
-      "to_unit": "node-primary-result",
-      "correlation_keys": [
-        "node object within the same execution scope"
-      ],
-      "semantics": "Pass-through, inactive, no-load, skip, or pre-load failure produces a primary node result without requiring an engine task.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process",
-      "durability": "execution-scope",
-      "coverage_limit": "Node success on this edge must not be counted as a physical load."
-    },
-    {
-      "edge_id": "edge-engine-task-to-primary-result",
-      "from_unit": "engine-task",
-      "to_unit": "node-primary-result",
-      "correlation_keys": [
-        "engine task ID when returned",
-        "server execution scope"
-      ],
-      "semantics": "The final returned writer result or engine failure contributes to the server node primary result.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-conditional",
-      "durability": "result-dependent",
-      "coverage_limit": "A missing returned task ID cannot be replaced by table or time proximity."
-    },
-    {
-      "edge_id": "edge-primary-result-to-child-frontier",
-      "from_unit": "node-primary-result",
-      "to_unit": "execution-detail",
-      "correlation_keys": [
-        "parent node table ID",
-        "child node table ID",
-        "chain or merged-chain context"
-      ],
-      "semantics": "On an ordinary path that reaches child callback, a primary node result already exists before current dependency checks create the next child frontier; post-result listener phases intervene, so this is a coarse prerequisite edge rather than direct adjacency.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-ordered-coarse",
-      "durability": "frontier-lifetime",
-      "coverage_limit": "This edge does not bypass or time listener callbacks, does not apply when StopWork is rethrown before child callback, and the new detail is not a persisted copy of the logical edge."
-    },
-    {
-      "edge_id": "edge-primary-result-to-listener",
-      "from_unit": "node-primary-result",
-      "to_unit": "listener-invocation",
-      "correlation_keys": [
-        "update chain ID",
-        "node table ID",
-        "listener name and callback phase"
-      ],
-      "semantics": "After a SUCCESS or FAIL primary node result is formed, each selected named listener receives the applicable onSuccess or onFail phase, followed by onComplete in the finally path, before ordinary child callback.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process",
-      "durability": "listener-specific",
-      "coverage_limit": "This edge excludes onBefore, which has no primary result. On StopWork, onComplete still runs but no confirmed primary-result edge or child-release edge is traversed. There is no native listener invocation ID.",
-      "callback_phases": [
-        "onSuccess",
-        "onFail",
-        "onComplete"
-      ]
-    }
-  ],
-  "counting_unit": "node-primary-result",
-  "input_units": [
-    "dag-node",
-    "load-decision",
-    "optional-load-operation",
-    "optional-engine-task"
-  ],
-  "output_units": [
-    "node-primary-result"
-  ],
-  "state_owner": "The current NodeTask and dispatch execution handler until phase-specific listener callbacks and child release proceed.",
-  "reads": [
-    "node work result",
-    "parent failure status for the merged chain set"
-  ],
-  "writes": [
-    "in-memory SUCCESS or FAIL node result and root errors"
-  ],
-  "success_condition": "The node has one primary result before child release; post-work listener callbacks observe that result, while onBefore remains a separate phase-scoped invocation.",
-  "failure_recovery": [
-    {
-      "branch": "ordinary node work fails",
-      "outcome": "The failure is converted to a primary FAIL result and ordinary business failure is not rethrown to the queue consumer.",
-      "recovery": "Child nodes may fail fast from the recorded parent status."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed-with-enabled-test",
-  "edge_refs": [
-    "edge-no-load-to-primary-result",
-    "edge-engine-task-to-primary-result",
-    "edge-primary-result-to-child-frontier",
-    "edge-primary-result-to-listener"
-  ],
-  "field_presence_preflight": [
-    {
-      "field": "dagId",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "tableId",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "rowCount",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "updateType",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "requeue",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "rootErrorId",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "dispatchConsumed",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "businessConsumed",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "traceId",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "dagId",
-      "signal_type": "structured-field",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "tableId",
-      "signal_type": "structured-field",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "status",
-      "signal_type": "structured-field",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "rows",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "actualWrite",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "dataModify",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "errorMsg",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "requeue",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "triggerId",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "tenantId",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "dispatchConsumed",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "businessConsumed",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "polarsConsumed",
-      "signal_type": "structured-field",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "finish to exec task, nodeTaskId = {}, chainId = {}, cost = {}ms",
-      "signal_type": "log-signature",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "task exec error, nodeTaskId {}, chainIds {}, {}",
-      "signal_type": "log-signature",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "XS03",
-      "signal_type": "metric",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    }
-  ],
-  "coverage_limits": [
-    "Node success does not prove chain completion, physical data change, listener success, or an engine task.",
-    "StopWork is rethrown and bypasses the submitAsync block, so the point is not a complete attempt ledger.",
-    "status distinguishes ordinary SUCCESS and FAIL only; listener outcomes remain separate and runtime ingestion was not verified."
-  ],
-  "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-ready-recovery.json

@@ -1,92 +0,0 @@
-{
-  "lookup_id": "analysis-update-ready-recovery",
-  "logical_event": "pending-publication-recovered",
-  "lifecycle_stage": "queue",
-  "graph_kind": "execution",
-  "signal_status": "source-confirmed",
-  "signals": {
-    "span_names": [],
-    "attribute_keys": [],
-    "structured_fields": [],
-    "log_signatures": [
-      "[inspect ready] send nodeTaskId {} , executeId {}"
-    ],
-    "metric_names": []
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "DispatchInspectReady emits the stable template after a still-READY, PENDING_SENT detail is sent and its send flag is changed to SENT.",
-  "correlations": [
-    {
-      "edge_id": "edge-ready-recovery-to-publication",
-      "from_unit": "requeue",
-      "to_unit": "queue-publication",
-      "correlation_keys": [
-        "execution detail ID"
-      ],
-      "semantics": "Ready inspection republishes a still-PENDING_SENT root detail under its existing detail ID.",
-      "asynchronous": true,
-      "correlation_status": "source-confirmed-durable",
-      "durability": "frontier-lifetime",
-      "coverage_limit": "The edge does not apply to SENT child details."
-    }
-  ],
-  "counting_unit": "requeue",
-  "input_units": [
-    "execution-detail"
-  ],
-  "output_units": [
-    "queue-publication"
-  ],
-  "state_owner": "READY/PENDING_SENT inspector and execution-detail send flag.",
-  "reads": [
-    "READY details with PENDING_SENT",
-    "current detail under the node submit lock"
-  ],
-  "writes": [
-    "recovered node-task publication",
-    "send flag SENT"
-  ],
-  "success_condition": "A still-pending root publication is republished under a submit lock and marked SENT.",
-  "failure_recovery": [
-    {
-      "branch": "detail changed or disappeared before inspection",
-      "outcome": "The inspector skips it.",
-      "recovery": "No stale publication is created."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed",
-  "edge_refs": [
-    "edge-ready-recovery-to-publication"
-  ],
-  "field_presence_preflight": [
-    {
-      "field": "[inspect ready] send nodeTaskId {} , executeId {}",
-      "signal_type": "log-signature",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    }
-  ],
-  "coverage_limits": [
-    "This recovery selects only PENDING_SENT and does not cover child details created as SENT.",
-    "No recovery-publication ID or broker acknowledgement exists; execution-detail ID is the source-confirmed payload key."
-  ],
-  "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/performance-segments/analysis-update-segment-business-attempt.json

@@ -1,33 +0,0 @@
-{
-  "segment_id": "analysis-update-segment-business-attempt",
-  "counting_unit": "execution-attempt",
-  "graph_kind": "execution",
-  "start_boundary": {
-    "lookup_id": "analysis-update-merge-decision",
-    "transition": "effective-node-execution-entered"
-  },
-  "end_boundary": {
-    "lookup_id": "analysis-update-primary-node-result",
-    "transition": "success-or-fail-result-formed"
-  },
-  "includes": [
-    "onBefore listener phase",
-    "parent-failure gate",
-    "load decision and node work when selected"
-  ],
-  "excludes": [
-    "post-result onSuccess or onFail and onComplete listener phases",
-    "child callback"
-  ],
-  "success_and_failure_population": "Include successful, failed, parent-fast-failed, skip, and no-load node results; exclude capacity and lock attempts that never enter node work.",
-  "source_evidence_grade": "source-confirmed-logical-boundary",
-  "signal_status": "source-confirmed",
-  "measurement_signals": [
-    "attribute:businessConsumed",
-    "structured-field:businessConsumed",
-    "correlation:dagId plus tableId within one submitted XS03 point"
-  ],
-  "coverage_limits": [
-    "The current model has no native attempt ID, so the segment requires a future explicit attempt correlation."
-  ]
-}

package/content/knowledge/update/diagnostic/observability/performance-segments/analysis-update-segment-capacity-cycle.json

@@ -1,31 +0,0 @@
-{
-  "segment_id": "analysis-update-segment-capacity-cycle",
-  "counting_unit": "requeue",
-  "graph_kind": "execution",
-  "start_boundary": {
-    "lookup_id": "analysis-update-capacity-deferred",
-    "transition": "same-detail-published-to-slow-route"
-  },
-  "end_boundary": {
-    "lookup_id": "analysis-update-attempt-consumed",
-    "transition": "later-main-consumer-delivery-started"
-  },
-  "includes": [
-    "one or more slow-route capacity checks and republishes"
-  ],
-  "excludes": [
-    "the earlier main attempt",
-    "later lock and business work"
-  ],
-  "success_and_failure_population": "Count capacity routing cycles independently from main-consumer attempts, including cycles that remain open at the observation boundary.",
-  "source_evidence_grade": "source-confirmed-logical-boundary",
-  "signal_status": "source-confirmed",
-  "measurement_signals": [
-    "log:Tenant limit exceeded: tenant {}, nodeTaskId {}, executeId {}",
-    "log:receive executeInfo at slow queue, nodeTaskId = {}, executeId = {}, chainId = {}",
-    "correlation:execution detail ID"
-  ],
-  "coverage_limits": [
-    "The same detail ID is reused and no requeue ordinal is persisted."
-  ]
-}

package/content/knowledge/update/diagnostic/observability/performance-segments/analysis-update-segment-child-release.json

@@ -1,32 +0,0 @@
-{
-  "segment_id": "analysis-update-segment-child-release",
-  "counting_unit": "node-primary-result",
-  "graph_kind": "execution",
-  "start_boundary": {
-    "lookup_id": "analysis-update-child-release",
-    "transition": "child-callback-entered-after-listener-sequence"
-  },
-  "end_boundary": {
-    "lookup_id": "analysis-update-child-release",
-    "transition": "frontier-transaction-and-publication-call-returned-or-failed"
-  },
-  "includes": [
-    "current child and ancestor discovery",
-    "child execution-condition evaluation",
-    "parent detail deletion and child detail creation",
-    "child publication call"
-  ],
-  "excludes": [
-    "post-work listener callbacks that run before child callback",
-    "later child queue wait"
-  ],
-  "success_and_failure_population": "Group one parent result callback by no-child, READY-child, INIT-child, transaction-failure, and publication-failure outcomes.",
-  "source_evidence_grade": "source-confirmed-with-enabled-test",
-  "signal_status": "source-confirmed",
-  "measurement_signals": [
-    "span:dispatch_callback_children"
-  ],
-  "coverage_limits": [
-    "A result may release several child details, and failed SENT child publication lacks the root ready-inspector recovery contract."
-  ]
-}

package/content/knowledge/update/diagnostic/observability/performance-segments/analysis-update-segment-commit-publication.json

@@ -1,29 +0,0 @@
-{
-  "segment_id": "analysis-update-segment-commit-publication",
-  "counting_unit": "queue-publication",
-  "graph_kind": "execution",
-  "start_boundary": {
-    "lookup_id": "analysis-update-execution-frontier-persisted",
-    "transition": "publication-deferred-until-commit-or-immediate-path-selected"
-  },
-  "end_boundary": {
-    "lookup_id": "analysis-update-after-commit-delivery",
-    "transition": "publication-call-returned"
-  },
-  "includes": [
-    "outer transaction commit wait when one is active",
-    "after-commit executor scheduling",
-    "root message publication"
-  ],
-  "excludes": [
-    "broker queue wait",
-    "consumer delivery"
-  ],
-  "success_and_failure_population": "Count each publication operation and keep rejected executor, publish failure, and send-flag update failure as separate outcomes.",
-  "source_evidence_grade": "source-confirmed-with-enabled-test",
-  "signal_status": "missing",
-  "measurement_signals": [],
-  "coverage_limits": [
-    "A detail has no publication ID, and child details do not share the root PENDING_SENT recovery contract."
-  ]
-}

package/content/knowledge/update/diagnostic/observability/performance-segments/analysis-update-segment-control-planning.json

@@ -1,30 +0,0 @@
-{
-  "segment_id": "analysis-update-segment-control-planning",
-  "counting_unit": "update-chain",
-  "graph_kind": "logical-to-execution",
-  "start_boundary": {
-    "lookup_id": "analysis-update-intent-accepted",
-    "transition": "dispatch-entry-invoked"
-  },
-  "end_boundary": {
-    "lookup_id": "analysis-update-execution-frontier-persisted",
-    "transition": "root-detail-transaction-returned"
-  },
-  "includes": [
-    "candidate filtering",
-    "effective-root reduction",
-    "dependency expansion needed for submission",
-    "root frontier persistence"
-  ],
-  "excludes": [
-    "outer transaction commit wait",
-    "queue publication and consumption"
-  ],
-  "success_and_failure_population": "Accepted dispatch entries, including entries that return a chain with no root detail, must be grouped separately by whether a frontier was created.",
-  "source_evidence_grade": "source-confirmed-logical-boundary",
-  "signal_status": "missing",
-  "measurement_signals": [],
-  "coverage_limits": [
-    "No request ID exists, so later measurements cannot reconstruct this population from chain ID alone without a confirmed entry correlation."
-  ]
-}

package/content/knowledge/update/diagnostic/observability/performance-segments/analysis-update-segment-engine-task.json

@@ -1,27 +0,0 @@
-{
-  "segment_id": "analysis-update-segment-engine-task",
-  "counting_unit": "engine-task",
-  "graph_kind": "boundary",
-  "start_boundary": {
-    "lookup_id": "analysis-update-engine-handoff",
-    "transition": "engine-task-id-created"
-  },
-  "end_boundary": {
-    "lookup_id": "analysis-update-engine-handoff",
-    "transition": "engine-transaction-committed-or-rolled-back"
-  },
-  "includes": [
-    "one engine executor attempt and its engine transaction"
-  ],
-  "excludes": [
-    "server load work before task creation",
-    "other engine retry attempts with different task IDs"
-  ],
-  "success_and_failure_population": "Count each created engine task ID independently; one server load can contain multiple segments under retry.",
-  "source_evidence_grade": "source-confirmed-logical-boundary",
-  "signal_status": "missing",
-  "measurement_signals": [],
-  "coverage_limits": [
-    "Only the final successful returned task ID is exposed to the outer writer result; full retry lineage is not durable at the server boundary."
-  ]
-}

package/content/knowledge/update/diagnostic/observability/performance-segments/analysis-update-segment-listener-callback.json

@@ -1,27 +0,0 @@
-{
-  "segment_id": "analysis-update-segment-listener-callback",
-  "counting_unit": "listener-invocation",
-  "graph_kind": "side-effect",
-  "start_boundary": {
-    "lookup_id": "analysis-update-listener-invocation",
-    "transition": "one-named-listener-phase-invoked"
-  },
-  "end_boundary": {
-    "lookup_id": "analysis-update-listener-invocation",
-    "transition": "same-listener-phase-returned-or-isolated"
-  },
-  "includes": [
-    "one onBefore, onSuccess, onFail, or onComplete callback for one listener"
-  ],
-  "excludes": [
-    "other listener names and callback phases",
-    "listener-owned asynchronous work after the call returns"
-  ],
-  "success_and_failure_population": "Count listener name and callback phase separately, including isolated listener exceptions.",
-  "source_evidence_grade": "source-confirmed-with-enabled-test",
-  "signal_status": "missing",
-  "measurement_signals": [],
-  "coverage_limits": [
-    "No listener invocation ID exists, and listener-owned asynchronous completion may require a separate boundary model."
-  ]
-}

package/content/knowledge/update/diagnostic/observability/performance-segments/analysis-update-segment-load-operation.json

@@ -1,27 +0,0 @@
-{
-  "segment_id": "analysis-update-segment-load-operation",
-  "counting_unit": "load-operation",
-  "graph_kind": "execution",
-  "start_boundary": {
-    "lookup_id": "analysis-update-load-operation",
-    "transition": "selected-manager-load-entered"
-  },
-  "end_boundary": {
-    "lookup_id": "analysis-update-load-operation",
-    "transition": "selected-manager-load-returned-or-failed"
-  },
-  "includes": [
-    "server preparation inside the selected load call",
-    "downstream handoff and wait when invoked"
-  ],
-  "excludes": [
-    "pass-through, inactive, physical-reuse, and needLoad=false branches"
-  ],
-  "success_and_failure_population": "Count all entered manager load calls, including failures and results that create no engine task.",
-  "source_evidence_grade": "source-confirmed-logical-boundary",
-  "signal_status": "missing",
-  "measurement_signals": [],
-  "coverage_limits": [
-    "There is no native load-operation ID, and table-type-specific downstream work differs."
-  ]
-}