@thebackstoryis/engineering-with-ai 0.3.2 → 0.3.4-beta.6

package/Docs/README.md

@@ -8,6 +8,8 @@ For feature delivery, **`ewai-deliver` coordinates the full fourteen-stage workf
 
 If you want EWAI to act on an approved, exact pool of registered intents, read [governed autonomous intent delivery](autonomous-intent-delivery.md). It starts off, needs a named and bounded grant, and leaves human Build approval and Manual QA separate.
 
+Read how [EWAI now supports Jev and the OpenAI Decisions API](releases/0.3.4-beta.6.md) in the latest beta.
+
 ## New to EWAI?
 
 1. [Install EWAI](operations/installation-updating-and-entitlements.md) and open it in your project folder.
@@ -36,6 +38,8 @@ To try the beta communication guidance, read [concise answers and guided decisio
 
 [Choose which views you need](operations/dashboard-configuration.md). Portfolio, Team Hub, policy tools and the other advanced views are optional and start hidden. Showing a view doesn't configure the service behind it; hiding one doesn't remove checks your project requires.
 
+Try the optional [Jev decision-assistance beta](operations/jev-beta-experiment.md) to rank bounded options, compare LLM recommendations and recommend available personas. Start with shadow mode; overall coding savings remain unmeasured.
+
 ## Something isn't working?
 
 Start with [troubleshooting and recovery](operations/troubleshooting-and-recovery.md). For a problem that needs support, [prepare a private error report](error-reporting-guide.md) and review it before sharing.
@@ -52,3 +56,5 @@ The [complete guide catalogue](guide-catalogue.md) separates everyday use, engin
 - **An installed pack isn't automatically suitable.** Review shared guidance before adopting it. Executable adapters need explicit registration and run with your operating-system permissions; they aren't OS-sandboxed.
 
 If you're changing EWAI itself, start in the [maintainer section](guide-catalogue.md#maintaining-ewai), not the application delivery instructions.
+
+OpenAI Decisions joins the shared bounded engine in `0.3.4-beta.3`. New settings default off with Automatic provider preference; historical Jev policies retain their vendor consent. Private CLI/dashboard OpenAI key setup, independent text consent, typed conversion and provider-aware costs are described in the [OpenAI Decisions beta guide](operations/openai-decisions-beta.md). Live OpenAI access and completed-task savings remain unmeasured.

package/Docs/context-management-and-token-efficiency.md

@@ -153,3 +153,11 @@ If you're changing EWAI itself, follow [maintainer context benchmarks](maintaine
 - If a digest, source, phase or task has changed, prepare a new pack and review the delta.
 
 Context efficiency is useful only when the resulting engineering work remains at least as reliable, testable, secure and accountable as the full-context baseline.
+
+## Jev beta decision assistance
+
+The local `0.3.4-beta.1` experiment adds an opt-in structured decision path before a larger model comparison. Jev can order bounded options, compare supported LLM recommendations and recommend installed personas from metadata. See [Jev setup and experiment limits](operations/jev-beta-experiment.md). It starts off and first enablement should use shadow. No incremental token or cost saving has been measured on equivalent completed coding tasks; the synthetic runner measures Jev's own usage and latency. Publication and human Manual QA remain separate.
+
+OpenAI Decisions joins the shared bounded engine in experimental `0.3.4-beta.3`. New settings default off with Automatic provider preference; historical Jev policies retain their vendor consent. Private CLI/dashboard OpenAI key setup, independent text consent, typed conversion and provider-aware costs are described in the [OpenAI Decisions beta guide](operations/openai-decisions-beta.md). Live OpenAI access and completed-task savings remain unmeasured.
+
+`0.3.4-beta.6` includes these integrations. Read the [release update](releases/0.3.4-beta.6.md).

package/Docs/operations/jev-beta-experiment.md

@@ -0,0 +1,80 @@
+# Jev decision assistance beta
+
+Jev evaluates bounded choice, score and yes/no questions. Use it to rank an existing set of options before asking a generative model to compare the whole set. It can also compare a structured recommendation returned by an LLM. This experiment does not replace coding models, validate arbitrary prose or establish that an answer is correct.
+
+## Enablement and credentials
+
+Jev is off by default. In Configuration, use **Jev API credentials** to check and save a TypeSafe key, then select **Shadow** in **Decision assistance**, choose uses, accept the text-processing disclosure and save. First enablement should use shadow. Select Active explicitly after reviewing measurements. Saving credentials does not enable inference.
+
+CLI equivalents:
+
+```sh
+ewai jev credentials configure --project .
+ewai jev configure --mode shadow --use-cases context,personas,skill,claim,failure,impact,tests --acknowledge-cloud-processing --yes --project .
+ewai jev status --project . --json
+ewai jev measurements --project . --json
+ewai jev experiment --limit 6 --project . --json
+ewai jev configure --mode off --yes --project .
+```
+
+Credential configuration requires a genuinely interactive hidden terminal prompt. Never put a key in arguments or project JSON. The saved key is an owner-only **unencrypted** file at `~/.ewai/credentials/jev.json`, outside the project. `TYPESAFE_API_KEY` in the launching environment takes precedence. Credential status, check and remove commands are available; removing a saved key does not remove an environment override. Check uses the fixed metadata endpoint without inference and does not prove credit or decision quality.
+
+CLI, dashboard and MCP share project-local settings at `.ewai-pipeline/jev.json`. Saves require explicit confirmation and the current revision. An off policy makes no inference calls. Shadow automatic journeys retain their local baseline; explicit decision tools return suggestions for comparison. Active mode permits the bounded automatic applications below. No recommendation grants approval, executes a suggested skill, installs a persona pack, changes provider roles or removes required reviews/tests.
+
+## Use boundaries
+
+| Use | Integration | Boundaries |
+|---|---|---|
+| Context | CLI/MCP/dashboard context preparation | Rank nonmandatory segment labels; reassemble locally, preserve mandatory evidence, fidelity and overflow failures. Source bodies stay local. |
+| Personas | Context preparation and `jev personas` / `ewai_jev_personas` | Resolve core, project, personal and installed premium metadata locally; score names, categories, tags and capabilities for up to 256 unique available personas in batches of 16. Expose considered/available counts and incomplete coverage. Add eligible advice only after complete evaluation; retain baseline reviewers. |
+| Skills and answer options | `jev decide`, `ewai_jev_decide`, focused companion status | Choice probabilities order up to 31 candidates (each combined label and description at most 255 characters) and select the recommended ID. Companion automatically reorders only equal-class eligible work, preserving human/blocked positions and handoffs. |
+| Claim support | Explicit decision tool | Compare the full claim with supplied eligible evidence: supports, contradicts or insufficient. A supplied quotation must exist verbatim locally before calling. Advice is not factual verification or a gate pass. |
+| Failure triage | Explicit decision tool | Classify a supplied sanitised diagnostic into auth, rate, dependency or unknown. Never upload automatic raw process capture or execute a remedy. |
+| Impact | Dashboard impact preview | Preserve canonical route recommendations and personas. Show Jev specialist advice in the inferred-consequences cards and a supplemental API field; human changes still require a rationale. |
+| Tests | Explicit decision tool | Rank supplemental tests; return mandatory test IDs unchanged. Required tests cannot be deselected. |
+
+Persona recommendation without sending the catalogue to the coding LLM:
+
+```sh
+ewai jev personas --focus 'Review keyboard access to the settings form' --limit 4 --project . --json
+```
+
+The response contains safe IDs, names, tiers, scores and coverage. Tier describes provenance, not authority. Premium recommendations require an installed persona; this operation never purchases, downloads or updates a pack. Automatic persona advice can add to the local baseline up to its existing eight-persona cap.
+
+## Rank options and review LLM recommendations
+
+Write a bounded decision input to a project-local JSON file, then call `ewai jev decide --input decisions/options.json --project . --json`, or send the same fields directly to `ewai_jev_decide`. The dashboard exposes the same engine at `/api/jev/decisions` to matching-origin callers.
+
+```json
+{
+  "useCase": "skill",
+  "source": "public",
+  "task": "Recommend reusable model-to-model access in Laravel",
+  "candidates": [
+    {"id": "relationship", "label": "Native Eloquent relationship"},
+    {"id": "queries", "label": "Duplicate controller queries"}
+  ]
+}
+```
+
+The result supplies `orderedIds`, `recommendedId`, `decision`, probabilities and confidence. `none` means no suitable option; it is excluded from ordered candidate IDs and gives a null recommendation. Probabilities express the model's judgement, not an independently measured correctness rate.
+
+For supported structured options already returned by an LLM, also supply `"origin": "llm"` and `"recommendedId": "queries"`. Jev evaluates the candidates without being shown the LLM's preferred ID, then returns `validation.status` as `agrees`, `disagrees` or `inconclusive`. A recommendation ID outside the supplied set or unsupported shape is rejected. Agreement is a semantic comparison, not proof of validity. Keep the existing recommendation on timeout, low confidence or other inconclusive outcomes; escalate unresolved decisions when needed.
+
+Use these tools as preflight operations where bounded choices are sufficient. They do not intercept every host-model turn or guarantee that a host follows advice. Avoid asking a larger model to re-rank the same full set unless Jev falls back or the decision needs reasoning beyond the rubric.
+
+## Data, budgets and measurements
+
+Enablement discloses that focus text, selected labels and descriptions leave the machine for TypeSafe. Automatic persona ranking uses names, categories, tags and capabilities, excluding descriptions that might have been derived from persona bodies. Explicit checks can send evidence or sanitised diagnostics supplied by the caller. Automatic ranking excludes project source and persona bodies. Explicit sources must be `public`, `synthetic`, `cloud-approved` or `metadata-only`; unknown/imported/cloud-denied material is refused. Source assertions are the caller's responsibility. Common credential patterns and the configured key are rejected, but pattern matching is not a complete data-classification system. Do not label confidential text metadata-only to bypass its handling policy.
+
+Requests use the fixed HTTPS TypeSafe endpoint and pinned `jev-1.13.0`, with no retries or redirects. Defaults: 100 calls, 100,000 reserved input tokens, three-second deadline and 0.65 minimum confidence. Limits apply across processes to a saved policy revision; a new explicitly saved revision starts another bounded budget. UTF-8 bytes plus headroom reserve input capacity conservatively. Reported usage determines measured cost; over-reservation or unknown usage blocks further calls in the current budget. A cache hit requires the same policy, credential identity and request; disabling or changing these invalidates application of in-flight advice.
+
+Telemetry stores bounded IDs, outcome codes, numeric results, model, usage, timings and effects. It excludes prompts, candidate descriptions, evidence bodies, raw provider responses and credentials. Numeric cache entries are bounded separately. The history retains the latest 500 observation events; latency/call/fallback/cache figures cover that history, while recorded input and cost totals accumulate across revisions. Before dispatch, an unresolved reservation is persisted. Concurrent or interrupted unresolved calls block new inference in that policy revision and leave total cost unknown; it is never silently reported as zero. Measurements distinguish suggestions from application; downstream savings remain unknown.
+
+The synthetic runner evaluates at most six labelled challenge cases using the already enabled policy and configured key. It never widens limits or enables Jev. Run comparisons on equivalent completed coding tasks before claiming lower overall token use, cost or elapsed time. Include Jev's own latency, cache hits, fallback frequency, reviewer quality and any large-model calls still needed. A local deterministic selector is usually faster than a network call; Jev's potential benefit is better semantic selection or avoiding a more expensive model comparison.
+
+API and model references: [TypeSafe API](https://docs.typesafe.ai/api), [models and pricing](https://docs.typesafe.ai/models), [confidence](https://docs.typesafe.ai/confidence), [coding-agent guidance](https://docs.typesafe.ai/introduction/coding-agents).
+
+This is an experimental beta. Packaging and automated browser checks do not replace owner Manual QA or establish completed coding-task savings.
+
+OpenAI Decisions joins the shared bounded engine in `0.3.4-beta.3`. New settings default off with Automatic provider preference; historical Jev policies retain their vendor consent. Private CLI/dashboard OpenAI key setup, independent text consent, typed conversion and provider-aware costs are described in the [OpenAI Decisions beta guide](openai-decisions-beta.md). Live OpenAI access and completed-task savings remain unmeasured.

package/Docs/operations/openai-decisions-beta.md

@@ -0,0 +1,62 @@
+# OpenAI Decisions beta
+
+Experimental `0.3.4-beta.3` adds OpenAI Decisions to the bounded decision assistance introduced with Jev. Start in shadow mode and compare suggestions before explicitly choosing active mode.
+
+## Private setup
+
+Open Configuration → OpenAI API credentials in the local dashboard, or use a genuine interactive terminal:
+
+```sh
+ewai providers credentials openai configure --project .
+ewai providers credentials openai status --project . --json
+ewai providers credentials openai check --project .
+```
+
+The password form and hidden terminal check metadata authentication without inference. This requires models-read permission and does not establish Decisions access, credit or decision quality. A failed replacement retains the saved predecessor. The key is stored outside projects in `~/.ewai/credentials/openai.json`, in an owner-only local file, **unencrypted**. `OPENAI_API_KEY` in the launching environment overrides the saved key. Use that environment route for a restricted key without metadata-read permission. Saving credentials does not enable decision assistance. Do not put keys in chat, arguments, project configuration, SPECS or logs. EWAI never uses Codex OAuth credentials for these calls.
+
+Remove only the saved credential, with the revision from status:
+
+```sh
+ewai providers credentials openai remove --expected-revision REVISION --yes --project .
+```
+
+An environment override remains active after removing a saved key. Unsafe paths, permissions, links or stale replacement requests fail closed. A valid environment override remains usable when saved storage needs repair; local writes stay unavailable until repaired.
+
+## Choose participation and provider
+
+New projects start **off**, with **Automatic** preference and neither vendor consent. Automatic uses a configured, separately consented OpenAI key first, otherwise a configured, consented Jev key, otherwise local decisions. It is an eligibility choice, not a claim that the account has endpoint access. Installing Codex alone does not authorise API use. Existing Jev policies retain Jev preference and TypeSafe-only consent until explicitly changed.
+
+The dashboard has separate OpenAI and TypeSafe text disclosures. Equivalent CLI setup is:
+
+```sh
+ewai decisions configure --provider auto --mode shadow --acknowledge-openai-processing --acknowledge-cloud-processing --yes --project .
+ewai decisions status --project . --json
+ewai decisions measurements --project . --json
+```
+
+Only acknowledge vendors you authorise. Revoke independently with `--revoke-openai-processing` or `--revoke-cloud-processing` (TypeSafe). If no selected vendor consent remains, also choose `--mode off`. Acknowledgement and revocation for the same vendor cannot be combined. Use `--provider openai` or `--provider jev` for an explicit preference. Existing `ewai jev` commands and `/api/jev` routes remain compatible; `ewai decisions`, `/api/decisions` and `ewai_decisions_*` MCP tools expose the same policy and operations. Model-facing MCP tools cannot capture keys.
+
+Both providers are optional. Off makes no paid calls or credential-resolution attempts; unavailable provider credentials do not block the local decision baseline. Ordinary status reports unavailable credentials without losing the other provider’s status. Shadow records suggestions without changing existing automatic decisions. Active can apply eligible context ordering and available persona additions. Required evidence, baseline persona records, mandatory tests, human decisions and canonical impact routes remain protected.
+
+## Supported decisions
+
+The same seven operations support context ordering, available persona recommendations, skills or answer options, claim support, failure triage, supplemental impact review and supplemental test relevance. For bounded options:
+
+```sh
+ewai decisions decide --input decision.json --project .
+ewai decisions personas --focus 'Review accessibility and credential setup' --limit 4 --project .
+```
+
+The project-local JSON contract is documented in the [Jev beta guide](jev-beta-experiment.md). Supported LLM comparisons use `origin: "llm"` and the existing `recommendedId`; results are agrees, disagrees or inconclusive, never factual proof. Only locally available core, project, personal and installed premium personas are considered. No premium download occurs, and persona bodies are excluded from automatic requests. Typed advice cannot execute tools or grant work approval.
+
+## Transport, accounting and limits
+
+OpenAI calls use fixed HTTPS `POST /v1/decisions` with pinned `gpt-6-luna`. The converter maps named choice, zero-based rubric score and predicate arrays into the established operation-facing envelope. Wrong models, names, types, values, distributions, scores, refusals or usage fail safely. Only bounded text is used; no images or external image fetching.
+
+Both vendors share one atomic call and conservative input-byte reservation budget, pending-call records, privacy filters and whole-response deadline. Unknown/imported/denied material is excluded. Provider/model, policy revision and credential identity participate in exact caching and freshness. A provider or key change invalidates stale advice. A failed paid request is never retried against a second vendor. Unknown usage stops further calls within that policy budget and remains unknown in cumulative cost reporting, including after a policy revision. Explicitly saving a new policy starts a new bounded budget.
+
+Numeric measurements identify provider and model and preserve reported input/cache/output details. The base estimate uses Jev USD0.042/M input or OpenAI USD0.10/M input per recorded call. OpenAI estimates precede free-cache adjustments and regional or long-context premiums; these are **not invoices**. Recent history is capped at 500 events while cumulative known input/cost totals cover all recorded calls. Requests, source, keys, instructions and persona bodies are not retained in telemetry.
+
+OpenAI integration is verified with mock transports and synthetic local projects until an owner privately configures a usable key. Live account access, OpenAI quality/latency and completed coding-task token, time or cost savings are unmeasured. Vendor speed statements are not EWAI results. Manual QA and public release remain separate.
+
+Primary protocol and pricing sources: [Decisions guide](https://developers.openai.com/api/docs/guides/decisions), [create reference](https://developers.openai.com/api/reference/resources/decisions/methods/create), [TypeSafe models](https://docs.typesafe.ai/models).

package/Docs/releases/0.3.4-beta.6.md

@@ -0,0 +1,22 @@
+# New in 0.3.4 Beta 6 release
+
+**EWAI now supports Jev and the OpenAI Decisions API.**
+
+- **Rank options and recommend a choice.** Evaluate available approaches and return an ordered list with a recommended answer.
+- **Check AI recommendations.** Compare supported options returned by a larger language model with a second recommendation.
+- **Recommend suitable personas.** Select from personas available to your project, including core, project, personal and installed premium personas.
+- **Reduce larger-model calls.** Evaluate supported choices through focused decision calls instead of sending the same options to a larger language model.
+- **Prioritise context.** Help order supporting context for coding and review tasks.
+- **Support additional checks.** Assess supplied claim evidence, classify sanitised failures and recommend supplementary impact reviews and tests.
+- **Choose your provider.** Select Jev, OpenAI Decisions or Automatic. Automatic prefers configured and authorised OpenAI access, then Jev.
+- **Configure through the CLI or dashboard.** Save API keys privately, enable either integration and select the uses you want.
+- **Choose shadow or active mode.** Shadow shows recommendations for comparison. Active can apply supported recommendations to context ordering and persona selection.
+- **Track usage and estimated cost.** View decision-call usage and set call and input-token limits.
+
+Both integrations are optional and start disabled. EWAI continues to work without either service.
+
+Install or update from the npm beta channel:
+
+```sh
+npm install --save-dev @thebackstoryis/engineering-with-ai@beta
+```

package/README.md

@@ -1,5 +1,28 @@
 # Engineering With AI
 
+## New in 0.3.4 Beta 6 release
+
+**EWAI now supports Jev and the OpenAI Decisions API.**
+
+- **Rank options and recommend a choice.** Evaluate available approaches and return an ordered list with a recommended answer.
+- **Check AI recommendations.** Compare supported options returned by a larger language model with a second recommendation.
+- **Recommend suitable personas.** Select from personas available to your project, including core, project, personal and installed premium personas.
+- **Reduce larger-model calls.** Evaluate supported choices through focused decision calls instead of sending the same options to a larger language model.
+- **Prioritise context.** Help order supporting context for coding and review tasks.
+- **Support additional checks.** Assess supplied claim evidence, classify sanitised failures and recommend supplementary impact reviews and tests.
+- **Choose your provider.** Select Jev, OpenAI Decisions or Automatic. Automatic prefers configured and authorised OpenAI access, then Jev.
+- **Configure through the CLI or dashboard.** Save API keys privately, enable either integration and select the uses you want.
+- **Choose shadow or active mode.** Shadow shows recommendations for comparison. Active can apply supported recommendations to context ordering and persona selection.
+- **Track usage and estimated cost.** View decision-call usage and set call and input-token limits.
+
+Both integrations are optional and start disabled. EWAI continues to work without either service.
+
+Install or update from the npm beta channel:
+
+```sh
+npm install --save-dev @thebackstoryis/engineering-with-ai@beta
+```
+
 Engineering With AI (EWAI) helps you plan, build and review software with an AI assistant. It gives the assistant a shared record of the project, a delivery workflow and checks against your engineering standards. You keep control of the decisions and approve implementation before it starts.
 
 [![Intent Studio in the EWAI dashboard: describing a feature, agreeing its acceptance criteria and engaging specialist personas before any code is written](https://www.conversationalcoding.dev/wp-content/uploads/sites/5/2026/09/intent-studio-full-be7758ffd224-1536x704.webp)](https://www.conversationalcoding.dev/engineering-with-ai-harness/?utm_source=readme&utm_medium=referral&utm_campaign=ewai)
@@ -18,7 +41,7 @@ ewai
 
 `ewai` opens your assistant and walks you through setting up the project. See [Install and start](#install-and-start) for details.
 
-Version `0.3.2` updates the package's links and documentation. The features below arrived in `0.3.1`.
+Versions `0.3.2` and `0.3.3` update the package's links and documentation. The features below arrived in `0.3.1`.
 
 ## New in 0.3.1: concise answers and Grok Build
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thebackstoryis/engineering-with-ai",
-  "version": "0.3.2",
+  "version": "0.3.4-beta.6",
   "description": "A human-centred, AI-augmented engineering pipeline",
   "license": "SEE LICENSE IN LICENSE",
   "author": "The Backstory Is",
@@ -25,7 +25,7 @@
     "type": "git",
     "url": "git+https://github.com/TheBackstoryIs/EngineeringWithAIHarness.git"
   },
-  "homepage": "https://www.conversationalcoding.dev/engineering-with-ai-harness/?utm_source=npm&utm_medium=referral&utm_campaign=ewai",
+  "homepage": "https://www.conversationalcoding.dev/ewai",
   "bugs": {
     "url": "https://github.com/TheBackstoryIs/EngineeringWithAIHarness/issues"
   },
@@ -51,7 +51,9 @@
     "tests/fixtures/context-benchmarks.json",
     "!config/*-source-manifest.json",
     "!config/workflow-migration-map.json",
-    "templates/"
+    "templates/",
+    "scripts/jev-experiment.mjs",
+    "tests/fixtures/jev-synthetic.json"
   ],
   "publishConfig": {
     "access": "public",
@@ -59,7 +61,7 @@
   },
   "scripts": {
     "build": "npm run check",
-    "precheck": "node scripts/publication-check.mjs --source-only && node --check src/runtime/tree-sitter-index.mjs && node --check src/design-system-application.mjs && node --check src/team-hub-resources.mjs && node --check src/dashboard-preferences.mjs && node --check public/dashboard-navigation.js && node --check src/config-document.mjs && node --check src/coding-providers.mjs && node --check src/runtime/grok-provider.mjs && node --check public/coding-providers.js && node --check src/grok-credentials.mjs && node --check public/grok-credentials.js",
+    "precheck": "node scripts/publication-check.mjs --source-only && node --check src/runtime/tree-sitter-index.mjs && node --check src/design-system-application.mjs && node --check src/team-hub-resources.mjs && node --check src/dashboard-preferences.mjs && node --check public/dashboard-navigation.js && node --check src/config-document.mjs && node --check src/coding-providers.mjs && node --check src/runtime/grok-provider.mjs && node --check public/coding-providers.js && node --check src/grok-credentials.mjs && node --check public/grok-credentials.js && node --check src/jev-credentials.mjs && node --check src/jev.mjs && node --check src/runtime/jev-operations.mjs && node --check public/jev.js && node --check public/jev-credentials.js && node --check scripts/jev-experiment.mjs && node --check src/openai-credentials.mjs && node --check src/openai-decisions.mjs && node --check public/openai-credentials.js",
     "publication:check": "node scripts/publication-check.mjs",
     "prepack": "node scripts/publication-check.mjs --quiet",
     "check": "node --check src/error-reporting.mjs && node --check src/team-hub.mjs && node --check src/runtime/team-hub-client.mjs && node --check src/runtime/team-hub-database.mjs && node --check src/runtime/team-hub-server.mjs && node --check src/runtime/team-hub.mjs && node --check src/runtime/error-reporting.mjs && node --check src/launcher.mjs && node --check src/afk-worker.mjs && node --check src/companion-opening.mjs && node --check src/companion.mjs && node --check src/cli.mjs && node --check src/checkin.mjs && node --check src/persona-licence-config.mjs && node --check src/persona-website-provider.mjs && node --check src/persona-zip.mjs && node --check src/persona-entitlements.mjs && node --check src/context.mjs && node --check src/archaeology.mjs && node --check src/evidence-depth.mjs && node --check src/prototype-iterations.mjs && node --check src/solution-readiness.mjs && node --check src/delivery-artifacts.mjs && node --check src/delivery-documents.mjs && node --check src/delivery-gates.mjs && node --check src/delivery.mjs && node --check src/design-systems.mjs && node --check src/design-system-authoring.mjs && node --check src/execution-state.mjs && node --check src/intent-dependencies.mjs && node --check src/task-graph.mjs && node --check src/test-scenarios.mjs && node --check src/security-validation-config.mjs && node --check src/starter-materialisation-contract.mjs && node --check src/validation-config.mjs && node --check src/project.mjs && node --check src/install.mjs && node --check src/intents.mjs && node --check src/intent-maps.mjs && node --check src/discovery.mjs && node --check src/packs.mjs && node --check src/organisation-blueprints.mjs && node --check src/organisation-policies.mjs && node --check src/policy-design-gates.mjs && node --check src/policy-gate-integration.mjs && node --check src/personas.mjs && node --check src/platform-metadata-analysis.mjs && node --check src/power-platform-source-map.mjs && node --check src/salesforce-source-map.mjs && node --check src/repository-source-map.mjs && node --check src/runtime/context-assembly.mjs && node --check src/runtime/context-benchmarks.mjs && node --check src/runtime/database.mjs && node --check src/runtime/execution-leases.mjs && node --check src/runtime/provider-adapters.mjs && node --check src/runtime/security-validation.mjs && node --check src/runtime/starter-materialisation.mjs && node --check src/runtime/policy-workspace.mjs && node --check src/runtime/lifecycle-hooks.mjs && node --check src/runtime/afk-conductor.mjs && node --check src/runtime/dashboard-actions.mjs && node --check src/runtime/dashboard-handoffs.mjs && node --check src/runtime/persona-engagement.mjs && node --check src/runtime/evidence-depth-workspace.mjs && node --check src/runtime/prototype-iterations.mjs && node --check src/runtime/guided-discovery.mjs && node --check src/runtime/guided-intents.mjs && node --check src/runtime/phase-contributions.mjs && node --check src/runtime/impact-analysis.mjs && node --check src/runtime/paths.mjs && node --check src/runtime/intents.mjs && node --check src/runtime/knowledge.mjs && node --check src/runtime/palace.mjs && node --check src/runtime/repository-index.mjs && node --check src/runtime/runs.mjs && node --check src/runtime/work.mjs && node --check src/runtime/version.mjs && node --check src/runtime/dashboard.mjs && node --check src/runtime/dashboard-server.mjs && node --check src/runtime/mcp-config.mjs && node --check src/runtime/mcp-server.mjs && node --check src/autonomy.mjs && node --check src/autonomy-phase-contracts.mjs && node --check src/autonomy-worker.mjs && node --check src/runtime/autonomy-supervisor.mjs && node --check src/runtime/autonomy-operations.mjs && node --check src/runtime/autonomy-workers.mjs && node --check src/runtime/autonomy-workspace.mjs && node --check public/autonomy.js && node --check public/app.js && node --check public/team-hub/app.js && node --check scripts/setup.mjs",

package/public/index.html

@@ -86,6 +86,65 @@
             <output id="grokCredentialNotice" role="status" aria-live="polite"></output>
           </div>
         </section>
+        <section class="configuration-group jev-configuration" aria-labelledby="jevTitle">
+          <header><div><h3 id="jevTitle">Decision assistance <span class="jev-beta">Beta</span></h3><p>Rank options, compare recommendations and find relevant reviewers before asking a larger model.</p></div></header>
+          <div class="jev-body">
+            <form id="jevSettingsForm">
+              <fieldset id="jevControls" disabled>
+                <legend>How decision assistance participates</legend>
+                <label class="jev-provider-label" for="jevProvider">Decision provider<select id="jevProvider"><option value="auto">Automatic — OpenAI first</option><option value="openai">OpenAI Decisions</option><option value="jev">Jev (TypeSafe)</option></select></label><p>Automatic uses a configured OpenAI key with OpenAI consent first, otherwise a configured Jev key with TypeSafe consent. API access is established by a decision attempt; Codex sign-in is separate.</p>
+                <div class="jev-modes">
+                  <label><input type="radio" name="jevMode" value="off" checked> Off <small>Use existing local decisions.</small></label>
+                  <label><input type="radio" name="jevMode" value="shadow"> Shadow — recommended first <small>Measure suggestions; keep existing automatic decisions.</small></label>
+                  <label><input type="radio" name="jevMode" value="active"> Active <small>Apply eligible context and persona advice. Required evidence and approvals remain.</small></label>
+                </div>
+                <fieldset><legend>Where decision assistance can help</legend><div id="jevUseCases" class="jev-use-cases"></div></fieldset>
+                <div class="jev-disclosure"><strong>Text processing by TypeSafe</strong><p>Enabled decisions send your focus and selected labels or descriptions to TypeSafe. Explicit claim and diagnostic checks can send eligible evidence you supply. Persona bodies and project source files are excluded from automatic ranking.</p><label><input id="jevCloudConsent" type="checkbox"> I accept TypeSafe text processing for enabled decisions.</label></div>
+                <div class="jev-disclosure"><strong>Text processing by OpenAI</strong><p>Enabled OpenAI decisions send the same eligible focus, labels, descriptions or supplied evidence to OpenAI. Persona bodies and project source files are excluded from automatic ranking.</p><label><input id="openaiCloudConsent" type="checkbox"> I accept OpenAI text processing for enabled decisions.</label></div>
+                <div class="jev-limits">
+                  <label>Maximum calls per saved policy<input id="jevMaxCalls" type="number" min="1" max="1000" required></label>
+                  <label>Input-token reservation budget<input id="jevMaxTokens" type="number" min="2000" max="1000000" required></label>
+                  <label>Timeout, milliseconds<input id="jevTimeout" type="number" min="100" max="10000" required></label>
+                  <label>Minimum confidence<input id="jevConfidence" type="number" min="0.5" max="1" step="0.01" required></label>
+                </div>
+                <p>Saving a new policy starts a new bounded budget. Timeouts or unknown usage stop further calls within that budget. Confidence is advisory.</p>
+              </fieldset>
+              <div class="coding-provider-actions"><button id="jevSettingsSave" type="submit" class="primary-action" disabled>Save decision settings</button><button id="jevRefresh" type="button" class="quiet-button">Refresh settings and measurements</button></div>
+              <output id="jevNotice" role="status" aria-live="polite">Loading decision settings…</output>
+            </form>
+            <section aria-labelledby="jevMeasurementsTitle"><h4 id="jevMeasurementsTitle">Measured results</h4><div id="jevMeasurements" aria-live="polite">Unknown — no measurements loaded.</div><p>Latency and cost describe the selected provider calls. Base estimates precede OpenAI free-cache adjustments and regional or long-context premiums. Downstream token savings and coding speed remain unknown until compared with equivalent work.</p></section>
+          </div>
+        </section>
+        <section class="configuration-group jev-credentials" aria-labelledby="jevCredentialsTitle">
+          <header><div><h3 id="jevCredentialsTitle">Jev API credentials</h3><p>Connect TypeSafe for bounded decision assistance. Saving a key leaves Jev off.</p></div></header>
+          <div class="jev-credentials-body">
+            <p id="jevCredentialStatus" role="status">Checking credential status…</p>
+            <form id="jevCredentialForm">
+              <label for="jevCredentialKey">TypeSafe API key</label>
+              <input id="jevCredentialKey" type="password" autocomplete="off" spellcheck="false" autocapitalize="off" maxlength="512" required aria-describedby="jevCredentialHelp" disabled>
+              <p id="jevCredentialHelp">Saved for your account on this computer, across EWAI projects, outside the project in an owner-only local file. The stored key is not encrypted. TYPESAFE_API_KEY overrides it.</p>
+              <div class="coding-provider-actions"><button id="jevCredentialSave" type="submit" class="primary-action" disabled>Check and save key</button><button id="jevCredentialCancel" type="button" class="quiet-button" disabled>Cancel key entry</button></div>
+            </form>
+            <div class="coding-provider-actions"><button id="jevCredentialCheck" type="button" class="quiet-button" disabled>Check connection</button><button id="jevCredentialRemove" type="button" class="quiet-button" disabled>Remove saved key</button><button id="jevCredentialRefresh" type="button" class="quiet-button">Refresh status</button></div>
+            <p>Checking authenticates with TypeSafe without generating output. It does not prove available credit or decision quality. Saving a key does not enable Jev.</p>
+            <output id="jevCredentialNotice" role="status" aria-live="polite"></output>
+          </div>
+        </section>
+        <section class="configuration-group openai-credentials" aria-labelledby="openaiCredentialsTitle">
+          <header><div><h3 id="openaiCredentialsTitle">OpenAI API credentials</h3><p>Connect OpenAI for bounded decision assistance. Saving a key does not enable decision assistance.</p></div></header>
+          <div class="openai-credentials-body">
+            <p id="openaiCredentialStatus" role="status">Checking credential status…</p>
+            <form id="openaiCredentialForm">
+              <label for="openaiCredentialKey">OpenAI API key</label>
+              <input id="openaiCredentialKey" type="password" autocomplete="off" spellcheck="false" autocapitalize="off" maxlength="512" required aria-describedby="openaiCredentialHelp" disabled>
+              <p id="openaiCredentialHelp">Saved for your account on this computer, across EWAI projects, outside the project in an owner-only local file. The stored key is not encrypted. OPENAI_API_KEY overrides it.</p>
+              <div class="coding-provider-actions"><button id="openaiCredentialSave" type="submit" class="primary-action" disabled>Check and save key</button><button id="openaiCredentialCancel" type="button" class="quiet-button" disabled>Cancel key entry</button></div>
+            </form>
+            <div class="coding-provider-actions"><button id="openaiCredentialCheck" type="button" class="quiet-button" disabled>Check connection</button><button id="openaiCredentialRemove" type="button" class="quiet-button" disabled>Remove saved key</button><button id="openaiCredentialRefresh" type="button" class="quiet-button">Refresh status</button></div>
+            <p>Checking authenticates with OpenAI without generating output. It does not prove Decisions access, available credit or decision quality. Saving a key does not enable decisions.</p>
+            <output id="openaiCredentialNotice" role="status" aria-live="polite"></output>
+          </div>
+        </section>
         <section class="configuration-group autonomy-configuration" aria-labelledby="autonomyConfigurationTitle">
           <header><div><h3 id="autonomyConfigurationTitle">Delegated delivery</h3><p>Choose an exact pool and limits. EWAI can progress only permitted work between your decisions.</p></div><strong id="autonomyMode" class="autonomy-mode">Checking…</strong></header>
           <div class="autonomy-configuration-body">
@@ -844,6 +903,9 @@
       </form>
     </dialog>
     <script src="/app.js" type="module"></script>
+    <script src="/jev.js" type="module"></script>
+    <script src="/jev-credentials.js" type="module"></script>
+    <script src="/openai-credentials.js" type="module"></script>
     <script src="/coding-providers.js" type="module"></script>
     <script src="/grok-credentials.js" type="module"></script>
   </body>

package/public/jev-credentials.js

@@ -0,0 +1,43 @@
+const element=id=>document.getElementById(id),form=element('jevCredentialForm'),field=element('jevCredentialKey');
+let saved=null,busy=false;
+function controls(){
+ field.disabled=busy||!saved||!saved.storageSupported;
+ element('jevCredentialSave').disabled=field.disabled;
+ element('jevCredentialCancel').disabled=busy;
+ element('jevCredentialCheck').disabled=busy||!saved?.configured;
+ element('jevCredentialRemove').disabled=busy||!saved?.saved;
+ element('jevCredentialRefresh').disabled=busy;
+}
+function adopt(data){
+ saved=data;
+ element('jevCredentialStatus').textContent=data.source==='environment'?'Using TYPESAFE_API_KEY from the launching environment. '+(data.saved?'A saved key is also available.':'No saved key.'):
+  data.source==='saved'?'Saved Jev key available for this account.':'No Jev key configured. Recommended: check and save a key below.';
+ if(data.storageIssue)element('jevCredentialStatus').textContent='Using TYPESAFE_API_KEY from the launching environment. Saved storage needs repair; saved key availability is unknown.';
+ if(data.storageSupported===false)element('jevCredentialStatus').textContent+=' Local key storage is unavailable on this platform; use the launching environment.';
+ controls();
+}
+async function request(action='',body){
+ const response=await fetch('/api/jev/credentials'+(action?'/'+action:''),{method:action?'POST':'GET',headers:action?{'content-type':'application/json'}:undefined,body:action?JSON.stringify(body):undefined});
+ let data;try{data=await response.json();}catch{throw Error('Credential setup could not be reached. Recheck the local dashboard connection.');}
+ if(!response.ok)throw Error(data.error??'Credential setup failed. Refresh status and try again.');return data;
+}
+async function load(){
+ busy=true;controls();
+ try{adopt(await request());}catch{saved=null;element('jevCredentialNotice').textContent='Credential status could not be read safely. Repair private storage or use TYPESAFE_API_KEY in the launching environment, then refresh.';}
+ finally{busy=false;controls();}
+}
+async function action(name){
+ if(busy||!saved)return;
+ const body={confirmed:true,...(name==='check'?{}:{expectedRevision:saved.revision}),...(name==='configure'?{apiKey:field.value}:{})};
+ field.value='';busy=true;controls();element('jevCredentialNotice').textContent=name==='remove'?'Removing saved key…':'Checking TypeSafe authentication without generated output…';
+ try{const result=await request(name,body);adopt(result);element('jevCredentialNotice').textContent=result.message;}
+ catch(error){element('jevCredentialNotice').textContent=error.message+' Refresh status before trying again.';}
+ finally{body.apiKey=undefined;field.value='';busy=false;controls();}
+}
+form.addEventListener('submit',event=>{event.preventDefault();void action('configure');});
+element('jevCredentialCancel').addEventListener('click',()=>{field.value='';element('jevCredentialNotice').textContent='Cancelled. Saved key retained.';});
+element('jevCredentialCheck').addEventListener('click',()=>void action('check'));
+element('jevCredentialRemove').addEventListener('click',()=>void action('remove'));
+element('jevCredentialRefresh').addEventListener('click',()=>{field.value='';element('jevCredentialNotice').textContent='';void load();});
+window.addEventListener('pagehide',()=>{field.value='';});
+controls();void load();

package/public/jev.js

@@ -0,0 +1,11 @@
+const el=id=>document.getElementById(id);
+const labels={context:'Context ordering',personas:'Available persona recommendations',skill:'Skills and answer options',claim:'Claim support checks',failure:'Failure triage',impact:'Supplemental impact reviews',tests:'Supplemental test relevance'};
+let saved=null,busy=false;
+for(const [id,title]of Object.entries(labels)){const label=document.createElement('label'),input=document.createElement('input');input.type='checkbox';input.name='jevUseCase';input.value=id;label.append(input,document.createTextNode(title));el('jevUseCases').append(label);}
+function controls(){el('jevControls').disabled=busy||!saved;el('jevSettingsSave').disabled=busy||!saved;el('jevRefresh').disabled=busy;}
+async function request(path,body){const response=await fetch('/api/jev/'+path,{method:body?'POST':'GET',headers:body?{'content-type':'application/json'}:undefined,body:body?JSON.stringify(body):undefined});let result;try{result=await response.json();}catch{throw Error('Decision settings could not be reached.');}if(!response.ok)throw Error(result.error??'Refresh Decision settings before trying again.');return result;}
+function adopt(value){saved=value;const p=value.policy;el('jevProvider').value=p.provider;el('openaiCloudConsent').checked=p.openaiConsent;document.querySelector(`input[name=jevMode][value=${p.mode}]`).checked=true;for(const input of document.querySelectorAll('input[name=jevUseCase]'))input.checked=p.useCases.includes(input.value);el('jevCloudConsent').checked=p.cloudConsent;el('jevMaxCalls').value=p.maxCalls;el('jevMaxTokens').value=p.maxInputTokens;el('jevTimeout').value=p.timeoutMs;el('jevConfidence').value=p.minConfidence;}
+async function measurements(){const data=await request('measurements'),s=data.summary;const list=document.createElement('dl');for(const [label,value]of [['Calls in recent history',s.providerCalls],['Cache hits in recent history',s.cacheHits],['Fallbacks in recent history',s.fallbacks],['Total recorded input tokens',s.inputTokens??'Unknown'],['Estimated provider cost, USD',s.estimatedUSD===null?'Unknown':s.estimatedUSD.toFixed(6)],['Median call latency',s.medianMs===null?'Unknown':s.medianMs+' ms'],['P95 call latency',s.p95Ms===null?'Unknown':s.p95Ms+' ms'],['Downstream savings','Unknown — not measured']]){const dt=document.createElement('dt'),dd=document.createElement('dd');dt.textContent=label;dd.textContent=String(value);list.append(dt,dd);}const budget=document.createElement('p');budget.textContent=`Current policy: ${data.budget.callsUsed}/${data.budget.maxCalls} calls; ${data.budget.reservedTokens}/${data.budget.maxInputTokens} reserved input tokens.`;el('jevMeasurements').replaceChildren(budget,list);}
+async function load(){busy=true;controls();try{adopt(await request('settings'));await measurements();el('jevNotice').textContent='Settings loaded. Recommended first enablement: shadow.';}catch(error){el('jevNotice').textContent=error.message;}finally{busy=false;controls();}}
+el('jevSettingsForm').addEventListener('submit',async event=>{event.preventDefault();if(busy||!saved)return;const policy={mode:document.querySelector('input[name=jevMode]:checked').value,useCases:[...document.querySelectorAll('input[name=jevUseCase]:checked')].map(i=>i.value),provider:el('jevProvider').value,openaiConsent:el('openaiCloudConsent').checked,cloudConsent:el('jevCloudConsent').checked,maxCalls:Number(el('jevMaxCalls').value),maxInputTokens:Number(el('jevMaxTokens').value),timeoutMs:Number(el('jevTimeout').value),minConfidence:Number(el('jevConfidence').value)};busy=true;controls();el('jevNotice').textContent='Saving Decision settings…';try{adopt(await request('settings',{confirmed:true,expectedRevision:saved.revision,policy}));await measurements();el('jevNotice').textContent='Decision settings saved. Mode: '+policy.mode+'.';}catch(error){el('jevNotice').textContent=error.message+' Refresh to compare the latest saved policy.';}finally{busy=false;controls();}});
+el('jevRefresh').addEventListener('click',()=>void load());controls();void load();

package/public/openai-credentials.js

@@ -0,0 +1,43 @@
+const element=id=>document.getElementById(id),form=element('openaiCredentialForm'),field=element('openaiCredentialKey');
+let saved=null,busy=false;
+function controls(){
+ field.disabled=busy||!saved||!saved.storageSupported;
+ element('openaiCredentialSave').disabled=field.disabled;
+ element('openaiCredentialCancel').disabled=busy;
+ element('openaiCredentialCheck').disabled=busy||!saved?.configured;
+ element('openaiCredentialRemove').disabled=busy||!saved?.saved;
+ element('openaiCredentialRefresh').disabled=busy;
+}
+function adopt(data){
+ saved=data;
+ element('openaiCredentialStatus').textContent=data.source==='environment'?'Using OPENAI_API_KEY from the launching environment. '+(data.saved?'A saved key is also available.':'No saved key.'):
+  data.source==='saved'?'Saved OpenAI key available for this account.':'No OpenAI key configured. Recommended: check and save a key below.';
+ if(data.storageIssue)element('openaiCredentialStatus').textContent='Using OPENAI_API_KEY from the launching environment. Saved storage needs repair; saved key availability is unknown.';
+ if(data.storageSupported===false)element('openaiCredentialStatus').textContent+=' Local key storage is unavailable on this platform; use the launching environment.';
+ controls();
+}
+async function request(action='',body){
+ const response=await fetch('/api/openai/credentials'+(action?'/'+action:''),{method:action?'POST':'GET',headers:action?{'content-type':'application/json'}:undefined,body:action?JSON.stringify(body):undefined});
+ let data;try{data=await response.json();}catch{throw Error('Credential setup could not be reached. Recheck the local dashboard connection.');}
+ if(!response.ok)throw Error(data.error??'Credential setup failed. Refresh status and try again.');return data;
+}
+async function load(){
+ busy=true;controls();
+ try{adopt(await request());}catch{saved=null;element('openaiCredentialNotice').textContent='Credential status could not be read safely. Repair private storage or use OPENAI_API_KEY in the launching environment, then refresh.';}
+ finally{busy=false;controls();}
+}
+async function action(name){
+ if(busy||!saved)return;
+ const body={confirmed:true,...(name==='check'?{}:{expectedRevision:saved.revision}),...(name==='configure'?{apiKey:field.value}:{})};
+ field.value='';busy=true;controls();element('openaiCredentialNotice').textContent=name==='remove'?'Removing saved key…':'Checking OpenAI authentication without generated output…';
+ try{const result=await request(name,body);adopt(result);element('openaiCredentialNotice').textContent=result.message;}
+ catch(error){element('openaiCredentialNotice').textContent=error.message+' Refresh status before trying again.';}
+ finally{body.apiKey=undefined;field.value='';busy=false;controls();}
+}
+form.addEventListener('submit',event=>{event.preventDefault();void action('configure');});
+element('openaiCredentialCancel').addEventListener('click',()=>{field.value='';element('openaiCredentialNotice').textContent='Cancelled. Saved key retained.';});
+element('openaiCredentialCheck').addEventListener('click',()=>void action('check'));
+element('openaiCredentialRemove').addEventListener('click',()=>void action('remove'));
+element('openaiCredentialRefresh').addEventListener('click',()=>{field.value='';element('openaiCredentialNotice').textContent='';void load();});
+window.addEventListener('pagehide',()=>{field.value='';});
+controls();void load();

package/public/styles.css

@@ -19,6 +19,26 @@
   --shadow: 0 12px 32px rgb(23 33 28 / 12%);
 }
 
+.jev-body { display: grid; gap: 24px; padding: 20px; }
+.jev-body form, .jev-body fieldset { display: grid; gap: 14px; min-width: 0; }
+.jev-body fieldset { margin: 0; padding: 14px; border: 1px solid var(--line); border-radius: 6px; }
+.jev-body legend, .jev-body h4 { font-weight: 700; }
+.jev-body p { color: var(--muted); line-height: 1.5; }
+.jev-beta { font-size: 11px; color: var(--green); background: var(--green-soft); padding: 4px 7px; border-radius: 6px; }
+.jev-modes { display: grid; gap: 12px; }
+.jev-modes label { display: grid; grid-template-columns: 20px minmax(0, 1fr); align-items: center; min-height: 44px; }
+.jev-modes small { grid-column: 2; color: var(--muted); }
+.jev-use-cases, .jev-limits { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; }
+.jev-use-cases label, .jev-disclosure label { display: flex; align-items: center; gap: 8px; min-height: 44px; }
+.jev-limits label { display: grid; gap: 7px; }
+.jev-limits input { width: 100%; min-height: 42px; padding: 8px; border: 1px solid var(--line-strong); border-radius: 6px; }
+.jev-body input { accent-color: var(--green); }
+.jev-disclosure { padding: 14px; background: var(--surface-2); border: 1px solid var(--line); border-radius: 6px; }
+#jevMeasurements dl { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: 10px 18px; }
+#jevMeasurements dd { margin: 0; overflow-wrap: anywhere; font-variant-numeric: tabular-nums; }
+.jev-body button:focus-visible, .jev-body input:focus-visible { outline: 2px solid var(--green); outline-offset: 2px; }
+@media (max-width: 600px) { .jev-body { padding: 14px; } .jev-use-cases, .jev-limits { grid-template-columns: minmax(0, 1fr); } }
+
 * { box-sizing: border-box; }
 html, body { width: 100%; height: 100%; }
 body {
@@ -2776,7 +2796,11 @@ button:focus-visible, input:focus-visible, select:focus-visible, textarea:focus-
   .autonomy-button-row button { width: 100%; }
   .autonomy-dialog .action-sheet > footer { flex-wrap: wrap; }
 }
-.grok-credentials-body { padding: 18px; display: grid; gap: 14px; }
-.grok-credentials-body form { display: grid; gap: 12px; }
-.grok-credentials-body input { width: 100%; box-sizing: border-box; min-height: 40px; border: 1px solid var(--line, #cfd8d5); border-radius: 6px; padding: 8px 10px; }
-.grok-credentials-body p { margin: 0; }
+:is(.grok-credentials-body, .jev-credentials-body, .openai-credentials-body) { padding: 18px; display: grid; gap: 14px; }
+:is(.grok-credentials-body, .jev-credentials-body, .openai-credentials-body) form { display: grid; gap: 12px; }
+:is(.grok-credentials-body, .jev-credentials-body, .openai-credentials-body) input { width: 100%; box-sizing: border-box; min-height: 40px; border: 1px solid var(--line, #cfd8d5); border-radius: 6px; padding: 8px 10px; }
+:is(.grok-credentials-body, .jev-credentials-body, .openai-credentials-body) p { margin: 0; }
+
+.jev-provider-label { display: grid; gap: 7px; }
+#jevProvider { width: 100%; min-width: 0; min-height: 44px; box-sizing: border-box; padding: 8px; border: 1px solid var(--line-strong); border-radius: 6px; background: var(--surface); color: var(--ink); }
+#jevProvider:focus-visible { outline: 2px solid var(--green); outline-offset: 2px; }

package/scripts/jev-experiment.mjs

@@ -0,0 +1,15 @@
+import {readFileSync} from 'node:fs';
+import {decideWithJev} from '../src/runtime/jev-operations.mjs';
+import {readJevMeasurements} from '../src/jev.mjs';
+
+// Import-safe runner: the CLI owns policy and key capture. This never enables
+// Jev, widens budgets, captures credentials or uploads project evidence.
+export async function runJevExperiment(root,options={}){
+ const limit=options.limit??6;
+ if(!Number.isInteger(limit)||limit<1||limit>6){const e=Error('Choose an experiment limit from 1 to 6.');e.code='jev-input';throw e;}
+ const fixtures=JSON.parse(readFileSync(new URL('../tests/fixtures/jev-synthetic.json',import.meta.url),'utf8')).slice(0,limit),results=[];
+ const before=readJevMeasurements(root);
+ for(const fixture of fixtures){const result=await decideWithJev(root,fixture.input,options);results.push({id:fixture.id,expected:fixture.expected,actual:result.decision,status:result.status,reason:result.reason,correct:result.status==='suggested'?result.decision===fixture.expected:null,validation:result.validation,measurement:result.measurement??null});}
+ const after=readJevMeasurements(root);
+ return {schema:'ewai.jev-experiment/v1',dataset:'six synthetic challenge cases; not representative coding evaluation',results,summary:{evaluated:results.filter(r=>r.correct!==null).length,correct:results.filter(r=>r.correct===true).length,providerCalls:results.filter(r=>r.measurement?.providerCall).length,inputTokens:results.every(r=>r.measurement?.inputTokens!==null)?results.reduce((sum,r)=>sum+(r.measurement?.inputTokens??0),0):null,downstreamSavings:null},before:before.summary,after:after.summary};
+}