Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 12 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,23 @@ An agent should not have to reconstruct a project from scattered chat history on
Engraphis turns local project knowledge into scoped, time-aware memory; retrieves the evidence
that supports the current question; and returns a bounded, attributable context packet.

<p align="center">
<img src="docs/images/knowledge-graph.png" alt="Engraphis Knowledge Graph tab: force-directed entity-relation network" width="100%">
<br>
<sup>Knowledge Graph · run <code>engraphis-dashboard</code> to see it live</sup>
</p>

<p align="center">
<img src="docs/images/engraphis-benefit-flow.png" alt="Diagram: project history becomes scoped and temporal Engraphis memory, hybrid recall, then bounded cited context for an agent" width="100%">
<br>
<sup>Store durable project knowledge · retrieve supporting evidence · give the agent only what it needs</sup>
</p>

The flow is the essential path. See [measured context savings](#measured-quality-and-token-efficiency)
for reproducible fixture-level evidence of less returned content at the same tested retrieval
scores, without billing or latency claims. The sections below cover the dashboard, code graph,
local installation, governance controls, and hosted services in detail.

| Agent need | What Engraphis changes |
|---|---|
| Remember a project across sessions | Stores typed memory in a `workspace → repo → session` hierarchy and provides a last-session handoff. |
Expand All @@ -38,7 +49,7 @@ contracts: retrieving focused evidence, returning an answer only with support, a
abstaining when no support exists.

<p align="center">
<img src="docs/images/evidence-backed-agent-examples.png" alt="Three evidence-backed examples: focused context holds Recall at 5 while reducing retrieved tokens, answerable questions return supported evidence, and off-topic questions abstain" width="100%">
<img src="docs/images/evidence-backed-agent-examples.png" alt="Three evidence-backed examples: focused context keeps Recall at 5 while reducing returned content, answerable questions return cited support, and unsupported questions explicitly abstain" width="100%">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Restore per-card fixture scope in the replacement image

The replacement graphic no longer names the long-document versus grounded fixture, or each fixture's document/question scope, on the individual cards; it provides only a global pair of commands. This contradicts the adjacent caption claiming that each card names its deterministic fixture and test scope, so readers cannot tell which fixture supports each displayed result. Restore the per-card labels or revise the caption to describe the graphic accurately.

AGENTS.md reference: AGENTS.md:L220-L222

Useful? React with 👍 / 👎.

<br>
<sup>Each card names its deterministic offline fixture and test scope. The examples are illustrative; they are not customer data or external benchmark results.</sup>
</p>
Expand All @@ -47,21 +58,6 @@ Run `python -m eval.chunking_eval` and `python -m eval.grounded` to reproduce th
the former measures evidence retrieval and context size, while the latter measures the
answer-versus-abstain decision.

The diagram is the essential path. See [measured context savings](#measured-quality-and-token-efficiency)
for reproducible fixture-level evidence of less returned content at the same tested retrieval
scores, without billing or latency claims. The sections below cover the dashboard, code graph,
local installation, governance controls, and hosted services in detail.

<br>

<p align="center">
<img src="docs/images/knowledge-graph.png" alt="Engraphis Knowledge Graph tab: force-directed entity-relation network" width="100%">
<br>
<sup>Knowledge Graph · run <code>engraphis-dashboard</code> to see it live</sup>
</p>

<br>

---

> Open-source users: update regularly for the latest fixes and improvements.
Expand Down
Binary file modified docs/images/evidence-backed-agent-examples.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
82 changes: 4 additions & 78 deletions docs/images/evidence-backed-agent-examples.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading