jev-affected 0.1.0

package/dist/provider.js

@@ -0,0 +1,28 @@
+import { noul, TypeSafeClient } from "@typesafe-ai/sdk";
+export class JevProvider {
+    async analyze(input) {
+        const client = new TypeSafeClient({
+            logLevel: "off",
+            timeout: input.timeoutMs,
+            retry: { maxRetries: 0 },
+        });
+        const response = await client.systemOne({
+            model: input.model,
+            state: {
+                base: input.state.base,
+                head: input.state.head,
+                files: input.state.files.map((f) => ({ ...f })),
+                diff: input.state.diff,
+            },
+            questions: Object.fromEntries(Object.entries(input.questions).map(([id, q]) => [id, noul(q)])),
+        });
+        return {
+            model: response.model,
+            probabilities: Object.fromEntries(Object.entries(response.answers).map(([id, a]) => [
+                id,
+                a.type === "noul" ? a.noul : Number.NaN,
+            ])),
+            usage: response.usage,
+        };
+    }
+}

package/evals/fixtures/api-response-field.json

@@ -0,0 +1,53 @@
+{
+  "name": "api-response-field",
+  "provenance": "Synthetic SDK-shaped responses, not recorded Jev output; live model quality is unverified.",
+  "config": {
+    "version": 1,
+    "tasks": {
+      "auth": {
+        "command": "node -e \"console.log('auth tests')\"",
+        "when": "Could authentication, session or cookie behavior change?"
+      },
+      "sdk": {
+        "command": "node -e \"console.log('SDK generation')\"",
+        "when": "Could the public API contract change?"
+      },
+      "db": {
+        "command": "node -e \"console.log('database tests')\"",
+        "when": "Could database schemas or persistence change?"
+      },
+      "benchmark": {
+        "command": "node -e \"console.log('benchmark')\"",
+        "when": "Could a performance-sensitive execution path materially change?"
+      }
+    }
+  },
+  "state": {
+    "base": "fixture-base",
+    "head": "fixture-head",
+    "files": [
+      {
+        "path": "src/api.ts",
+        "status": "M"
+      }
+    ],
+    "diff": "diff --git a/src/api.ts b/src/api.ts\n--- a/src/api.ts\n+++ b/src/api.ts\n@@ -1 +1 @@\n-return {id}\n+return {id, name}\n",
+    "incomplete": false,
+    "warnings": []
+  },
+  "response": {
+    "model": "jev-1.13.0",
+    "probabilities": {
+      "auth": 0.01,
+      "sdk": 0.95,
+      "db": 0.01,
+      "benchmark": 0.01
+    }
+  },
+  "expected": {
+    "auth": "skip",
+    "sdk": "run",
+    "db": "skip",
+    "benchmark": "skip"
+  }
+}

package/evals/fixtures/auth-session-ttl.json

@@ -0,0 +1,53 @@
+{
+  "name": "auth-session-ttl",
+  "provenance": "Synthetic SDK-shaped responses, not recorded Jev output; live model quality is unverified.",
+  "config": {
+    "version": 1,
+    "tasks": {
+      "auth": {
+        "command": "node -e \"console.log('auth tests')\"",
+        "when": "Could authentication, session or cookie behavior change?"
+      },
+      "sdk": {
+        "command": "node -e \"console.log('SDK generation')\"",
+        "when": "Could the public API contract change?"
+      },
+      "db": {
+        "command": "node -e \"console.log('database tests')\"",
+        "when": "Could database schemas or persistence change?"
+      },
+      "benchmark": {
+        "command": "node -e \"console.log('benchmark')\"",
+        "when": "Could a performance-sensitive execution path materially change?"
+      }
+    }
+  },
+  "state": {
+    "base": "fixture-base",
+    "head": "fixture-head",
+    "files": [
+      {
+        "path": "src/auth.ts",
+        "status": "M"
+      }
+    ],
+    "diff": "diff --git a/src/auth.ts b/src/auth.ts\n--- a/src/auth.ts\n+++ b/src/auth.ts\n@@ -1 +1 @@\n-const TTL = 3600\n+const TTL = 86400\n",
+    "incomplete": false,
+    "warnings": []
+  },
+  "response": {
+    "model": "jev-1.13.0",
+    "probabilities": {
+      "auth": 0.95,
+      "sdk": 0.01,
+      "db": 0.01,
+      "benchmark": 0.01
+    }
+  },
+  "expected": {
+    "auth": "run",
+    "sdk": "skip",
+    "db": "skip",
+    "benchmark": "skip"
+  }
+}

package/evals/fixtures/comment-only.json

