ac01fffd9a
Architectural snapshot of the lakehouse codebase at the point where the
full matrix-driven agent loop with Mem0 versioning + deletion was
validated end-to-end.
WHAT THIS REPO IS
A clean single-commit snapshot of the lakehouse code. Heavy test data
(.parquet datasets, vector indexes) excluded — see REPLICATION.md for
regen path. Full lakehouse history at git.agentview.dev/profit/lakehouse.
WHAT WAS PROVEN
- Vector retrieval across multi-corpora matrix (chicago_permits + entity
briefs + sec_tickers + distilled procedural + llm_team runs)
- Observer hand-review (cloud + heuristic fallback) gating each candidate
- Local-model agent loop (qwen3.5:latest) with tool use + scratchpad
- Playbook seal on success → next-iter retrieval surfaces it as preamble
- Mem0 versioning + deletion in pathway_memory:
* UPSERT: ADD on new workflow, UPDATE bumps replay_count on identical
* REVISE: chains versions, parent.superseded_at + superseded_by stamped
* RETIRE: marks specific trace retired with reason, excluded from retrieval
* HISTORY: walks chain root→tip, cycle-safe
KEY DIRECTORIES
- crates/vectord/src/pathway_memory.rs — Mem0 ops live here
- crates/vectord/src/playbook_memory.rs — original Mem0 reference
- tests/agent_test/ — local-model agent harness + PRD + session archives
- scripts/dump_raw_corpus.sh — MinIO bucket dump (raw test corpus)
- scripts/vectorize_raw_corpus.ts — corpus → vector indexes
- scripts/analyze_chicago_contracts.ts — real inference pipeline
- scripts/seal_agent_playbook.ts — Mem0 upsert from agent traces
Replication: see REPLICATION.md for Debian 13 clean install + cloud-only
adaptation (no local Ollama).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
73 lines
2.8 KiB
TypeScript
73 lines
2.8 KiB
TypeScript
// Shared types for the claim-auditor. Every field exists for a reason;
|
|
// if something can't be verified from a check, it goes into `evidence`
|
|
// so the verdict is inspectable, not a black box.
|
|
|
|
export type CheckKind = "static" | "dynamic" | "inference" | "kb_query";
|
|
|
|
export type Severity = "info" | "warn" | "block";
|
|
|
|
export interface Claim {
|
|
// Verbatim phrase that raised the claim — e.g. "Phase 38 shipped",
|
|
// "verified end-to-end", "works after restart". Used as the "what
|
|
// does the author assert" input to downstream checks.
|
|
text: string;
|
|
// Where it came from. `commit_sha` is the short hash; `location`
|
|
// is a file:line for in-diff claims, or "pr_body" / "commit_message".
|
|
commit_sha: string;
|
|
location: string;
|
|
// Heuristic rating of how strong the claim is. "green+tested"
|
|
// is strong; "should work" is weak. Drives sensitivity — stronger
|
|
// claims get harder-blocked on weak evidence.
|
|
//
|
|
// "empirical" is a separate class: runtime measurements like
|
|
// "N cloud calls" / "306s end-to-end" / "accepted on attempt N".
|
|
// These cannot be verified from a static diff — only from the test
|
|
// output that produced them. Inference skips diff-verification for
|
|
// empirical claims; they become info-level context unless a future
|
|
// runtime_evidence check contradicts them.
|
|
strength: "weak" | "moderate" | "strong" | "empirical";
|
|
}
|
|
|
|
export interface Finding {
|
|
check: CheckKind;
|
|
severity: Severity;
|
|
claim_text?: string;
|
|
// Free-form short description: "field added but never read", "no
|
|
// test covers this code path", "cloud model says placeholder".
|
|
summary: string;
|
|
// Concrete evidence: file paths, line numbers, log excerpts, test
|
|
// output, cloud-model verdict. No handwaving.
|
|
evidence: string[];
|
|
}
|
|
|
|
export interface Verdict {
|
|
pr_number: number;
|
|
head_sha: string;
|
|
audited_at: string;
|
|
overall: "approve" | "request_changes" | "block";
|
|
findings: Finding[];
|
|
// Real numbers that downstream policy can gate on. e.g. if the
|
|
// hybrid test produced latency numbers or token counts, they
|
|
// surface here so /auditor/history is queryable.
|
|
metrics: Record<string, number>;
|
|
// Short one-line justification for the `overall` verdict. What
|
|
// gets posted as the commit-status description in Gitea (max 140
|
|
// chars) must fit here.
|
|
one_liner: string;
|
|
}
|
|
|
|
export interface PrSnapshot {
|
|
number: number;
|
|
head_sha: string;
|
|
base_sha: string;
|
|
title: string;
|
|
body: string;
|
|
state: "open" | "closed" | "merged";
|
|
author: string;
|
|
// Array of commit messages in the PR (not diffs — those are
|
|
// fetched on-demand per-check).
|
|
commits: Array<{ sha: string; message: string; author: string }>;
|
|
// File paths touched by the PR, with lines-added / lines-removed.
|
|
files: Array<{ path: string; additions: number; deletions: number }>;
|
|
}
|