You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Merge PR #16 after CI and Release Preflight passed. Ships the Universal Response and Decision Map front door while preserving the deterministic Decision Lab, browser-local privacy boundary, and human decision authority.
Decision Rescue accepts ordinary language first. A visitor can put down what is happening, choose one useful next action, and build a Decision Frame without knowing decision-science terminology.
11
+
The FDE front door starts with one free-form input. Put down a problem, question, worry, idea, decision, or a complete mess. FDE responds immediately with a provisional Decision Map showing only what can be safely organized from the words provided.
12
12
13
-
FDE preserves what the person confirms and does not pretend browser JavaScript inferred evidence, probabilities, thresholds, scores, or a recommendation. A partial Decision Frame is a valid stopping point.
13
+
The map is a draft, not a hidden machine decision. Possible signals stay possible until a person confirms them. When enough explicit structure exists, the map can continue into the deterministic Decision Lab. Otherwise, it offers a simple path to shape the missing pieces without pretending the missing information is known.
14
14
15
-
Decision Rescue uses tab-scoped session storage so an accidental refresh can recover in-progress framing. It does not treat the original brain dump as model evidence. When a complete frame continues into the Decision Lab, existing browser-saved Lab work is never replaced without an explicit human choice.
15
+
The experience is designed around a simple rule: **every meaningful input receives a useful response, and questions are used only when human judgment is actually needed to move the decision forward.**
16
16
17
-
## What the Decision Lab does
17
+
## Decision Map
18
18
19
-
- Frames the decision, goals, choices, and plausible futures.
20
-
- Evaluates the same choices across explicit goals and named conditions.
21
-
- Shows unmet goals, ties, incomplete outcomes, and vulnerabilities.
22
-
- Keeps final selection, rationale, and next action human-owned.
23
-
- Exports a portable decision file and a readable decision summary.
19
+
The map can show:
24
20
25
-
Guided work supports 2–4 objectives, 2–3 choices, and 2–4 plausible futures. The minimum comparison is a real 2 × 2 × 2 model. FDE never fills missing analytical inputs on the person's behalf.
21
+
- a possible decision;
22
+
- choices mentioned explicitly;
23
+
- things that may matter;
24
+
- conditions that could change the answer; and
25
+
- the smallest useful next step.
26
26
27
-
The included ready example is a **synthetic critical-material source-qualification case**. It does not describe or certify a real supplier, material, capacity, compliance status, or investment.
27
+
This is deliberately conservative. The browser does not call a remote AI service, retrieve outside facts, invent probabilities, or promote provisional text into verified evidence.
28
28
29
-
## Privacy and authority
29
+
## Decision Lab
30
30
31
-
The application is static and browser-local. It has no backend, account system, analytics, telemetry, cookies, or default upload endpoint.
31
+
When a person confirms enough structure, FDE can hand the work into its existing deterministic comparison engine. Guided work supports 2–4 objectives, 2–3 choices, and 2–4 plausible futures. The minimum comparison is a true 2 × 2 × 2 model.
32
32
33
-
Browser storage is a convenience, not encrypted confidential storage. Do not enter information that requires an approved confidential or controlled-data environment.
33
+
The comparison informs. A person decides.
34
34
35
-
FDE provides decision support. It does not approve, authorize, certify, qualify, consent, or make an investment decision. The comparison informs; a person decides.
35
+
## Synthetic reference
36
36
37
-
## Run locally
37
+
The repository includes a synthetic critical-material source-qualification case to demonstrate the formal Decision Lab without making claims about a real supplier, material, capacity, compliance status, or investment.
38
38
39
-
```bash
40
-
node scripts/run-python.mjs -m http.server 8000 --directory site
41
-
```
39
+
## Privacy and authority
40
+
41
+
The application is static and browser-local. It has no backend, account system, analytics, telemetry, cookies, remote AI provider, or default upload endpoint. Session recovery and browser autosave are convenience features, not encrypted confidential storage.
42
42
43
-
Open `http://localhost:8000`.
43
+
FDE provides decision support. It does not approve, authorize, certify, qualify, consent, or make an investment decision.
44
44
45
45
## Verify
46
46
@@ -53,14 +53,14 @@ npm ci --ignore-scripts --no-audit --no-fund
53
53
npm run check
54
54
```
55
55
56
-
`npm run check` runs the repository's unit, version, integrity, browser, Decision Rescue, and release-closeout gates. Current generated counts and versions are recorded in [`project-facts.json`](project-facts.json).
56
+
Generated release facts and current application identity are recorded in [`project-facts.json`](project-facts.json). The full verification gate is defined by the repository's `npm run check` command.
Copy file name to clipboardExpand all lines: docs/ARCHITECTURE.md
+30-31Lines changed: 30 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,55 +2,54 @@
2
2
3
3
Frontier Decision Engine is a static browser application served from `site/`. There is no backend or account service.
4
4
5
-
## Runtime
5
+
## Human-first runtime
6
6
7
-
- Decision Rescue is the human-language front door.
8
-
- Decision Lab is the structured six-stage comparison workflow.
9
-
- The ranking engine is deterministic and runs in the browser.
10
-
- Portable decision schemas remain versioned under `schemas/`.
11
-
- Validation and release checks run from `scripts/` and GitHub Actions.
7
+
The public root is a one-input response experience. A person can write a problem, question, worry, idea, decision, or incomplete thought without knowing decision-science vocabulary. FDE immediately returns a useful response and a provisional Decision Map.
12
8
13
-
## Human-first entry
9
+
The Decision Map can show:
14
10
15
-
The root experience accepts bounded inert text and asks for the smallest useful human contribution next. It does not claim to understand arbitrary prose, retrieve external facts, infer evidence, assign probabilities, create scores, or recommend an action.
11
+
- a possible decision;
12
+
- choices mentioned explicitly;
13
+
- things that may matter;
14
+
- conditions that could change the answer; and
15
+
- the most useful next step.
16
16
17
-
A Decision Frame can remain incomplete and still be useful. Full comparison is available only after the person has confirmed a decision, at least two goals, two choices, and two plausible futures.
17
+
Possible elements are not silently promoted into facts. The map is a draft until a person confirms the information that belongs in the formal decision model.
18
18
19
-
Guided comparison supports:
19
+
## Minimum necessary human contribution
20
20
21
-
- 2–4 objectives
22
-
- 2–3 strategies
23
-
- 2–4 scenarios
21
+
FDE follows this interaction rule:
24
22
25
-
The ready example remains a larger synthetic reference case. Missing thresholds, scores, modifiers, critical flags, and evidence stay missing until a person supplies them.
23
+
> Continue without bothering the person when the system can proceed safely; otherwise ask for the smallest human contribution that materially advances the decision.
26
24
27
-
## Browser storage
25
+
No normal input is treated as a dead end. Empty, vague, messy, ambiguous, and non-decision input receive a useful orientation response rather than an error-only state.
28
26
29
-
Decision Rescue uses tab-scoped session storage for accidental-refresh recovery. The original starting context remains context only and is not scored or promoted into model evidence.
27
+
## Formal Decision Lab
30
28
31
-
Decision Lab uses bounded browser autosave for in-progress structured work. If a browser draft already exists, Decision Rescue does not replace it silently; replacement requires an explicit human choice.
29
+
Once enough explicit structure exists and the person confirms the map, the confirmed information is handed into the existing deterministic Decision Lab. Guided comparison supports 2–4 objectives, 2–3 strategies, and 2–4 scenarios. The minimum comparison is a true 2 × 2 × 2 model.
32
30
33
-
Browser storage is not encrypted confidential storage. Local files are processed in the browser and are not uploaded by the default application.
31
+
The comparison core is isolated from the Map layer so UX changes do not silently alter ranking semantics. Missing analytical values are not fabricated.
34
32
35
-
## Decision result
33
+
## Epistemic boundaries
36
34
37
-
The engine evaluates explicit human-supplied inputs across the same named futures. It preserves honest outcomes including:
35
+
The public experience separates:
38
36
39
-
- a unique leader under the tested model;
40
-
- tied leaders;
41
-
- no acceptable strategy under declared boundaries; and
3.**You confirmed** — information promoted into the formal model by a human.
40
+
4.**FDE calculated** — deterministic output from confirmed model inputs.
41
+
5.**You decided** — the human-owned choice, rationale, and next action.
43
42
44
-
The result is advisory. A person selects the strategy and records the rationale and next action.
43
+
The default runtime does not use a remote AI provider, retrieve external facts, infer evidence, assign probabilities, or make the final decision.
45
44
46
-
## Compatibility
45
+
## Browser storage
47
46
48
-
Legacy completed decision schema `0.2.10` remains supported. Optional decision-semantics state uses schema `0.3.0`. The guided browser editor is intentionally bounded even though portable schemas may permit broader cases.
47
+
The universal response experience uses bounded tab-scoped session storage for accidental-refresh recovery. Decision Lab uses bounded browser autosave for structured work. Browser storage is a convenience, not encrypted confidential storage.
49
48
50
-
The deterministic ranking core is isolated from the human-entry layer so UX changes do not silently alter comparison semantics.
49
+
## Privacy and security
51
50
52
-
## Security and privacy boundaries
51
+
The public application has no backend, account system, analytics, telemetry, cookies, remote AI provider, or default upload endpoint. User input is rendered as text, not executable markup. Local files remain in the browser unless the person explicitly downloads or shares them.
53
52
54
-
The public runtime has no account system, analytics, telemetry, remote AI provider, or default upload endpoint. User-entered text is rendered as text rather than executable markup.
53
+
## Long-term direction
55
54
56
-
Generated visualizations and software calculations are not evidence. FDE does not provide legal approval, organizational authorization, certification, qualification, consent, or investment approval.
55
+
The architecture intentionally leaves room for an optional assisted-understanding adapter and later Decision Memory without making either a dependency of the deterministic core. Any future semantic provider must produce provisional output that passes through the same human-confirmation boundary.
0 commit comments