@@ -0,0 +1,53 @@
+{
+  "name": "comment-only",
+  "provenance": "Synthetic SDK-shaped responses, not recorded Jev output; live model quality is unverified.",
+  "config": {
+    "version": 1,
+    "tasks": {
+      "auth": {
+        "command": "node -e \"console.log('auth tests')\"",
+        "when": "Could authentication, session or cookie behavior change?"
+      },
+      "sdk": {
+        "command": "node -e \"console.log('SDK generation')\"",
+        "when": "Could the public API contract change?"
+      },
+      "db": {
+        "command": "node -e \"console.log('database tests')\"",
+        "when": "Could database schemas or persistence change?"
+      },
+      "benchmark": {
+        "command": "node -e \"console.log('benchmark')\"",
+        "when": "Could a performance-sensitive execution path materially change?"
+      }
+    }
+  },
+  "state": {
+    "base": "fixture-base",
+    "head": "fixture-head",
+    "files": [
+      {
+        "path": "src/auth.ts",
+        "status": "M"
+      }
+    ],
+    "diff": "diff --git a/src/auth.ts b/src/auth.ts\n--- a/src/auth.ts\n+++ b/src/auth.ts\n@@ -1 +1 @@\n-// session\n+// session duration\n",
+    "incomplete": false,
+    "warnings": []
+  },
+  "response": {
+    "model": "jev-1.13.0",
+    "probabilities": {
+      "auth": 0.01,
+      "sdk": 0.01,
+      "db": 0.01,
+      "benchmark": 0.01
+    }
+  },
+  "expected": {
+    "auth": "skip",
+    "sdk": "skip",
+    "db": "skip",
+    "benchmark": "skip"
+  }
+}

package/evals/fixtures/db-schema.json

@@ -0,0 +1,53 @@
+{
+  "name": "db-schema",
+  "provenance": "Synthetic SDK-shaped responses, not recorded Jev output; live model quality is unverified.",
+  "config": {
+    "version": 1,
+    "tasks": {
+      "auth": {
+        "command": "node -e \"console.log('auth tests')\"",
+        "when": "Could authentication, session or cookie behavior change?"
+      },
+      "sdk": {
+        "command": "node -e \"console.log('SDK generation')\"",
+        "when": "Could the public API contract change?"
+      },
+      "db": {
+        "command": "node -e \"console.log('database tests')\"",
+        "when": "Could database schemas or persistence change?"
+      },
+      "benchmark": {
+        "command": "node -e \"console.log('benchmark')\"",
+        "when": "Could a performance-sensitive execution path materially change?"
+      }
+    }
+  },
+  "state": {
+    "base": "fixture-base",
+    "head": "fixture-head",
+    "files": [
+      {
+        "path": "schema.sql",
+        "status": "M"
+      }
+    ],
+    "diff": "diff --git a/schema.sql b/schema.sql\n--- a/schema.sql\n+++ b/schema.sql\n@@ -1 +1 @@\n-name TEXT\n+name VARCHAR(100)\n",
+    "incomplete": false,
+    "warnings": []
+  },
+  "response": {
+    "model": "jev-1.13.0",
+    "probabilities": {
+      "auth": 0.01,
+      "sdk": 0.01,
+      "db": 0.95,
+      "benchmark": 0.01
+    }
+  },
+  "expected": {
+    "auth": "skip",
+    "sdk": "skip",
+    "db": "run",
+    "benchmark": "skip"
+  }
+}

package/evals/fixtures/docs-only.json

@@ -0,0 +1,53 @@
+{
+  "name": "docs-only",
+  "provenance": "Synthetic SDK-shaped responses, not recorded Jev output; live model quality is unverified.",
+  "config": {
+    "version": 1,
+    "tasks": {
+      "auth": {
+        "command": "node -e \"console.log('auth tests')\"",
+        "when": "Could authentication, session or cookie behavior change?"
+      },
+      "sdk": {
+        "command": "node -e \"console.log('SDK generation')\"",
+        "when": "Could the public API contract change?"
+      },
+      "db": {
+        "command": "node -e \"console.log('database tests')\"",
+        "when": "Could database schemas or persistence change?"
+      },
+      "benchmark": {
+        "command": "node -e \"console.log('benchmark')\"",
+        "when": "Could a performance-sensitive execution path materially change?"
+      }
+    }
+  },
+  "state": {
+    "base": "fixture-base",
+    "head": "fixture-head",
+    "files": [
+      {
+        "path": "README.md",
+        "status": "M"
+      }
+    ],
+    "diff": "diff --git a/README.md b/README.md\n--- a/README.md\n+++ b/README.md\n@@ -1 +1 @@\n-Install\n+Installation\n",
+    "incomplete": false,
+    "warnings": []
+  },
+  "response": {
+    "model": "jev-1.13.0",
+    "probabilities": {
+      "auth": 0.01,
+      "sdk": 0.01,
+      "db": 0.01,
+      "benchmark": 0.01
+    }
+  },
+  "expected": {
+    "auth": "skip",
+    "sdk": "skip",
+    "db": "skip",
+    "benchmark": "skip"
+  }
+}

