cxzg007and江俊杰 5d54919804 feat(reasoning): rule-driven actions with provenance (#1096) ...

* feat(reasoning): rule-driven actions with provenance

Add a structured Action layer so matched rules can trigger side effects
instead of only deriving new facts, turning the reasoner into a
production-rule system.

L1 - Action type system:
- Action base class with execute(bindings, reasoner) + ?var substitution
- AssertAction (optional write-back to KnowledgeGraph), RetractAction,
  CallAction (structured replacement for the unused Rule.handler),
  EmitEventAction (delivers to a registered event sink)
- Rule.actions field; wired into Reasoner.forward_chain() and
  ReteEngine.execute_matches() (via optional bind_reasoner)

L2 - Provenance-aware actions:
- Reasoner records fired actions (rule, bindings, confidence) to
  action_log when provenance is enabled
- Fix dangling import in reasoning_provenance.py (ReasoningEngine ->
  Reasoner, infer -> infer_facts)

Backward compatible: rules using the legacy handler still fire (wrapped
as a CallAction); rules without actions behave exactly as before.

Adds tests/reasoning/test_rule_actions.py (9 tests).

Closes #1095

* fix(reasoning): address qodo review findings on rule actions

- Token-aware variable substitution to avoid ?x/?xy prefix collision
- KnowledgeGraph write-back protocol (explicit API -> canonical translation -> ValueError)
- Structured action_log entries with timestamp
- Decouple action firing from conclusion dedup via per-activation tracking
  (fires known conclusions once; retract-self no longer loops to max_iterations)
- Add Reasoner.infer_with_results preserving confidence; infer_facts delegates
- Forward provenance flag in ReasoningProvenance; drop **kwargs; propagate confidence
- Populate Rete Match.bindings from rule conditions
- Add regression tests for each fix

* fix(reasoning): persist fired action activations

* fix(reasoning): deduplicate Rete action execution

* fix(reasoning): canonicalize action activation identity

* docs(reasoning): explain action replay controls

---------

Co-authored-by: 江俊杰 <jiangjunjie.37@jd.com>

2026-08-27 13:18:07 +05:00

..

change_management.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

conflicts.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

context.md

Merge branch 'main' into codex/context-graph-markdown-round-trip

2026-08-23 17:26:05 +05:30

core.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

deduplication.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

distance.md

docs: add Temporal & Distance Intelligence reference pages with accurate API (#650)

2026-06-18 13:37:24 +05:30

embeddings.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

evals.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

explorer.md

Centralize SKOS cycle validation

2026-07-31 23:07:58 +05:30

export.md

fix(export): harden YAML export input handling (#958)

2026-08-15 22:10:04 +05:30

graph_store.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

ingest.md

docs: clarify Snowflake OAuth auth, add ArrowIngestor and non-re-exported ingestors (PR #808)

2026-07-28 15:00:02 +05:30

kg.md

docs: add Temporal & Distance Intelligence reference pages with accurate API (#650)

2026-06-18 13:37:24 +05:30

llms.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

mcp_server.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

normalize.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

ontology.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

parse.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

pipeline.md

Add SPARQL CONSTRUCT query templates (Blazegraph-only)

2026-07-18 12:33:04 +05:30

provenance.md

docs(provenance): document Optional return types and failure behavior (#783)

2026-07-31 15:01:33 +05:30

reasoning.md

feat(reasoning): rule-driven actions with provenance (#1096)

2026-08-27 13:18:07 +05:00

seed.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

semantic_extract.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

split.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

temporal.md

docs: add Temporal & Distance Intelligence reference pages with accurate API (#650)

2026-06-18 13:37:24 +05:30

triplet_store.md

fix(triplet_store): encode RDF4J repository paths

2026-08-24 09:02:42 +08:00

utils.md

fix(utils): write console progress only to an interactive stdout

2026-08-23 22:17:31 +05:30

vector_store.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30

visualization.md

docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)

2026-06-17 23:18:40 +05:30