@fx-data/ai-diagnostics 0.1.20261026070913 → 0.1.20261107142011

package/content/knowledge/update/diagnostic/observability/lookups/analysis-update-init-recovery.json

@@ -1,93 +0,0 @@
-{
-  "lookup_id": "analysis-update-init-recovery",
-  "logical_event": "waiting-child-recovered",
-  "lifecycle_stage": "control",
-  "graph_kind": "execution",
-  "signal_status": "source-confirmed",
-  "signals": {
-    "span_names": [],
-    "attribute_keys": [],
-    "structured_fields": [],
-    "log_signatures": [
-      "send nodeTaskId {} , executeId {}"
-    ],
-    "metric_names": []
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "DispatchInspectInit emits this template after a prior-day INIT detail evaluates READY, is sent, and has its send flag changed to SENT.",
-  "correlations": [
-    {
-      "edge_id": "edge-init-recovery-to-publication",
-      "from_unit": "requeue",
-      "to_unit": "queue-publication",
-      "correlation_keys": [
-        "execution detail ID"
-      ],
-      "semantics": "INIT inspection updates the same detail to READY and publishes it when current ancestors no longer block it.",
-      "asynchronous": true,
-      "correlation_status": "source-confirmed-durable",
-      "durability": "frontier-lifetime",
-      "coverage_limit": "This recovery re-evaluates current dependencies, not the original historical graph snapshot."
-    }
-  ],
-  "counting_unit": "requeue",
-  "input_units": [
-    "execution-detail"
-  ],
-  "output_units": [
-    "queue-publication"
-  ],
-  "state_owner": "INIT inspector, child evaluator, and execution-detail repository.",
-  "reads": [
-    "eligible historical INIT details",
-    "current ancestor relations and current-chain unfinished details"
-  ],
-  "writes": [
-    "detail status READY",
-    "node-task publication and send flag SENT"
-  ],
-  "success_condition": "A previously waiting child is currently dependency-ready and is republished.",
-  "failure_recovery": [
-    {
-      "branch": "ancestors still block the child",
-      "outcome": "The detail remains INIT.",
-      "recovery": "A later lifecycle run may re-evaluate it."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed",
-  "edge_refs": [
-    "edge-init-recovery-to-publication"
-  ],
-  "field_presence_preflight": [
-    {
-      "field": "send nodeTaskId {} , executeId {}",
-      "signal_type": "log-signature",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    }
-  ],
-  "coverage_limits": [
-    "The current lifecycle invokes this inspector during startup cleanup; no durable attempt history is created.",
-    "This signal is distinguished from ordinary after-commit publication by its exact source anchor, not by similar text or timing.",
-    "The recovery has no independent ID and only covers the enabled INIT inspector path."
-  ],
-  "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-intent-accepted.json

@@ -1,151 +0,0 @@
-{
-  "lookup_id": "analysis-update-intent-accepted",
-  "logical_event": "update-intent-accepted",
-  "lifecycle_stage": "entry",
-  "graph_kind": "logical",
-  "signal_status": "source-confirmed",
-  "signals": {
-    "span_names": [
-      "dispatch_submit"
-    ],
-    "attribute_keys": [
-      "dagId",
-      "totalSize",
-      "updateScene"
-    ],
-    "structured_fields": [],
-    "log_signatures": [
-      "dispatch receive request, chainId {},  root size {},",
-      "submit root task success, chain {} root size {}, cost {}"
-    ],
-    "metric_names": []
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "The dispatch handler emits the receive template when it enters an accepted DispatchRequest; the span attributes and success template are produced only when the handler reaches normal completion.",
-  "correlations": [
-    {
-      "edge_id": "edge-request-to-candidate-root",
-      "from_unit": "update-request",
-      "to_unit": "candidate-root",
-      "correlation_keys": [
-        "in-process request object and candidate collection"
-      ],
-      "semantics": "The producer invocation supplies the candidate table set evaluated by the entry.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process",
-      "durability": "not-durable",
-      "coverage_limit": "There is no dedicated request ID."
-    },
-    {
-      "edge_id": "edge-effective-root-to-chain",
-      "from_unit": "effective-root",
-      "to_unit": "update-chain",
-      "correlation_keys": [
-        "update chain ID",
-        "table ID"
-      ],
-      "semantics": "The selected roots are accepted under the chain ID already present in the serialized context.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-durable",
-      "durability": "frontier-lifetime",
-      "coverage_limit": "A returned chain can exist without any detail when no effective root is persisted."
-    }
-  ],
-  "counting_unit": "update-request",
-  "input_units": [
-    "producer-invocation",
-    "candidate-root"
-  ],
-  "output_units": [
-    "update-chain",
-    "candidate-root"
-  ],
-  "state_owner": "The business producer and the newly created node-task context until dispatch persistence begins.",
-  "reads": [
-    "producer-supplied table candidates",
-    "tenant, scene, submitter, trigger, execution mode, and listener selection"
-  ],
-  "writes": [
-    "new chain context with chain ID and submit time"
-  ],
-  "success_condition": "The entry creates a valid context and invokes dispatch, or explicitly returns without dispatch for an empty entry contract.",
-  "failure_recovery": [
-    {
-      "branch": "entry rejects empty input",
-      "outcome": "No dispatch call and no chain for entry variants that check emptiness first.",
-      "recovery": "Caller decides whether to submit a later request."
-    },
-    {
-      "branch": "dispatch receives an empty root set",
-      "outcome": "A chain ID may still be returned, but no execution detail is created.",
-      "recovery": "No automatic work is created."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed",
-  "edge_refs": [
-    "edge-request-to-candidate-root",
-    "edge-effective-root-to-chain"
-  ],
-  "field_presence_preflight": [
-    {
-      "field": "dispatch_submit",
-      "signal_type": "span-name",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "dagId",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "totalSize",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "updateScene",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "dispatch receive request, chainId {},  root size {},",
-      "signal_type": "log-signature",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "submit root task success, chain {} root size {}, cost {}",
-      "signal_type": "log-signature",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    }
-  ],
-  "coverage_limits": [
-    "The dispatch contract has no dedicated request ID, so historical request identity remains unavailable.",
-    "The receive template has no request ID; chainId identifies the created chain, not a producer request.",
-    "The completion attributes cannot represent entry failures that occur before recordTraceInfo."
-  ],
-  "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-listener-derived-chain.json

@@ -1,112 +0,0 @@
-{
-  "lookup_id": "analysis-update-listener-derived-chain",
-  "logical_event": "listener-derived-chain-created",
-  "lifecycle_stage": "listener",
-  "graph_kind": "side-effect",
-  "signal_status": "source-confirmed",
-  "signals": {
-    "span_names": [],
-    "attribute_keys": [
-      "authChangeDagId",
-      "authChangeRootCount"
-    ],
-    "structured_fields": [],
-    "log_signatures": [
-      "update corp success , update {}"
-    ],
-    "metric_names": []
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "CorpSettingListener emits the success template and writes the derived AUTH_CHANGE chain ID and root count on the current source update span after Dispatchers.dispatchInOneChain returns.",
-  "correlations": [
-    {
-      "edge_id": "edge-listener-to-derived-chain",
-      "from_unit": "listener-invocation",
-      "to_unit": "update-chain",
-      "correlation_keys": [
-        "source chain ID in listener call scope",
-        "listener identity",
-        "derived chain ID returned by dispatch"
-      ],
-      "semantics": "A confirmed listener success branch explicitly submits derived roots and receives a distinct derived chain ID.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process-durable-gap",
-      "durability": "source-chain-not-stored-in-derived-context",
-      "coverage_limit": "Later durable evidence cannot join the two chains unless Phase 3 finds an explicit retained correlation field.",
-      "callback_phases": [
-        "onSuccess"
-      ]
-    }
-  ],
-  "counting_unit": "update-chain",
-  "input_units": [
-    "listener-invocation",
-    "node-primary-result"
-  ],
-  "output_units": [
-    "update-chain"
-  ],
-  "state_owner": "The source listener until the derived dispatch creates its own chain context.",
-  "reads": [
-    "source node result and listener-specific derived candidate roots"
-  ],
-  "writes": [
-    "new derived update chain with a distinct chain ID"
-  ],
-  "success_condition": "The listener explicitly invokes dispatch and receives a new chain ID for derived work.",
-  "failure_recovery": [
-    {
-      "branch": "derived dispatch fails",
-      "outcome": "The listener logs its own failure while the source node primary result remains successful.",
-      "recovery": "No automatic parent-node rollback is claimed."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed",
-  "edge_refs": [
-    "edge-listener-to-derived-chain"
-  ],
-  "field_presence_preflight": [
-    {
-      "field": "authChangeDagId",
-      "signal_type": "attribute",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "authChangeRootCount",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "update corp success , update {}",
-      "signal_type": "log-signature",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    }
-  ],
-  "coverage_limits": [
-    "The derived context does not persist the source chain ID, so a durable source-listener-derived-chain join is missing.",
-    "This covers the confirmed CorpSettingListener-derived AUTH_CHANGE chain, not every listener type.",
-    "The derived context does not durably persist source chain ID or listener invocation ID; only the in-process call proves the edge."
-  ],
-  "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-listener-invocation.json

@@ -1,154 +0,0 @@
-{
-  "lookup_id": "analysis-update-listener-invocation",
-  "logical_event": "node-listener-invoked",
-  "lifecycle_stage": "listener",
-  "graph_kind": "side-effect",
-  "signal_status": "missing",
-  "signals": {
-    "span_names": [],
-    "attribute_keys": [],
-    "structured_fields": [],
-    "log_signatures": [],
-    "metric_names": []
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "triggerListener creates a dynamically named span from a prefix plus listener.name(), but the frozen source exposes no stable exact span name or structured callback-phase field.",
-  "correlations": [
-    {
-      "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"
-      ]
-    },
-    {
-      "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"
-      ]
-    },
-    {
-      "edge_id": "edge-listener-complete-to-child-release",
-      "from_unit": "listener-invocation",
-      "to_unit": "execution-detail",
-      "correlation_keys": [
-        "update chain or merged-chain context",
-        "node table ID",
-        "final onComplete listener invocation in the ordered same-call sequence"
-      ],
-      "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.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process-conditional",
-      "durability": "execution-scope",
-      "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.",
-      "callback_phases": [
-        "onComplete"
-      ]
-    },
-    {
-      "edge_id": "edge-listener-to-derived-chain",
-      "from_unit": "listener-invocation",
-      "to_unit": "update-chain",
-      "correlation_keys": [
-        "source chain ID in listener call scope",
-        "listener identity",
-        "derived chain ID returned by dispatch"
-      ],
-      "semantics": "A confirmed listener success branch explicitly submits derived roots and receives a distinct derived chain ID.",
-      "asynchronous": false,
-      "correlation_status": "source-confirmed-in-process-durable-gap",
-      "durability": "source-chain-not-stored-in-derived-context",
-      "coverage_limit": "Later durable evidence cannot join the two chains unless Phase 3 finds an explicit retained correlation field.",
-      "callback_phases": [
-        "onSuccess"
-      ]
-    }
-  ],
-  "counting_unit": "listener-invocation",
-  "input_units": [
-    "update-chain",
-    "dag-node",
-    "optional-node-primary-result"
-  ],
-  "output_units": [
-    "listener-invocation"
-  ],
-  "state_owner": "The ordered listener set reconstructed from serialized listener names.",
-  "reads": [
-    "chain ID, node, optional primary result according to callback phase, current metadata, and listener-specific context"
-  ],
-  "writes": [
-    "listener-specific status, metadata, metrics, notifications, workflow effects, cleanup, or derived work"
-  ],
-  "success_condition": "Each selected named listener is invoked independently for the applicable callback phase: onBefore precedes node work; on an ordinary success or failure path, onSuccess or onFail and onComplete observe the resulting node state before child callback; StopWork still reaches finally/onComplete before rethrow but skips child callback.",
-  "failure_recovery": [
-    {
-      "branch": "one listener throws",
-      "outcome": "The dispatch handler logs the listener failure and continues to the next listener.",
-      "recovery": "The primary node result is unchanged; listener-specific repair remains separate."
-    },
-    {
-      "branch": "onComplete is invoked",
-      "outcome": "It records completion of one node callback sequence, not the whole update chain.",
-      "recovery": "Chain completion must not be inferred from this callback."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed-with-enabled-test",
-  "edge_refs": [
-    "edge-effective-execution-to-listener-before",
-    "edge-primary-result-to-listener",
-    "edge-listener-complete-to-child-release",
-    "edge-listener-to-derived-chain"
-  ],
-  "field_presence_preflight": [],
-  "coverage_limits": [
-    "No native listener invocation ID is created, and listeners may have their own asynchronous boundaries.",
-    "Listener name alone does not distinguish onStart, onBefore, onSuccess, onFail, and onComplete, and no invocation ID exists.",
-    "Listener-specific application logs are neither complete nor a safe substitute for a generic invocation signal.",
-    "WorkFlowListener skips ACTIVE/GLOBAL. On other eligible successful base updates it selects enabled valid independent workflows from WorkflowDomainRepo and enabled legacy workflows from their own container, requiring BASE_TABLE_UPDATE and an existing base. A workflow-start log alone does not prove any workflow passed these gates."
-  ],
-  "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-load-decision.json

@@ -1,155 +0,0 @@
-{
-  "lookup_id": "analysis-update-load-decision",
-  "logical_event": "node-load-decided",
-  "lifecycle_stage": "load",
-  "graph_kind": "execution",
-  "signal_status": "source-confirmed",
-  "signals": {
-    "span_names": [],
-    "attribute_keys": [
-      "active",
-      "loadData",
-      "skip",
-      "dataModify"
-    ],
-    "structured_fields": [],
-    "log_signatures": [],
-    "metric_names": []
-  },
-  "service_scope": [
-    "main-server"
-  ],
-  "produced_when": "UpdateMetricListener decorates the scoped update span during onComplete with active and loadData and, when WriterMetricInfo exists, skip and dataModify.",
-  "correlations": [
-    {
-      "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-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-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."
-    }
-  ],
-  "counting_unit": "load-decision",
-  "input_units": [
-    "dag-node",
-    "merge-decision"
-  ],
-  "output_units": [
-    "load-decision"
-  ],
-  "state_owner": "The current FlowTask and type-specific table update manager.",
-  "reads": [
-    "current entry and asset metadata",
-    "parent failure status",
-    "execution mode, active state, physical availability, grammar and pre-load checks",
-    "type-specific needLoad decision"
-  ],
-  "writes": [
-    "in-memory node status and writer result for pass-through, inactive, no-load, skip, or load"
-  ],
-  "success_condition": "The node selects exactly one primary branch without treating no-load or skip as an engine task.",
-  "failure_recovery": [
-    {
-      "branch": "a parent in the merged chain set failed",
-      "outcome": "The node fails fast and creates no load operation.",
-      "recovery": "Failure is propagated as a node result; child handling remains separate."
-    },
-    {
-      "branch": "pass-through, inactive, mirror reuse, physical availability, or needLoad=false suppresses a write",
-      "outcome": "The node may succeed with a no-load or reused result and no engine task ID.",
-      "recovery": "Listeners receive the primary node result, not a synthetic load success."
-    },
-    {
-      "branch": "pre-load or grammar validation fails",
-      "outcome": "The node records a business failure before physical load.",
-      "recovery": "No generic dispatch retry is claimed."
-    }
-  ],
-  "source_evidence_grade": "source-confirmed",
-  "edge_refs": [
-    "edge-merge-to-load-decision",
-    "edge-load-decision-to-load-operation",
-    "edge-no-load-to-primary-result"
-  ],
-  "field_presence_preflight": [
-    {
-      "field": "active",
-      "signal_type": "attribute",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "loadData",
-      "signal_type": "attribute",
-      "required": true,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "skip",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    },
-    {
-      "field": "dataModify",
-      "signal_type": "attribute",
-      "required": false,
-      "failure_effect": "needs_revalidation"
-    }
-  ],
-  "coverage_limits": [
-    "A successful load decision is not proof that physical data changed.",
-    "These are retrospective result attributes, not a signal at decision time; skip and dataModify are conditionally absent.",
-    "The fields do not distinguish manager needLoad=false from every no-engine path, and pass-through sets loadData despite making no physical load call."
-  ],
-  "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"
-    }
-  ]
-}