package/evals/fixtures/logging-only.json

@@ -0,0 +1,53 @@
+{
+  "name": "logging-only",
+  "provenance": "Synthetic SDK-shaped responses, not recorded Jev output; live model quality is unverified.",
+  "config": {
+    "version": 1,
+    "tasks": {
+      "auth": {
+        "command": "node -e \"console.log('auth tests')\"",
+        "when": "Could authentication, session or cookie behavior change?"
+      },
+      "sdk": {
+        "command": "node -e \"console.log('SDK generation')\"",
+        "when": "Could the public API contract change?"
+      },
+      "db": {
+        "command": "node -e \"console.log('database tests')\"",
+        "when": "Could database schemas or persistence change?"
+      },
+      "benchmark": {
+        "command": "node -e \"console.log('benchmark')\"",
+        "when": "Could a performance-sensitive execution path materially change?"
+      }
+    }
+  },
+  "state": {
+    "base": "fixture-base",
+    "head": "fixture-head",
+    "files": [
+      {
+        "path": "src/log.ts",
+        "status": "M"
+      }
+    ],
+    "diff": "diff --git a/src/log.ts b/src/log.ts\n--- a/src/log.ts\n+++ b/src/log.ts\n@@ -1 +1 @@\n-logger.info(\"start\")\n+logger.info(\"started\")\n",
+    "incomplete": false,
+    "warnings": []
+  },
+  "response": {
+    "model": "jev-1.13.0",
+    "probabilities": {
+      "auth": 0.01,
+      "sdk": 0.01,
+      "db": 0.01,
+      "benchmark": 0.01
+    }
+  },
+  "expected": {
+    "auth": "skip",
+    "sdk": "skip",
+    "db": "skip",
+    "benchmark": "skip"
+  }
+}

package/evals/fixtures/performance.json

@@ -0,0 +1,53 @@
+{
+  "name": "performance",
+  "provenance": "Synthetic SDK-shaped responses, not recorded Jev output; live model quality is unverified.",
+  "config": {
+    "version": 1,
+    "tasks": {
+      "auth": {
+        "command": "node -e \"console.log('auth tests')\"",
+        "when": "Could authentication, session or cookie behavior change?"
+      },
+      "sdk": {
+        "command": "node -e \"console.log('SDK generation')\"",
+        "when": "Could the public API contract change?"
+      },
+      "db": {
+        "command": "node -e \"console.log('database tests')\"",
+        "when": "Could database schemas or persistence change?"
+      },
+      "benchmark": {
+        "command": "node -e \"console.log('benchmark')\"",
+        "when": "Could a performance-sensitive execution path materially change?"
+      }
+    }
+  },
+  "state": {
+    "base": "fixture-base",
+    "head": "fixture-head",
+    "files": [
+      {
+        "path": "src/search.ts",
+        "status": "M"
+      }
+    ],
+    "diff": "diff --git a/src/search.ts b/src/search.ts\n--- a/src/search.ts\n+++ b/src/search.ts\n@@ -1 +1 @@\n-items.find(predicate)\n+index.get(key)\n",
+    "incomplete": false,
+    "warnings": []
+  },
+  "response": {
+    "model": "jev-1.13.0",
+    "probabilities": {
+      "auth": 0.01,
+      "sdk": 0.01,
+      "db": 0.01,
+      "benchmark": 0.95
+    }
+  },
+  "expected": {
+    "auth": "skip",
+    "sdk": "skip",
+    "db": "skip",
+    "benchmark": "run"
+  }
+}

package/examples/basic/jev-affected.yml

