@fx-data/ai-diagnostics 0.1.20261026070913 → 0.1.20261107142011

package/content/knowledge/update/diagnostic/observability/edges/edge-effective-root-to-chain.json

@@ -1,17 +0,0 @@
-{
-  "edge_id": "edge-effective-root-to-chain",
-  "graph_kind": "logical-to-execution",
-  "from_lookup_id": "analysis-update-effective-root-selection",
-  "to_lookup_id": "analysis-update-execution-frontier-persisted",
-  "from_unit": "effective-root",
-  "to_unit": "update-chain",
-  "semantics": "The selected roots are accepted under the chain ID already present in the serialized context.",
-  "correlation_keys": [
-    "update chain ID",
-    "table ID"
-  ],
-  "correlation_status": "source-confirmed-durable",
-  "durability": "frontier-lifetime",
-  "asynchronous": false,
-  "coverage_limit": "A returned chain can exist without any detail when no effective root is persisted."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-engine-task-to-primary-result.json

@@ -1,17 +0,0 @@
-{
-  "edge_id": "edge-engine-task-to-primary-result",
-  "graph_kind": "boundary-to-execution",
-  "from_lookup_id": "analysis-update-engine-handoff",
-  "to_lookup_id": "analysis-update-primary-node-result",
-  "from_unit": "engine-task",
-  "to_unit": "node-primary-result",
-  "semantics": "The final returned writer result or engine failure contributes to the server node primary result.",
-  "correlation_keys": [
-    "engine task ID when returned",
-    "server execution scope"
-  ],
-  "correlation_status": "source-confirmed-conditional",
-  "durability": "result-dependent",
-  "asynchronous": false,
-  "coverage_limit": "A missing returned task ID cannot be replaced by table or time proximity."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-execution-detail-to-publication.json

@@ -1,16 +0,0 @@
-{
-  "edge_id": "edge-execution-detail-to-publication",
-  "graph_kind": "execution",
-  "from_lookup_id": "analysis-update-execution-frontier-persisted",
-  "to_lookup_id": "analysis-update-after-commit-delivery",
-  "from_unit": "execution-detail",
-  "to_unit": "queue-publication",
-  "semantics": "A message containing the detail ID, node ID, and context is published after detail visibility.",
-  "correlation_keys": [
-    "execution detail ID"
-  ],
-  "correlation_status": "source-confirmed-payload",
-  "durability": "detail-and-message-lifetime",
-  "asynchronous": true,
-  "coverage_limit": "No separate publication ID is created."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-init-recovery-to-publication.json

@@ -1,16 +0,0 @@
-{
-  "edge_id": "edge-init-recovery-to-publication",
-  "graph_kind": "execution",
-  "from_lookup_id": "analysis-update-init-recovery",
-  "to_lookup_id": "analysis-update-after-commit-delivery",
-  "from_unit": "requeue",
-  "to_unit": "queue-publication",
-  "semantics": "INIT inspection updates the same detail to READY and publishes it when current ancestors no longer block it.",
-  "correlation_keys": [
-    "execution detail ID"
-  ],
-  "correlation_status": "source-confirmed-durable",
-  "durability": "frontier-lifetime",
-  "asynchronous": true,
-  "coverage_limit": "This recovery re-evaluates current dependencies, not the original historical graph snapshot."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-listener-complete-to-child-release.json

@@ -1,21 +0,0 @@
-{
-  "edge_id": "edge-listener-complete-to-child-release",
-  "graph_kind": "side-effect-to-execution",
-  "from_lookup_id": "analysis-update-listener-invocation",
-  "to_lookup_id": "analysis-update-child-release",
-  "from_unit": "listener-invocation",
-  "to_unit": "execution-detail",
-  "callback_phases": [
-    "onComplete"
-  ],
-  "semantics": "When nodeTaskExec returns normally after ordinary success or failure, the ordered onComplete invocation set has returned or isolated its exceptions before callbackChildren begins; when the set is non-empty, this edge is anchored by its final completed onComplete invocation rather than every invocation.",
-  "correlation_keys": [
-    "update chain or merged-chain context",
-    "node table ID",
-    "final onComplete listener invocation in the ordered same-call sequence"
-  ],
-  "correlation_status": "source-confirmed-in-process-conditional",
-  "durability": "execution-scope",
-  "asynchronous": false,
-  "coverage_limit": "StopWork is rethrown after the finally callback and skips child callback; an empty listener set has no listener invocation, and earlier onComplete invocations are followed by later listeners, so the coarse primary-result-to-child edge remains necessary."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-listener-to-derived-chain.json

@@ -1,21 +0,0 @@
-{
-  "edge_id": "edge-listener-to-derived-chain",
-  "graph_kind": "side-effect-to-logical",
-  "from_lookup_id": "analysis-update-listener-invocation",
-  "to_lookup_id": "analysis-update-listener-derived-chain",
-  "from_unit": "listener-invocation",
-  "to_unit": "update-chain",
-  "callback_phases": [
-    "onSuccess"
-  ],
-  "semantics": "A confirmed listener success branch explicitly submits derived roots and receives a distinct derived chain ID.",
-  "correlation_keys": [
-    "source chain ID in listener call scope",
-    "listener identity",
-    "derived chain ID returned by dispatch"
-  ],
-  "correlation_status": "source-confirmed-in-process-durable-gap",
-  "durability": "source-chain-not-stored-in-derived-context",
-  "asynchronous": false,
-  "coverage_limit": "Later durable evidence cannot join the two chains unless Phase 3 finds an explicit retained correlation field."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-load-decision-to-load-operation.json

@@ -1,16 +0,0 @@
-{
-  "edge_id": "edge-load-decision-to-load-operation",
-  "graph_kind": "execution",
-  "from_lookup_id": "analysis-update-load-decision",
-  "to_lookup_id": "analysis-update-load-operation",
-  "from_unit": "load-decision",
-  "to_unit": "load-operation",
-  "semantics": "Only the branch that passes activity, availability, execution-mode, and type-specific load gates invokes the manager load.",
-  "correlation_keys": [
-    "node object within the same execution scope"
-  ],
-  "correlation_status": "source-confirmed-in-process",
-  "durability": "execution-scope",
-  "asynchronous": false,
-  "coverage_limit": "There is no native load-operation ID."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-load-operation-to-engine-task.json

@@ -1,17 +0,0 @@
-{
-  "edge_id": "edge-load-operation-to-engine-task",
-  "graph_kind": "boundary",
-  "from_lookup_id": "analysis-update-load-operation",
-  "to_lookup_id": "analysis-update-engine-handoff",
-  "from_unit": "load-operation",
-  "to_unit": "engine-task",
-  "semantics": "A load operation creates an engine task only when it enters a Polars write executor.",
-  "correlation_keys": [
-    "server call scope",
-    "engine task ID returned in writer metric on success"
-  ],
-  "correlation_status": "source-confirmed-conditional",
-  "durability": "result-dependent",
-  "asynchronous": false,
-  "coverage_limit": "Failed and retried engine attempts are not fully exposed as a server-side durable lineage."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-lock-requeue-to-attempt.json

@@ -1,16 +0,0 @@
-{
-  "edge_id": "edge-lock-requeue-to-attempt",
-  "graph_kind": "execution",
-  "from_lookup_id": "analysis-update-lock-requeued",
-  "to_lookup_id": "analysis-update-attempt-consumed",
-  "from_unit": "requeue",
-  "to_unit": "execution-attempt",
-  "semantics": "The republished detail may create a later main-consumer attempt.",
-  "correlation_keys": [
-    "execution detail ID"
-  ],
-  "correlation_status": "source-confirmed-payload",
-  "durability": "message-lifetime",
-  "asynchronous": true,
-  "coverage_limit": "Repeated delivery count is not persisted."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-logical-parent-to-child.json

@@ -1,18 +0,0 @@
-{
-  "edge_id": "edge-logical-parent-to-child",
-  "graph_kind": "logical",
-  "from_lookup_id": "analysis-update-logical-dependency-expansion",
-  "to_lookup_id": "analysis-update-child-release",
-  "from_unit": "dag-node",
-  "to_unit": "dag-node",
-  "semantics": "A current dependency-provider relation allows a parent result to gate and eventually release a child.",
-  "correlation_keys": [
-    "parent table ID",
-    "child table ID",
-    "chain or merged-chain scope"
-  ],
-  "correlation_status": "source-confirmed-logical",
-  "durability": "not-snapshotted",
-  "asynchronous": false,
-  "coverage_limit": "Later current lineage cannot prove the earlier historical edge."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-merge-member-to-effective-execution.json

@@ -1,18 +0,0 @@
-{
-  "edge_id": "edge-merge-member-to-effective-execution",
-  "graph_kind": "execution",
-  "from_lookup_id": "analysis-update-merge-decision",
-  "to_lookup_id": "analysis-update-load-decision",
-  "from_unit": "execution-detail",
-  "to_unit": "dag-node",
-  "semantics": "Multiple eligible details and chain contexts may converge on one selected node task and one primary result.",
-  "correlation_keys": [
-    "merged execution detail IDs",
-    "merged chain IDs",
-    "node table ID"
-  ],
-  "correlation_status": "source-confirmed-in-process",
-  "durability": "execution-scope",
-  "asynchronous": false,
-  "coverage_limit": "Merge membership does not establish a one-to-one load or engine-task relation."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-merge-to-load-decision.json

@@ -1,17 +0,0 @@
-{
-  "edge_id": "edge-merge-to-load-decision",
-  "graph_kind": "execution",
-  "from_lookup_id": "analysis-update-merge-decision",
-  "to_lookup_id": "analysis-update-load-decision",
-  "from_unit": "merge-decision",
-  "to_unit": "load-decision",
-  "semantics": "The selected merged node and context enter parent gating and load decision once.",
-  "correlation_keys": [
-    "node table ID",
-    "merged chain IDs"
-  ],
-  "correlation_status": "source-confirmed-in-process",
-  "durability": "execution-scope",
-  "asynchronous": false,
-  "coverage_limit": "The load decision has no independent ID."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-no-load-to-primary-result.json

@@ -1,16 +0,0 @@
-{
-  "edge_id": "edge-no-load-to-primary-result",
-  "graph_kind": "execution",
-  "from_lookup_id": "analysis-update-load-decision",
-  "to_lookup_id": "analysis-update-primary-node-result",
-  "from_unit": "load-decision",
-  "to_unit": "node-primary-result",
-  "semantics": "Pass-through, inactive, no-load, skip, or pre-load failure produces a primary node result without requiring an engine task.",
-  "correlation_keys": [
-    "node object within the same execution scope"
-  ],
-  "correlation_status": "source-confirmed-in-process",
-  "durability": "execution-scope",
-  "asynchronous": false,
-  "coverage_limit": "Node success on this edge must not be counted as a physical load."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-primary-result-to-child-frontier.json

@@ -1,18 +0,0 @@
-{
-  "edge_id": "edge-primary-result-to-child-frontier",
-  "graph_kind": "execution",
-  "from_lookup_id": "analysis-update-primary-node-result",
-  "to_lookup_id": "analysis-update-child-release",
-  "from_unit": "node-primary-result",
-  "to_unit": "execution-detail",
-  "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.",
-  "correlation_keys": [
-    "parent node table ID",
-    "child node table ID",
-    "chain or merged-chain context"
-  ],
-  "correlation_status": "source-confirmed-ordered-coarse",
-  "durability": "frontier-lifetime",
-  "asynchronous": false,
-  "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."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-primary-result-to-listener.json

@@ -1,23 +0,0 @@
-{
-  "edge_id": "edge-primary-result-to-listener",
-  "graph_kind": "side-effect",
-  "from_lookup_id": "analysis-update-primary-node-result",
-  "to_lookup_id": "analysis-update-listener-invocation",
-  "from_unit": "node-primary-result",
-  "to_unit": "listener-invocation",
-  "callback_phases": [
-    "onSuccess",
-    "onFail",
-    "onComplete"
-  ],
-  "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.",
-  "correlation_keys": [
-    "update chain ID",
-    "node table ID",
-    "listener name and callback phase"
-  ],
-  "correlation_status": "source-confirmed-in-process",
-  "durability": "listener-specific",
-  "asynchronous": false,
-  "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."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-publication-to-attempt.json

@@ -1,16 +0,0 @@
-{
-  "edge_id": "edge-publication-to-attempt",
-  "graph_kind": "execution",
-  "from_lookup_id": "analysis-update-after-commit-delivery",
-  "to_lookup_id": "analysis-update-attempt-consumed",
-  "from_unit": "queue-publication",
-  "to_unit": "execution-attempt",
-  "semantics": "A main-queue delivery starts one consumer attempt for the payload detail.",
-  "correlation_keys": [
-    "execution detail ID"
-  ],
-  "correlation_status": "source-confirmed-payload",
-  "durability": "message-lifetime",
-  "asynchronous": true,
-  "coverage_limit": "The detail ID cannot distinguish repeated deliveries or attempt numbers."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-ready-recovery-to-publication.json

@@ -1,16 +0,0 @@
-{
-  "edge_id": "edge-ready-recovery-to-publication",
-  "graph_kind": "execution",
-  "from_lookup_id": "analysis-update-ready-recovery",
-  "to_lookup_id": "analysis-update-after-commit-delivery",
-  "from_unit": "requeue",
-  "to_unit": "queue-publication",
-  "semantics": "Ready inspection republishes a still-PENDING_SENT root detail under its existing detail ID.",
-  "correlation_keys": [
-    "execution detail ID"
-  ],
-  "correlation_status": "source-confirmed-durable",
-  "durability": "frontier-lifetime",
-  "asynchronous": true,
-  "coverage_limit": "The edge does not apply to SENT child details."
-}

package/content/knowledge/update/diagnostic/observability/edges/edge-request-to-candidate-root.json

@@ -1,16 +0,0 @@
-{
-  "edge_id": "edge-request-to-candidate-root",
-  "graph_kind": "logical",
-  "from_lookup_id": "analysis-update-intent-accepted",
-  "to_lookup_id": "analysis-update-candidate-root-filter",
-  "from_unit": "update-request",
-  "to_unit": "candidate-root",
-  "semantics": "The producer invocation supplies the candidate table set evaluated by the entry.",
-  "correlation_keys": [
-    "in-process request object and candidate collection"
-  ],
-  "correlation_status": "source-confirmed-in-process",
-  "durability": "not-durable",
-  "asynchronous": false,
-  "coverage_limit": "There is no dedicated request ID."
-}

package/content/knowledge/update/diagnostic/observability/identity-units/candidate-root.json

@@ -1,13 +0,0 @@
-{
-  "unit": "candidate-root",
-  "native_id_status": "available-with-request-scope",
-  "native_id_fields": [
-    "table-id"
-  ],
-  "scope": "One input table candidate inside one update request before entry and dependency filtering.",
-  "counting_rule": "Count table candidates per request before any removal or fallback.",
-  "must_not_use_as_id": [
-    "effective-root-count",
-    "logical-dag-node-count"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/dag-node.json

@@ -1,14 +0,0 @@
-{
-  "unit": "dag-node",
-  "native_id_status": "available-with-chain-or-merge-scope",
-  "native_id_fields": [
-    "table-id",
-    "update-chain-id-or-merge-chain-set"
-  ],
-  "scope": "One logical table node in a chain or merged-chain execution scope.",
-  "counting_rule": "Count distinct logical table nodes separately from frontier rows and attempts.",
-  "must_not_use_as_id": [
-    "execution-detail-id",
-    "engine-task-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/effective-root.json

@@ -1,14 +0,0 @@
-{
-  "unit": "effective-root",
-  "native_id_status": "available-with-chain-scope",
-  "native_id_fields": [
-    "update-chain-id",
-    "table-id"
-  ],
-  "scope": "One dependency-minimal root selected for one accepted chain.",
-  "counting_rule": "Count selected roots after entry filtering and dependency root reduction.",
-  "must_not_use_as_id": [
-    "candidate-root-count",
-    "execution-detail-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/engine-task.json

@@ -1,13 +0,0 @@
-{
-  "unit": "engine-task",
-  "native_id_status": "conditional",
-  "native_id_fields": [
-    "engine-task-id"
-  ],
-  "scope": "One Polars write task created by one engine-executor attempt.",
-  "counting_rule": "Count distinct engine task IDs only when the server creates a Polars write task; no-load results have no engine task.",
-  "must_not_use_as_id": [
-    "load-operation-id",
-    "execution-detail-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/execution-attempt.json

@@ -1,12 +0,0 @@
-{
-  "unit": "execution-attempt",
-  "native_id_status": "missing",
-  "native_id_fields": [],
-  "scope": "One main node-task consumer delivery handled for an execution detail.",
-  "counting_rule": "Count main-consumer deliveries; repeated deliveries of one detail are later attempts, not new details.",
-  "must_not_use_as_id": [
-    "execution-detail-id",
-    "update-chain-id",
-    "node-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/execution-detail.json

@@ -1,13 +0,0 @@
-{
-  "unit": "execution-detail",
-  "native_id_status": "available-and-transient",
-  "native_id_fields": [
-    "execution-detail-id"
-  ],
-  "scope": "One persisted frontier row for one node and chain context.",
-  "counting_rule": "Count created detail rows; deletion after progression means this is not a durable history count.",
-  "must_not_use_as_id": [
-    "execution-attempt-id",
-    "load-operation-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/listener-invocation.json

@@ -1,11 +0,0 @@
-{
-  "unit": "listener-invocation",
-  "native_id_status": "missing",
-  "native_id_fields": [],
-  "scope": "One named listener callback phase for one node result in one chain scope.",
-  "counting_rule": "Count listener name and callback phase per node result; onComplete is node completion, not chain completion.",
-  "must_not_use_as_id": [
-    "update-chain-id",
-    "dag-node-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/load-decision.json

@@ -1,12 +0,0 @@
-{
-  "unit": "load-decision",
-  "native_id_status": "missing",
-  "native_id_fields": [],
-  "scope": "One effective node execution choosing failure, pass-through, skip, reuse, no-load, or a server load call.",
-  "counting_rule": "Count one decision per effective merged node execution before counting any optional physical work.",
-  "must_not_use_as_id": [
-    "execution-attempt-id",
-    "load-operation-id",
-    "engine-task-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/load-operation.json

@@ -1,11 +0,0 @@
-{
-  "unit": "load-operation",
-  "native_id_status": "missing",
-  "native_id_fields": [],
-  "scope": "One server call that enters a table update manager load after load gates select physical work.",
-  "counting_rule": "Count attempted load calls, including failed calls; exclude pass-through, inactive, and needLoad=false results.",
-  "must_not_use_as_id": [
-    "dag-node-id",
-    "engine-task-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/logical-dag-edge.json

@@ -1,11 +0,0 @@
-{
-  "unit": "logical-dag-edge",
-  "native_id_status": "missing",
-  "native_id_fields": [],
-  "scope": "One current parent-to-child dependency relation evaluated inside one chain or merged-chain scheduling scope.",
-  "counting_rule": "Count parent and child table pairs per evaluation scope and dependency-provider result; do not treat a later read as the historical edge set.",
-  "must_not_use_as_id": [
-    "parent-table-id-and-child-table-id-without-chain-scope",
-    "execution-detail-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/merge-decision.json

@@ -1,12 +0,0 @@
-{
-  "unit": "merge-decision",
-  "native_id_status": "missing",
-  "native_id_fields": [],
-  "scope": "One same-node merge evaluation performed after a main attempt obtains the node lock.",
-  "counting_rule": "Count the decision once whether it selects no member, one member, or several chain and detail members.",
-  "must_not_use_as_id": [
-    "update-chain-id",
-    "execution-detail-id",
-    "load-operation-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/node-primary-result.json

@@ -1,12 +0,0 @@
-{
-  "unit": "node-primary-result",
-  "native_id_status": "missing",
-  "native_id_fields": [],
-  "scope": "One SUCCESS or FAIL result formed for one effective node execution before child callback.",
-  "counting_rule": "Count one primary result per effective merged node execution and keep it separate from listener callback outcomes and table-oriented latest status.",
-  "must_not_use_as_id": [
-    "update-chain-id",
-    "execution-detail-id",
-    "listener-invocation-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/queue-publication.json

@@ -1,11 +0,0 @@
-{
-  "unit": "queue-publication",
-  "native_id_status": "missing",
-  "native_id_fields": [],
-  "scope": "One producer publication operation for a node-task payload on a logical queue route.",
-  "counting_rule": "Count every root, child, requeue, inspector, or dead-letter republish operation separately from broker deliveries.",
-  "must_not_use_as_id": [
-    "execution-detail-id",
-    "execution-attempt-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/requeue.json

@@ -1,11 +0,0 @@
-{
-  "unit": "requeue",
-  "native_id_status": "missing",
-  "native_id_fields": [],
-  "scope": "One explicit republish or recovery routing operation caused by capacity, lock, ready inspection, INIT recovery, or dead-letter recovery.",
-  "counting_rule": "Count routing operations by branch; do not treat all of them as completed node attempts.",
-  "must_not_use_as_id": [
-    "execution-detail-id",
-    "execution-attempt-count"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/update-chain.json

@@ -1,13 +0,0 @@
-{
-  "unit": "update-chain",
-  "native_id_status": "available",
-  "native_id_fields": [
-    "update-chain-id"
-  ],
-  "scope": "One context-generated chain identity returned by dispatch acceptance.",
-  "counting_rule": "Count distinct chain IDs, including a returned chain that produced no detail when an entry passed an empty effective-root set.",
-  "must_not_use_as_id": [
-    "update-request-id",
-    "execution-attempt-id"
-  ]
-}

package/content/knowledge/update/diagnostic/observability/identity-units/update-request.json

@@ -1,12 +0,0 @@
-{
-  "unit": "update-request",
-  "native_id_status": "missing",
-  "native_id_fields": [],
-  "scope": "One producer invocation that asks the update subsystem to consider candidate roots.",
-  "counting_rule": "Count producer invocations, including invocations that create no execution frontier.",
-  "must_not_use_as_id": [
-    "update-chain-id",
-    "trigger-id",
-    "trace-id"
-  ]
-}