mariano/nvi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

ui and tiltfile tweaks, update docs

Browse Source
This commit is contained in:
buenosairesam
2026-06-03 14:57:25 -03:00
parent be09fcde2c
commit 05fe7000c5
6 changed files with 531 additions and 387 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
docs/graphs/architecture.dot
View File

@@ -21,7 +21,7 @@ digraph nvi {
color="#30363d";
fontcolor="#58a6ff";
fontsize=11;
plan [label="planner\n(1 LLM call)"];
plan [label="planner\n(1 LLM call → ordered Analyses)"];
}
subgraph cluster_l2 {
@@ -29,37 +29,53 @@ digraph nvi {
color="#30363d";
fontcolor="#58a6ff";
fontsize=11;
compare [label="compare_periods\n(CoT)"];
drill [label="drill_down\n(ReAct)"];
outl [label="find_outliers\n(CoT)"];
corr [label="correlate\n(plan-and-execute)"];
direct [label="direct_answer\n(CoT, one shot)"];
compare [label="compare_periods\n(CoT, 2 periods)"];
drill [label="drill_down\n(ReAct loop)"];
planned [label="find_outliers · correlate\n(planned)",
style="rounded,filled,dashed", fontcolor="#6e7681"];
}
subgraph cluster_l1 {
label="L1 — Tools (deterministic)";
label="L1 — Atomic actions (deterministic, no LLM)";
color="#30363d";
fontcolor="#58a6ff";
fontsize=11;
t2s [label="text_to_sql"];
exec [label="execute_sql"];
schema [label="retrieve_schema"];
py [label="python_sandbox"];
compose [label="compose(pick, recon)\n→ SQL"];
exec [label="execute_sql\n→ rows"];
}
subgraph cluster_l0 {
label="L0 — Recon + dataset setup (foundation)";
color="#30363d";
fontcolor="#58a6ff";
fontsize=11;
recon [label="recon\nknowledge graph"];
setup [label="schema_docs.yaml · metrics.yaml\nencodings · DDL extract", fontcolor="#8b949e"];
}
warehouse [label="Postgres\nBIRD financial", fillcolor="#388bfd33"];
langfuse [label="Langfuse (lng, WG)", fillcolor="#bf4b8a33", fontcolor="#ffffff"];
synth [label="synthesize\nfindings → answer"];
// General → specific flow.
user -> plan;
plan -> compare; plan -> drill; plan -> outl; plan -> corr;
compare -> t2s; drill -> t2s; outl -> t2s; corr -> t2s;
drill -> schema [style=dashed];
corr -> py [style=dashed];
t2s -> exec;
plan -> direct; plan -> compare; plan -> drill;
direct -> compose [label="typed Pick"];
compare -> compose;
drill -> compose [label="typed Pick"];
drill -> drill [label="iterate on results", color="#bf4b8a", fontcolor="#bf4b8a"];
compose -> exec;
exec -> warehouse;
compare -> synth; drill -> synth; outl -> synth; corr -> synth;
direct -> synth; compare -> synth; drill -> synth;
// L0 is consulted by every layer above (not a one-way cascade).
setup -> recon [label="make recon"];
recon -> plan [style=dashed, label="brief names", constraint=false];
recon -> compose [style=dashed, label="columns · joins · metrics", constraint=false];
// Observability.
plan -> langfuse [style=dotted, label="spans"];
compare -> langfuse [style=dotted];
compose -> langfuse [style=dotted];
exec -> langfuse [style=dotted];
}