@@ -0,0 +1,16 @@
+version: 1
+defaults:
+  skipBelow: 0.10
+tasks:
+  auth-e2e:
+    command: npm run test:auth
+    when: Could authentication, authorization, sessions, cookies or login behavior change?
+  api-contract:
+    command: npm run test:contract
+    when: Could a public API request, response, status code or header change?
+  sdk:
+    command: npm run generate:sdk
+    when: Could the public API contract change?
+  typecheck:
+    command: npm run typecheck
+    always: true

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "jev-affected",
+  "version": "0.1.0",
+  "description": "Semantic task routing for software development, powered by Jev.",
+  "type": "module",
+  "license": "MIT",
+  "author": "jammaru",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jammaru/jev-affected.git"
+  },
+  "homepage": "https://github.com/jammaru/jev-affected#readme",
+  "bugs": {
+    "url": "https://github.com/jammaru/jev-affected/issues"
+  },
+  "keywords": [
+    "jev",
+    "testing",
+    "ci",
+    "semantic",
+    "task-runner",
+    "developer-tools"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "pnpm@10.11.0",
+  "bin": {
+    "jev-affected": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "assets",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "examples",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "CODE_OF_CONDUCT.md",
+    "EVALUATION.md",
+    ".env.example",
+    "evals",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "biome check .",
+    "format": "biome check --write .",
+    "smoke": "node scripts/smoke.mjs",
+    "eval": "node dist/cli.js eval",
+    "eval:live": "node dist/cli.js eval --live",
+    "pretest": "pnpm build",
+    "demo": "node scripts/demo.mjs",
+    "prepack": "tsc"
+  },
+  "dependencies": {
+    "@typesafe-ai/sdk": "^0.6.0",
+    "dotenv": "^17.2.2",
+    "picomatch": "^4.0.7",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.14",
+    "@changesets/cli": "^2.31.1",
+    "@types/node": "^22.20.4",
+    "@types/picomatch": "^4.0.3",
+    "typescript": "^7.0.2",
+    "vitest": "^3.2.7"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/jev-affected/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: jev-affected
+description: Use jev-affected to inspect committed Git changes, create semantic task plans, explain decisions, and run selected repository checks. Apply when a repository contains jev-affected.yml or the user asks which tests, builds, benchmarks, or code-generation tasks a change affects semantically.
+---
+
+# Jev Affected
+
+Use the repository-installed CLI. Prefer `pnpm exec jev-affected` in pnpm
+projects and `npx jev-affected` elsewhere.
+
+## Workflow
+
+1. Confirm the current directory is a Git repository and locate
+   `jev-affected.yml`. Run `jev-affected init` only when setup is requested and no
+   configuration exists.
+2. Ensure the relevant edits are committed. Version 0.1 compares commits and does
+   not include working-tree changes.
+3. On first use, or when privacy matters, run
+   `jev-affected inspect --base <ref>`. This previews the sanitized input locally
+   without sending a request.
+4. Run `jev-affected plan --json --base <ref>` and use its task decisions as the
+   record of what should run. Do not invent task reasons or commands.
+5. Run `jev-affected run --base <ref>` only when execution is requested. Commands
+   come from the repository configuration and should be treated as repository
+   code.
+6. Report the selected and skipped task counts, actual model version, warnings,
+   fallback decisions, and any failed task commands.
+
+Use an explicit base ref in CI and shallow clones. Fetch enough history for Git to
+compute the merge base.
+
+## Credentials and data
+
+Set `TYPESAFE_API_KEY` in the process environment or a repository-local `.env`
+file. Never print the value, commit `.env`, or store the key in
+`jev-affected.yml`. An existing process environment value takes precedence over
+`.env`.
+
+`inspect` stays local. `plan`, `why`, and `run` can send the sanitized committed
+diff and configured semantic questions to the provider. Review `inspect` output
+before the first request when the repository may contain sensitive material.
+
+## Decision invariants
+
+- A valid probability strictly below `skipBelow` produces SKIP.
+- Equality with the threshold produces RUN.
+- Provider errors, timeouts, and invalid answers produce RUN for candidates.
+- `always: true` and `allowSkip: false` protect mandatory tasks.
+- Exit code `0` means success, `1` means an executed task or evaluation failed,
+  `2` means a usage, configuration, base, or doctor error, and `3` means an
+  internal or I/O failure.

package/skills/jev-affected/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "jev-affected"
+  short_description: "Plan semantic checks for committed code changes"
+  icon_small: "../assets/icon-small.svg"
+  icon_large: "../assets/icon-large.svg"
+  brand_color: "#DAFB73"
+  default_prompt: "Use $jev-affected to inspect my committed changes, plan affected tasks, and run the selected checks."

package/skills/jev-affected/assets/icon-large.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" role="img" aria-label="jev-affected">
+  <rect width="512" height="512" rx="112" fill="#111312"/>
+  <path d="M132 144h72v160c0 45-27 72-72 72h-28v-64h18c12 0 18-7 18-23V144zm132 0h144v64h-80v36h72v56h-72v20h80v64H264V144z" fill="#DAFB73"/>
+</svg>

package/skills/jev-affected/assets/icon-small.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="jev-affected">
+  <rect width="64" height="64" rx="14" fill="#111312"/>
+  <path d="M17 19h9v20c0 5-3 9-9 9h-3v-8h2c1 0 2-1 2-3V19zm15 0h18v8H40v4h9v7h-9v3h10v8H32V19z" fill="#DAFB73"/>
+</svg>