diff --git a/README.md b/README.md index 6ff02763..b756802e 100644 --- a/README.md +++ b/README.md @@ -427,6 +427,7 @@ The [independent model research](community/projects/tools/README.md#independent- - [Open Alternative to Jev](https://github.com/ikermoel/open-alternative-jev) - Studies typed decisions from open models using packed or separate inference and optional calibration; independent of TypeSafe Jev. [Project guide](community/projects/tools/open-alternative-jev.md). - [open-jev](https://github.com/nico-martin/open-jev) - Runs independent Kev and DeBERTa typed-decision models locally through Transformers.js, with browser WebGPU/WASM support; does not use official Jev weights. [Project guide](community/projects/tools/open-jev.md). - [openclaw-typesafe-ai](https://github.com/Olli0103/openclaw-typesafe-ai) - OpenClaw plugin registering optional `typesafe_decide` for explicit TypeSafe Jev decisions (SecretRef credentials; no hooks). [Project guide](community/projects/tools/openclaw-typesafe-ai.md). +- [opencode-jev-guard](https://github.com/CogFlux/opencode-jev-guard) - OpenCode 2 plugin: TypeSafe Jev triages every local/FarHand shell command before run (distinct from leepokai/jev-guard). [Project guide](community/projects/tools/opencode-jev-guard.md). - [opencode-smart-reasoning](https://github.com/d0nj/opencode-smart-reasoning) - OpenCode plugin: TypeSafe Jev (Zen SystemOne) picks per-request reasoning effort, fail-open without a key. [Project guide](community/projects/tools/opencode-smart-reasoning.md). - [omp-jev-compaction](https://github.com/jerryfane/omp-jev-compaction) - omp plugin: verbatim TypeSafe/OpenRouter Jev-scored tool-context reduction with sticky cache-friendly rewrites (distinct from fast-jev-compaction / jev-compact). [Project guide](community/projects/tools/omp-jev-compaction.md). - [openjev-sglang](https://github.com/ekzhang/openjev-sglang) - Implements a Jev-shaped HTTP decision API using Qwen and SGLang; independent model behavior and unspecified code licensing. [Project guide](community/projects/tools/openjev-sglang.md). diff --git a/community/projects/tools/README.md b/community/projects/tools/README.md index 1f3cb95e..10f3e59d 100644 --- a/community/projects/tools/README.md +++ b/community/projects/tools/README.md @@ -213,6 +213,7 @@ See the [computer-use guide](../../../docs/computer-use.md) for a comparison, fo | [Moongate](moongate.md) | Evaluate PR diffs against JSON semantic rules with TypeSafe Jev and emit CI annotations. | MoonBit / GitHub Action (`brickfrog/moongate`) | | [mayi](mayi.md) | Tool-call gate for Claude Code/Cursor/Codex: TypeSafe Jev scores each call; dialog on unsafe (fail-deny on errors). | Rust · CLI (`mayi` 0.1.0) | | [openclaw-typesafe-ai](openclaw-typesafe-ai.md) | Add an optional OpenClaw `typesafe_decide` tool for explicit TypeSafe Jev judgments without lifecycle hooks. | TypeScript · OpenClaw plugin (`openclaw-typesafe-ai` 0.1.3) | +| [opencode-jev-guard](opencode-jev-guard.md) | OpenCode 2 plugin: TypeSafe Jev triages every local/FarHand shell command before run. | TypeScript · OpenCode plugin (`opencode-jev-guard` 0.1.0, MIT) | | [opencode-smart-reasoning](opencode-smart-reasoning.md) | Route OpenCode per-request reasoning effort with TypeSafe Jev via Zen SystemOne (fail-open). | TypeScript · OpenCode plugin (`opencode-smart-reasoning` 0.2.0) | | [omp-jev-compaction](omp-jev-compaction.md) | Reduce omp tool context with sticky TypeSafe/OpenRouter Jev scores while keeping retained text verbatim. | TypeScript · omp plugin (`omp-jev-compaction` 0.1.0) | | [PDF Race](pdf-race.md) | Race Docling→TypeSafe Jev vs Gemini on the same PDFs with committed keyless replays. | Node.js ≥ 20 · local/Vercel bench (`pdf-race` 1.0.0) | diff --git a/community/projects/tools/opencode-jev-guard.md b/community/projects/tools/opencode-jev-guard.md new file mode 100644 index 00000000..61472e36 --- /dev/null +++ b/community/projects/tools/opencode-jev-guard.md @@ -0,0 +1,47 @@ +# opencode-jev-guard + +[All projects](../README.md) · [Developer tools](README.md#developer-tools) + +OpenCode 2 plugin: every local `shell` (and FarHand remote shell) command is judged by TypeSafe Jev before run—overall verdict plus host-litter / global-install / global-config / harmful / privacy risks. Distinct from [leepokai/jev-guard](jev-guard.md) multi-agent hooks. + +| At a glance | Details | +| --- | --- | +| Source | [Source](https://github.com/CogFlux/opencode-jev-guard) | +| Maintainer | [CogFlux](https://github.com/CogFlux). Independently curated; this entry is not an upstream submission or endorsement. | +| Format | TypeScript OpenCode plugin **opencode-jev-guard 0.1.0** (`jev-guard.ts`; private package layout). | +| Requirements | OpenCode 2; TypeSafe API key via plugin options or env. Fail-ask when Jev is unreachable (never silent allow). | +| License | [MIT](https://github.com/CogFlux/opencode-jev-guard/blob/8c304cbcd97ec670152e8ede93d10b98fc760332/LICENSE). | +| Disclosure | AI-assisted catalog review; no affiliation. Listing is not an endorsement. Source inspected (README, LICENSE, package, plugin entry). Live OpenCode/FarHand/Jev runs were **not** executed on the review host. | + +## When to use + +Use it when OpenCode (optionally with FarHand) should confirm risky shell before execution with typed Jev categories you can retune. Prefer [jev-guard](jev-guard.md) for multi-host agent installs; prefer [fast-jev-opencode](fast-jev-opencode.md) for request compaction rather than shell permission. + +## How it works + +Before shell/MCP remote shell execute, the plugin asks Jev six questions (verdict + five risk noul-style categories). Safe only if verdict is `run` above `minConfidence` and all risks below thresholds; otherwise OpenCode’s permission prompt (with a transcript note, because OpenCode’s prompt body may omit reasons). Global vs project `jev-guard.jsonc`: project files can only tighten. `/jev on|off|status|risks` session commands. + +## Get started + +```sh +git clone https://github.com/CogFlux/opencode-jev-guard.git +cd opencode-jev-guard +git checkout 8c304cbcd97ec670152e8ede93d10b98fc760332 +npm test # node --test; offline fixtures +# Install/register as an OpenCode 2 plugin per upstream README; set TypeSafe key +``` + +## Examples and demos + +- `jev-guard.example.jsonc` documented options. +- `bench/cases.jsonl` + `bench/run.ts`; `test/` fixtures including FarHand project sample. + +## Limits and data handling + +Command text (and remote host/workdir context for FarHand) leave the machine for TypeSafe. `/jev off` disables confirmation (deny rules in OpenCode permission config still apply). This listing did not install OpenCode or call Jev. + +## Review and maintenance + +Reviewed on **2026-09-23** at [commit 8c304cb](https://github.com/CogFlux/opencode-jev-guard/tree/8c304cbcd97ec670152e8ede93d10b98fc760332) (**0.1.0**, MIT). AI-assisted source review of README, LICENSE, package. No live TypeSafe spend. + +Related: [jev-guard](jev-guard.md), [fast-jev-opencode](fast-jev-opencode.md), [agent-chaperone](agent-chaperone.md).