Fail-closed
High-bar policy gates
- Fuzzy match confidence under 0.85 returns FOOD_UNKNOWN.
- Species scope mismatches return FOOD_UNKNOWN.
- Stale reviews can block answers when policy enforcement is on.
Resource Layer
Verified Resources
LifeLog Resources defines the content and policy system that powers Ask Assistant. It is designed to prevent unsafe guesses, preserve species scope, and make every answer fully reconstructable.
System Design
Fail-closed. Deterministic. Audit-grade.
Verified resources keep answers safe, traceable, and consistent.
Deterministic
Same input. Same decision.
- Fixed algorithm, threshold, and tie-break rules.
- Brand aliases map to canonical chemical names.
- Normalization strips marketing noise and preserves chemical tokens.
Audit-grade
Every answer is traceable.
- ASSISTANT_ANSWER_SERVED stores immutable resourceNodeIds.
- Evidence labels and reviewer roles are captured.
- Answer content is sourced only from ResourceNodes.
Operational doctrine
Ask Assistant operates under a strict fail-closed policy. When a resource match is ambiguous or stale, the assistant either returns FOOD_UNKNOWN or refuses to answer, depending on governance settings. Every decision must be deterministic and auditable.
Normalization safety
- Normalize Unicode to NFKC and collapse whitespace.
- Strip marketing adjectives but preserve chemical tokens and E-numbers.
- Map confusable characters to base Latin to prevent homograph attacks.
Matching and policy gates
- Exact match, then brand alias, then deterministic fuzzy match.
- Confidence under 0.85 for fuzzy matches returns FOOD_UNKNOWN.
- Species scope mismatch always fails closed.
Governance and escalation
- Every ResourceNode includes evidenceLabel, reviewedAt, and reviewerRole.
- Policy window enforcement can block stale content automatically.
- Escalation language is permitted only when ResourceNode escalationCallout is present.
Schema Set
Portable, copy-ready JSON schemas
The v1.1 spec ships with Draft 2020-12 schemas. Each schema is designed for strict validation and fail-closed enforcement.
ResourceNode
Immutable content unit with evidence labeling, review metadata, and controlled escalation callouts.
FoodItemIndexEntry
Canonical food or chemical name with aliases, risk tier, and species scope.
MatchResult
Deterministic matching output with algorithm metadata, candidates, and confidence score.
AssistantAnswerServed
Audit event capturing immutable resourceNodeIds, policy flags, and review snapshots.