1. Decision Black Box (DBB)
1.1 Purpose
Decision Black Box (DBB) is a backend reasoning agent responsible for:- Detecting decisions, not conversations
- Extracting reasoning context at the moment decisions happen
- Preserving causal structure for Decision Surface (DS)
- Operating silently without interrupting user workflows
2. DBB Input Streams
DBB consumes multiple user-originated streams:- AI chat conversations (Membria, Claude, Codex, etc.)
- Code commits / diffs
- Documents and notes
- Task descriptions
- Explicit user actions (accept, reject, deploy, merge)
3. Decision Detection Heuristics
DBB does not rely on a single classifier. It uses heuristic composition with confidence scoring.3.1 Decision Signal Types
Each detected event is evaluated across the following dimensions:| Signal type | Description |
|---|---|
| Commitment language | ”We will”, “Let’s do”, “I’m going with”, “Final decision” |
| Irreversibility | Actions that create cost or lock-in (deploy, merge, pay, publish) |
| Alternatives closure | Explicit rejection of other options |
| Temporal anchoring | References to deadlines, timelines, next steps |
| Responsibility assertion | ”I decided”, “We agreed”, “I approve” |
| Execution trigger | Follow-up tasks, code changes, calendar events |
4. Confidence Scoring Model
DBB assigns a Decision Confidence Score (DCS) in [0.0 - 1.0].4.1 Scoring Formula (Conceptual)
DCS = sum(weight_i * signal_i) - ambiguity_penalty Where:- signal_i in [0,1]
- weights are user-calibrated over time
- ambiguity penalty increases with:
- speculative language
- conditional phrasing
- hypothetical tense
4.2 Confidence Bands
| DCS range | Classification | Behavior |
|---|---|---|
| >= 0.75 | Confirmed decision | Recorded immediately in DBB |
| 0.45 - 0.75 | Tentative decision | Stored as provisional, surfaced softly |
| < 0.45 | Exploration | Ignored for DS, kept only as context |
5. False Positive Handling (No-Friction Model)
DBB assumes false positives are inevitable.5.1 Correction Loop
Tentative decisions appear in DS as low-priority signals. User can:- Confirm
- Mark as exploration
- Ignore
5.2 Learning Rule
Corrections:- Adjust user-specific weights
- Improve future DCS calibration
- Are never shared globally
6. DBB Output Schema (Abstract)
Each recorded decision includes:- Decision ID
- Timestamp
- Confidence score
- Reasoning trace (summarized, structured)
- Source references (chat IDs, commit hashes, docs)
- Assumptions detected
- Initial prediction (if available)
7. Relationship to Decision Surface (DS)
- DS reads only DBB outputs
- Raw chat history is never surfaced directly
- DS reflects:
- Open decisions
- Drift
- Unresolved assumptions
- Outcome deltas
7.1 DBB False Positives and User Correction
Decision Black Box (DBB) detections are non-destructive and reversible by design. DBB may occasionally detect a “decision” where the user intended only exploratory reasoning or contextual discussion. In such cases, the system provides lightweight correction mechanisms without interrupting the user flow. Supported corrections:- Mark as context - the event is treated as non-decisional reasoning
- Merge with existing decision - useful when a decision evolved gradually
- Dismiss detection - removes the event from Decision Surface signals
- Corrections do not modify raw logs
- Corrections do not affect past DBB history
- Corrections are used only for future calibration
Part II - LoRA Router Policy
8. Purpose of LoRA Routing
Membria does not rely on a single monolithic model. Instead:- A base SLM handles most interactions
- LoRA adapters provide domain expertise
- Escalation occurs only when confidence is insufficient
9. LoRA Types
| LoRA type | Scope |
|---|---|
| Personal LoRA | Single user |
| Domain LoRA | Workspace / project |
| Task LoRA | Narrow function (e.g. legal review) |
| Council-derived LoRA | Sanitized expert synthesis |
9.1 LoRA Ownership and Governance Model
Each LoRA adapter in Membria belongs to a single explicit scope:- Personal LoRA - owned by an individual user
- Team LoRA - shared within a workspace or organization
- Global LoRA - derived from Council synthesis and shared via the Global Knowledge Cache
- All LoRAs start as Personal
- No LoRA is promoted automatically across scopes
- Personal -> Team: explicit user action
- Team -> Global: Council evaluation + governance approval
- No silent LoRA activation
- No retroactive impact on past decisions
- Full auditability of LoRA activation and rollback events
10. Router Inputs
The LoRA Router evaluates:- Query intent
- Required domain expertise
- Base model confidence estimate
- Historical success rate of LoRAs
- Cost / latency budget
11. Routing Policy (Default)
11.1 Normal Path (approx 80-90%)
Base SLM + Personal LoRA (if exists) + Local GraphRAG Used when:- Confidence >= threshold
- Query within known domain
- No conflicting signals
11.2 Expert Path
Base SLM + Personal LoRA + Domain LoRA + Local GraphRAG Triggered when:- Domain match is strong
- Past evaluations show LoRA benefit
- Confidence borderline but acceptable
11.3 Escalation Path
Triggered when:- Confidence < minimum threshold
- Conflicting reasoning detected
- High-risk decision context
- Global Knowledge Cache (if answer exists)
- Council of LLMs (parallel inference)
- Result distilled and cached
12. LoRA Evaluation & Promotion
12.1 Evaluation Dataset
Each LoRA maintains:- Fixed test prompts
- Known failure cases
- Drift detection metrics
12.2 Promotion Rules
A LoRA may become default only if:- Improves accuracy
- Does not increase hallucinations
- Reduces escalation frequency
13. Rollback Policy
Rollback is instantaneous:- Disable LoRA
- Revert routing decision
13.1 LoRA Safety Invariants
The following invariants are enforced across all deployments:- LoRA adapters never modify historical DBB records
- LoRA adapters never rewrite past decisions
- LoRA rollback is instantaneous and side-effect free
- LoRA changes affect only future inference
14. Key Design Principles
- Decisions > conversations
- Silence > interruption
- Personal calibration > global optimization
- Escalate only when needed
- Never hide uncertainty
15. Summary
DBB ensures that important moments are captured without user effort. LoRA routing ensures that expertise compounds without degrading trust. Together, they form the reasoning backbone of Membria CE.16. Council Cost and Escalation Governance
Escalation to the Council of LLMs is governed by explicit policies. Triggers:- Confidence below threshold
- Conflicting reasoning signals
- High-risk or irreversible decision context
- Personal CE users operate under capped monthly Council usage
- Enterprise deployments define explicit budgets
- All Council calls are logged and auditable
- No silent escalation is allowed
- Escalation decisions are explainable post-hoc