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
{{ message }}
Repository navigation
Commit dd90aba
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: AGENTS.md
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,12 @@ These instructions apply throughout the repository unless a more specific `AGENT
4
4
5
5
Start with `README.md`, then `docs/architecture.md`, `docs/roadmap.md`, and the code and tests for the module being changed. Read before editing.
6
6
7
+
Use `docs/development.md` for task-to-file ownership, failure tracing, performance
8
+
measurement, and PR delivery. Run `pnpm verify` before committing: import
9
+
boundaries, typecheck, offline tests, production build, and secret patterns.
10
+
`pnpm check:boundaries` checks the compiler-resolved pure dependency graph; it
11
+
does not replace review of runtime behavior or host authorization.
12
+
7
13
## What this project is
8
14
9
15
A coding-agent harness in which an LLM proposes one action, TypeSafe AI's Jev answers four narrow yes/no (`noul`) questions about it, and pure code turns those answers into one of four verdicts: `permit`, `proposal_only`, `reject`, `unavailable`. A host constructs and stores each receipt; a fixture-bench runner in `src/benchmark/` records receipts for synthetic fixtures only. Nothing in this repository executes a proposal.
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+10-4Lines changed: 10 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,16 +4,22 @@ This is an independent community harness for TypeSafe AI's Jev. Useful contribut
4
4
5
5
Read [README.md](README.md) for the contract and [AGENTS.md](AGENTS.md) for boundaries. Keep changes focused; do not bundle dependency upgrades, provider transports, or new execution authority into a fixture or documentation fix.
6
6
7
+
Use the [development guide](docs/development.md) to find the owning module,
8
+
trace failures, measure performance, and prepare a reviewable PR.
9
+
7
10
## Development
8
11
9
12
```sh
10
13
pnpm install --frozen-lockfile # also installs the pre-commit secret check (.githooks/)
11
-
pnpm typecheck
12
-
pnpm test
13
-
pnpm check:secrets # what the hook and CI run; gitleaks adds more if installed
Tests run offline. Nothing here needs a TypeSafe API key, and no key should ever be in a commit; see [SECURITY.md](SECURITY.md) for the guards and what to do if one slips.
17
+
Tests run offline. Verification needs no TypeSafe API key, and no key should ever be in a commit; see [SECURITY.md](SECURITY.md) for the guards and what to do if one slips.
18
+
19
+
Explicit live demo comparisons require a TypeSafe API key.
20
+
CI additionally checks real sharing responses and scans full history with
21
+
gitleaks. Run the relevant browser verifiers for interface changes; report
22
+
human accessibility and live-provider acceptance separately.
exportdefaultfunctionLayout({ children }: {children: ReactNode}){
22
-
return<htmllang="en"><body><aclassName="skip"href="#arena-workspace">Skip to arena</a><Header/>{children}</body></html>;
22
+
return<htmllang="en"><head><linkrel="preload"href="/fonts/ibm-plex-sans-latin.woff2"as="font"type="font/woff2"crossOrigin="anonymous"/></head><body><aclassName="skip"href="#arena-workspace">Skip to arena</a><Header/>{children}</body></html>;
<divclassName="arena-intro"><div><pclassName="eyebrow">{view==="integrate" ? "Adapt · measure · improve" : "Jev Harness / Agent experiments"}</p><h1>{view==="integrate" ? "Build on your own harness" : "One task. Two tool menus"}<span>.</span></h1><p>{view==="integrate" ? "Take the routing boundary into your host with a concrete brief and a repeatable evaluation plan." : "Compare Codex with and without Jev routing. Keep the evidence and watch performance over time."}</p></div><spanclassName="local-label">{view==="integrate" ? "No request required" : "Stored on this device"}</span></div>
123
124
<divclassName="studio-context"><span>Independent community project</span><span>Synthetic fixtures only</span><span>Evidence, not authorization</span><ahref="https://ui.jev.works"target="_blank"rel="noopener noreferrer">TypeSafe UI ↗</a></div>
<sectionclassName="arena-controls"aria-label="Comparison controls"hidden={view==="integrate"}><ArenaExamplesselected={caseId}disabled={pending||!history.ready}counts={Object.fromEntries(ARENA_CASES.map(item=>[item.id,history.runs.filter(run=>run.fixture.id===item.id).length]))}onChange={id=>{cancel(true);setCaseId(id);setStatus("Ready to compare.");}}/><divclassName="arena-task-preview"><div><span>{view==="compare"&&selectedRun ? "Saved task" : "Task preview"}</span><pclassName="arena-task">{view==="compare" ? shownFixture.task : fixture.task}</p></div><divclassName="arena-run-actions"><buttonclassName="primary"disabled={pending||!history.ready}onClick={()=>voidrun()}>{pending ? "Comparing…" : "Run comparison ↗"}</button>{pending&&<buttonclassName="quiet"onClick={()=>cancel()}>Cancel</button>}</div></div><divclassName="arena-control-bottom"><prole="status"id="arena-status"className={`arena-status ${pending ? "is-running" : ""}`}>{pending&&<spanclassName="activity-dot"aria-hidden="true"/>}{selectedRun&&!pending ? `${selectedRun.status==="complete" ? "Completed" : selectedRun.status==="cancelled" ? "Cancelled" : selectedRun.status==="failed" ? "Failed" : "Partial"} run · ${runTime(selectedRun.finishedAt)}` : status}</p><divclassName="arena-method"><DetailPaneltitle="How the comparison works"trigger="How the comparison works"><p>One logical routing call with all physical requests recorded, then two parallel Codex CLI runs using your local sign-in. Without Jev sees all fixture tools; With Jev sees the selected tools plus any reading prerequisites. Both use the same synthetic task.</p><p>Read-only settings. Proposed patches are recorded, never applied. The inspector tool is deterministic. Independent model choices and cache effects can change results; no answer-quality score is inferred.</p></DetailPanel></div></div></section>
126
+
<sectionclassName="arena-controls"aria-label="Comparison controls"hidden={view==="integrate"}><ArenaExamplesselected={caseId}disabled={pending||!history.ready}counts={exampleCounts}onChange={id=>{cancel(true);setCaseId(id);setStatus("Ready to compare.");}}/><divclassName="arena-task-preview"><div><span>{view==="compare"&&selectedRun ? "Saved task" : "Task preview"}</span><pclassName="arena-task">{view==="compare" ? shownFixture.task : fixture.task}</p></div><divclassName="arena-run-actions"><buttonclassName="primary"disabled={pending||!history.ready}onClick={()=>voidrun()}>{pending ? "Comparing…" : "Run comparison ↗"}</button>{pending&&<buttonclassName="quiet"onClick={()=>cancel()}>Cancel</button>}</div></div><divclassName="arena-control-bottom"><prole="status"id="arena-status"className={`arena-status ${pending ? "is-running" : ""}`}>{pending&&<spanclassName="activity-dot"aria-hidden="true"/>}{selectedRun&&!pending ? `${selectedRun.status==="complete" ? "Completed" : selectedRun.status==="cancelled" ? "Cancelled" : selectedRun.status==="failed" ? "Failed" : "Partial"} run · ${runTime(selectedRun.finishedAt)}` : status}</p><divclassName="arena-method"><DetailPaneltitle="How the comparison works"trigger="How the comparison works"><p>One logical routing call with all physical requests recorded, then two parallel Codex CLI runs using your local sign-in. Without Jev sees all fixture tools; With Jev sees the selected tools plus any reading prerequisites. Both use the same synthetic task.</p><p>Read-only settings. Proposed patches are recorded, never applied. The inspector tool is deterministic. Independent model choices and cache effects can change results; no answer-quality score is inferred.</p></DetailPanel></div></div></section>
{selectedRun&&!pending&&(selectedRun.status==="failed"||selectedRun.status==="partial")&&<pclassName="cache-error"role="alert"><strong>Comparison did not complete.</strong>{selectedRun.message}</p>}
0 commit comments