jev-recipes 0.0.4 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jev-recipes",
-  "version": "0.0.4",
+  "version": "0.2.0",
   "description": "Small, composable Jev decisions for retrieval, conversations, and agent workflows.",
   "type": "module",
   "license": "MIT",
@@ -47,6 +47,246 @@
     "./catalog": {
       "types": "./dist/catalog/index.d.ts",
       "import": "./dist/catalog/index.js"
+    },
+    "./answer-coverage": {
+      "types": "./dist/recipes/answer-coverage/index.d.ts",
+      "import": "./dist/recipes/answer-coverage/index.js"
+    },
+    "./answer-relevance": {
+      "types": "./dist/recipes/answer-relevance/index.d.ts",
+      "import": "./dist/recipes/answer-relevance/index.js"
+    },
+    "./citation-match": {
+      "types": "./dist/recipes/citation-match/index.d.ts",
+      "import": "./dist/recipes/citation-match/index.js"
+    },
+    "./citation-needed": {
+      "types": "./dist/recipes/citation-needed/index.d.ts",
+      "import": "./dist/recipes/citation-needed/index.js"
+    },
+    "./answer-consistency": {
+      "types": "./dist/recipes/answer-consistency/index.d.ts",
+      "import": "./dist/recipes/answer-consistency/index.js"
+    },
+    "./summary-coverage": {
+      "types": "./dist/recipes/summary-coverage/index.d.ts",
+      "import": "./dist/recipes/summary-coverage/index.js"
+    },
+    "./certainty-match": {
+      "types": "./dist/recipes/certainty-match/index.d.ts",
+      "import": "./dist/recipes/certainty-match/index.js"
+    },
+    "./promise-check": {
+      "types": "./dist/recipes/promise-check/index.d.ts",
+      "import": "./dist/recipes/promise-check/index.js"
+    },
+    "./tone-check": {
+      "types": "./dist/recipes/tone-check/index.d.ts",
+      "import": "./dist/recipes/tone-check/index.js"
+    },
+    "./draft-compare": {
+      "types": "./dist/recipes/draft-compare/index.d.ts",
+      "import": "./dist/recipes/draft-compare/index.js"
+    },
+    "./retrieval-needed": {
+      "types": "./dist/recipes/retrieval-needed/index.d.ts",
+      "import": "./dist/recipes/retrieval-needed/index.js"
+    },
+    "./freshness-needed": {
+      "types": "./dist/recipes/freshness-needed/index.d.ts",
+      "import": "./dist/recipes/freshness-needed/index.js"
+    },
+    "./source-applicability": {
+      "types": "./dist/recipes/source-applicability/index.d.ts",
+      "import": "./dist/recipes/source-applicability/index.js"
+    },
+    "./evidence-conflict": {
+      "types": "./dist/recipes/evidence-conflict/index.d.ts",
+      "import": "./dist/recipes/evidence-conflict/index.js"
+    },
+    "./passage-duplicate": {
+      "types": "./dist/recipes/passage-duplicate/index.d.ts",
+      "import": "./dist/recipes/passage-duplicate/index.js"
+    },
+    "./evidence-novelty": {
+      "types": "./dist/recipes/evidence-novelty/index.d.ts",
+      "import": "./dist/recipes/evidence-novelty/index.js"
+    },
+    "./cache-match": {
+      "types": "./dist/recipes/cache-match/index.d.ts",
+      "import": "./dist/recipes/cache-match/index.js"
+    },
+    "./query-equivalence": {
+      "types": "./dist/recipes/query-equivalence/index.d.ts",
+      "import": "./dist/recipes/query-equivalence/index.js"
+    },
+    "./context-role": {
+      "types": "./dist/recipes/context-role/index.d.ts",
+      "import": "./dist/recipes/context-role/index.js"
+    },
+    "./query-specificity": {
+      "types": "./dist/recipes/query-specificity/index.d.ts",
+      "import": "./dist/recipes/query-specificity/index.js"
+    },
+    "./turn-intent": {
+      "types": "./dist/recipes/turn-intent/index.d.ts",
+      "import": "./dist/recipes/turn-intent/index.js"
+    },
+    "./followup-link": {
+      "types": "./dist/recipes/followup-link/index.d.ts",
+      "import": "./dist/recipes/followup-link/index.js"
+    },
+    "./reference-resolve": {
+      "types": "./dist/recipes/reference-resolve/index.d.ts",
+      "import": "./dist/recipes/reference-resolve/index.js"
+    },
+    "./intent-change": {
+      "types": "./dist/recipes/intent-change/index.d.ts",
+      "import": "./dist/recipes/intent-change/index.js"
+    },
+    "./correction-target": {
+      "types": "./dist/recipes/correction-target/index.d.ts",
+      "import": "./dist/recipes/correction-target/index.js"
+    },
+    "./confirmation-match": {
+      "types": "./dist/recipes/confirmation-match/index.d.ts",
+      "import": "./dist/recipes/confirmation-match/index.js"
+    },
+    "./cancellation-check": {
+      "types": "./dist/recipes/cancellation-check/index.d.ts",
+      "import": "./dist/recipes/cancellation-check/index.js"
+    },
+    "./topic-shift": {
+      "types": "./dist/recipes/topic-shift/index.d.ts",
+      "import": "./dist/recipes/topic-shift/index.js"
+    },
+    "./response-needed": {
+      "types": "./dist/recipes/response-needed/index.d.ts",
+      "import": "./dist/recipes/response-needed/index.js"
+    },
+    "./resolution-check": {
+      "types": "./dist/recipes/resolution-check/index.d.ts",
+      "import": "./dist/recipes/resolution-check/index.js"
+    },
+    "./tool-fit": {
+      "types": "./dist/recipes/tool-fit/index.d.ts",
+      "import": "./dist/recipes/tool-fit/index.js"
+    },
+    "./argument-fit": {
+      "types": "./dist/recipes/argument-fit/index.d.ts",
+      "import": "./dist/recipes/argument-fit/index.js"
+    },
+    "./result-usefulness": {
+      "types": "./dist/recipes/result-usefulness/index.d.ts",
+      "import": "./dist/recipes/result-usefulness/index.js"
+    },
+    "./result-outcome": {
+      "types": "./dist/recipes/result-outcome/index.d.ts",
+      "import": "./dist/recipes/result-outcome/index.js"
+    },
+    "./action-scope": {
+      "types": "./dist/recipes/action-scope/index.d.ts",
+      "import": "./dist/recipes/action-scope/index.js"
+    },
+    "./step-progress": {
+      "types": "./dist/recipes/step-progress/index.d.ts",
+      "import": "./dist/recipes/step-progress/index.js"
+    },
+    "./repeated-attempt": {
+      "types": "./dist/recipes/repeated-attempt/index.d.ts",
+      "import": "./dist/recipes/repeated-attempt/index.js"
+    },
+    "./step-complete": {
+      "types": "./dist/recipes/step-complete/index.d.ts",
+      "import": "./dist/recipes/step-complete/index.js"
+    },
+    "./failure-kind": {
+      "types": "./dist/recipes/failure-kind/index.d.ts",
+      "import": "./dist/recipes/failure-kind/index.js"
+    },
+    "./instruction-fit": {
+      "types": "./dist/recipes/instruction-fit/index.d.ts",
+      "import": "./dist/recipes/instruction-fit/index.js"
+    },
+    "./issue-impact": {
+      "types": "./dist/recipes/issue-impact/index.d.ts",
+      "import": "./dist/recipes/issue-impact/index.js"
+    },
+    "./attempted-step": {
+      "types": "./dist/recipes/attempted-step/index.d.ts",
+      "import": "./dist/recipes/attempted-step/index.js"
+    },
+    "./workaround-fit": {
+      "types": "./dist/recipes/workaround-fit/index.d.ts",
+      "import": "./dist/recipes/workaround-fit/index.js"
+    },
+    "./ticket-match": {
+      "types": "./dist/recipes/ticket-match/index.d.ts",
+      "import": "./dist/recipes/ticket-match/index.js"
+    },
+    "./incident-match": {
+      "types": "./dist/recipes/incident-match/index.d.ts",
+      "import": "./dist/recipes/incident-match/index.js"
+    },
+    "./troubleshooting-fit": {
+      "types": "./dist/recipes/troubleshooting-fit/index.d.ts",
+      "import": "./dist/recipes/troubleshooting-fit/index.js"
+    },
+    "./frustration-signal": {
+      "types": "./dist/recipes/frustration-signal/index.d.ts",
+      "import": "./dist/recipes/frustration-signal/index.js"
+    },
+    "./urgency-signal": {
+      "types": "./dist/recipes/urgency-signal/index.d.ts",
+      "import": "./dist/recipes/urgency-signal/index.js"
+    },
+    "./feedback-kind": {
+      "types": "./dist/recipes/feedback-kind/index.d.ts",
+      "import": "./dist/recipes/feedback-kind/index.js"
+    },
+    "./reply-template-match": {
+      "types": "./dist/recipes/reply-template-match/index.d.ts",
+      "import": "./dist/recipes/reply-template-match/index.js"
+    },
+    "./memory-value": {
+      "types": "./dist/recipes/memory-value/index.d.ts",
+      "import": "./dist/recipes/memory-value/index.js"
+    },
+    "./memory-scope": {
+      "types": "./dist/recipes/memory-scope/index.d.ts",
+      "import": "./dist/recipes/memory-scope/index.js"
+    },
+    "./memory-relation": {
+      "types": "./dist/recipes/memory-relation/index.d.ts",
+      "import": "./dist/recipes/memory-relation/index.js"
+    },
+    "./preference-kind": {
+      "types": "./dist/recipes/preference-kind/index.d.ts",
+      "import": "./dist/recipes/preference-kind/index.js"
+    },
+    "./fact-stability": {
+      "types": "./dist/recipes/fact-stability/index.d.ts",
+      "import": "./dist/recipes/fact-stability/index.js"
+    },
+    "./document-role": {
+      "types": "./dist/recipes/document-role/index.d.ts",
+      "import": "./dist/recipes/document-role/index.js"
+    },
+    "./audience-fit": {
+      "types": "./dist/recipes/audience-fit/index.d.ts",
+      "import": "./dist/recipes/audience-fit/index.js"
+    },
+    "./change-meaning": {
+      "types": "./dist/recipes/change-meaning/index.d.ts",
+      "import": "./dist/recipes/change-meaning/index.js"
+    },
+    "./answer-invalidation": {
+      "types": "./dist/recipes/answer-invalidation/index.d.ts",
+      "import": "./dist/recipes/answer-invalidation/index.js"
+    },
+    "./field-select": {
+      "types": "./dist/recipes/field-select/index.d.ts",
+      "import": "./dist/recipes/field-select/index.js"
     }
   },
   "bin": {
@@ -60,21 +300,25 @@
     "CHANGELOG.md",
     "LICENSE",
     "examples/support/demo.json",
-    "examples/support/README.md"
+    "examples/support/README.md",
+    "recipes/README.md"
   ],
   "scripts": {
     "clean": "rimraf dist",
     "build": "npm run clean && tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tests/tsconfig.json",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "demo": "node dist/cli/index.js demo all",
-    "jev": "node --env-file-if-exists=.env dist/cli/index.js",
-    "ci": "npm run format:check && npm run typecheck && npm run build && npm run demo && npm run example:support",
+    "jev-recipes": "node --env-file-if-exists=.env dist/cli/index.js",
+    "ci": "npm run format:check && npm run typecheck && npm run test:coverage && npm run build && npm run demo && npm run example:support",
     "pack:check": "npm pack --dry-run",
     "prepack": "npm run build",
     "prepublishOnly": "npm run ci",
-    "example:support": "node --env-file-if-exists=.env dist/examples/support/index.js"
+    "example:support": "node --env-file-if-exists=.env dist/examples/support/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
     "@typesafe-ai/sdk": "0.6.0",
@@ -82,9 +326,12 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "4.1.11",
     "prettier": "3.9.8",
     "rimraf": "6.1.3",
-    "typescript": "~5.9.3"
+    "typescript": "~5.9.3",
+    "vite": "6.4.3",
+    "vitest": "4.1.11"
   },
   "homepage": "https://github.com/agencyenterprise/jev-recipes#readme",
   "bugs": {

package/recipes/README.md

@@ -0,0 +1,128 @@
+# Recipe catalog
+
+66 small decisions for AI applications. Every recipe has its own input and result schemas, example, and usage guide. The package exports camelCase functions from kebab-case paths: `answerCoverage` from `jev-recipes/answer-coverage`, for example.
+
+After `npm install jev-recipes`, browse the groups below or use `npx jev-recipes list <query>` and `npx jev-recipes describe <recipe>` from your app’s directory. Discovery needs no API key. Each recipe guide describes its inputs, results, limits, and review policy.
+
+## Answer quality
+
+| Recipe                                               | Function            | Decision                                                                                               |
+| ---------------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------ |
+| [`answer-coverage`](answer-coverage/README.md)       | `answerCoverage`    | Check whether a draft answers each supplied question.                                                  |
+| [`answer-relevance`](answer-relevance/README.md)     | `answerRelevance`   | How directly does draft address request?                                                               |
+| [`citation-match`](citation-match/README.md)         | `citationMatch`     | Find supplied passages that independently support an entire claim.                                     |
+| [`citation-needed`](citation-needed/README.md)       | `citationNeeded`    | Do citationRules require evidence for statement?                                                       |
+| [`answer-consistency`](answer-consistency/README.md) | `answerConsistency` | Do firstStatement and secondStatement make compatible claims about the same subject and circumstances? |
+| [`summary-coverage`](summary-coverage/README.md)     | `summaryCoverage`   | Check whether a summary preserves each supplied point.                                                 |
+| [`certainty-match`](certainty-match/README.md)       | `certaintyMatch`    | Does the certainty expressed in draft match assessment?                                                |
+| [`promise-check`](promise-check/README.md)           | `promiseCheck`      | Does reply promise actions or outcomes beyond allowedCommitments?                                      |
+| [`tone-check`](tone-check/README.md)                 | `toneCheck`         | Check a draft against each supplied writing criterion.                                                 |
+| [`draft-compare`](draft-compare/README.md)           | `draftCompare`      | Which draft better satisfies request under rubric?                                                     |
+
+## Retrieval and evidence
+
+| Recipe                                                   | Function              | Decision                                                                                                     |
+| -------------------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------ |
+| [`rerank`](rerank/README.md)                             | `rerank`              | Select and order relevant passages.                                                                          |
+| [`verify`](verify/README.md)                             | `verify`              | Check claims against supplied evidence.                                                                      |
+| [`answerability`](answerability/README.md)               | `answerability`       | Check whether evidence can answer the question.                                                              |
+| [`retrieval-needed`](retrieval-needed/README.md)         | `retrievalNeeded`     | Does request require facts beyond context?                                                                   |
+| [`freshness-needed`](freshness-needed/README.md)         | `freshnessNeeded`     | Does question require a current or time-specific state that can change, or stable conceptual knowledge?      |
+| [`source-applicability`](source-applicability/README.md) | `sourceApplicability` | Does the scope described in passage apply to scenario?                                                       |
+| [`evidence-conflict`](evidence-conflict/README.md)       | `evidenceConflict`    | Do firstPassage and secondPassage give incompatible evidence relevant to question under the same conditions? |
+| [`passage-duplicate`](passage-duplicate/README.md)       | `passageDuplicate`    | How much material information do firstPassage and secondPassage share?                                       |
+| [`evidence-novelty`](evidence-novelty/README.md)         | `evidenceNovelty`     | Does passage add material information relevant to question beyond existingEvidence?                          |
+| [`cache-match`](cache-match/README.md)                   | `cacheMatch`          | Does cachedAnswer address question with the same relevant meaning and conditions as originalQuestion?        |
+| [`query-equivalence`](query-equivalence/README.md)       | `queryEquivalence`    | Do firstQuestion and secondQuestion request the same information under the same stated conditions?           |
+| [`context-role`](context-role/README.md)                 | `contextRole`         | What role does passage play in answering question?                                                           |
+| [`query-specificity`](query-specificity/README.md)       | `querySpecificity`    | Does question, interpreted with context, identify a focused information need?                                |
+
+## Conversation
+
+| Recipe                                               | Function            | Decision                                                                           |
+| ---------------------------------------------------- | ------------------- | ---------------------------------------------------------------------------------- |
+| [`clarify`](clarify/README.md)                       | `clarify`           | Find missing or ambiguous requirements.                                            |
+| [`turn-intent`](turn-intent/README.md)               | `turnIntent`        | What is the primary communicative purpose of message in context?                   |
+| [`followup-link`](followup-link/README.md)           | `followupLink`      | Which supplied earlier request does message follow up on?                          |
+| [`reference-resolve`](reference-resolve/README.md)   | `referenceResolve`  | Which supplied candidate does reference refer to in message and context?           |
+| [`intent-change`](intent-change/README.md)           | `intentChange`      | How does message change currentGoal?                                               |
+| [`correction-target`](correction-target/README.md)   | `correctionTarget`  | Which supplied field or statement is message correcting?                           |
+| [`confirmation-match`](confirmation-match/README.md) | `confirmationMatch` | Does response clearly agree to or reject this exact proposal?                      |
+| [`cancellation-check`](cancellation-check/README.md) | `cancellationCheck` | Does message ask to cancel, pause, or continue task?                               |
+| [`topic-shift`](topic-shift/README.md)               | `topicShift`        | Does message stay with currentTopic, introduce a different topic, or contain both? |
+| [`response-needed`](response-needed/README.md)       | `responseNeeded`    | Does message require a substantive reply in context?                               |
+| [`resolution-check`](resolution-check/README.md)     | `resolutionCheck`   | Does message establish that the customer reports issue as resolved?                |
+
+## Tools and tasks
+
+| Recipe                                             | Function           | Decision                                                                                 |
+| -------------------------------------------------- | ------------------ | ---------------------------------------------------------------------------------------- |
+| [`route`](route/README.md)                         | `route`            | Choose a handler for a request.                                                          |
+| [`handoff`](handoff/README.md)                     | `handoff`          | Check your rules for involving a human.                                                  |
+| [`tool-fit`](tool-fit/README.md)                   | `toolFit`          | Can the capabilities explicitly described in tool perform task?                          |
+| [`argument-fit`](argument-fit/README.md)           | `argumentFit`      | Does proposedValue for argument express the intended value in request and context?       |
+| [`result-usefulness`](result-usefulness/README.md) | `resultUsefulness` | Does result provide information useful for task?                                         |
+| [`result-outcome`](result-outcome/README.md)       | `resultOutcome`    | What outcome does result report for task?                                                |
+| [`action-scope`](action-scope/README.md)           | `actionScope`      | Is proposedAction within the work requested in request and constraints?                  |
+| [`step-progress`](step-progress/README.md)         | `stepProgress`     | How does observation change progress toward objective relative to previousState?         |
+| [`repeated-attempt`](repeated-attempt/README.md)   | `repeatedAttempt`  | Does proposedAttempt use essentially the same approach as previousAttempt for objective? |
+| [`step-complete`](step-complete/README.md)         | `stepComplete`     | Does evidence establish that condition has been met?                                     |
+| [`failure-kind`](failure-kind/README.md)           | `failureKind`      | Which supplied category best describes the observed failure?                             |
+| [`instruction-fit`](instruction-fit/README.md)     | `instructionFit`   | Does the explicit scope of instruction cover task and context?                           |
+
+## Customer support
+
+| Recipe                                                   | Function             | Decision                                                                     |
+| -------------------------------------------------------- | -------------------- | ---------------------------------------------------------------------------- |
+| [`issue-impact`](issue-impact/README.md)                 | `issueImpact`        | What practical impact does message explicitly describe?                      |
+| [`attempted-step`](attempted-step/README.md)             | `attemptedStep`      | Does conversation establish whether the customer already performed step?     |
+| [`workaround-fit`](workaround-fit/README.md)             | `workaroundFit`      | Can workaround address issue without violating constraints?                  |
+| [`ticket-match`](ticket-match/README.md)                 | `ticketMatch`        | Do firstTicket and secondTicket describe the same underlying reported issue? |
+| [`incident-match`](incident-match/README.md)             | `incidentMatch`      | Which supplied incident is supported as a match for ticket?                  |
+| [`troubleshooting-fit`](troubleshooting-fit/README.md)   | `troubleshootingFit` | Does procedure address symptoms under the described circumstances?           |
+| [`frustration-signal`](frustration-signal/README.md)     | `frustrationSignal`  | Does message express frustration or dissatisfaction in its wording?          |
+| [`urgency-signal`](urgency-signal/README.md)             | `urgencySignal`      | Does message explicitly request urgent attention?                            |
+| [`feedback-kind`](feedback-kind/README.md)               | `feedbackKind`       | What is the primary kind of feedback in message?                             |
+| [`reply-template-match`](reply-template-match/README.md) | `replyTemplateMatch` | Which supplied approved template applies to request and context?             |
+
+## Memory
+
+| Recipe                                         | Function         | Decision                                                                                   |
+| ---------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------ |
+| [`memory-value`](memory-value/README.md)       | `memoryValue`    | How useful is fact for future work under purpose?                                          |
+| [`memory-scope`](memory-scope/README.md)       | `memoryScope`    | What is the narrowest explicitly supported scope of fact in context?                       |
+| [`memory-relation`](memory-relation/README.md) | `memoryRelation` | How does newFact relate to existingMemory?                                                 |
+| [`preference-kind`](preference-kind/README.md) | `preferenceKind` | Does statement express an ongoing preference, a factual assertion, or a temporary request? |
+| [`fact-stability`](fact-stability/README.md)   | `factStability`  | Is fact about an enduring or historical attribute, or a state that is expected to change?  |
+
+## Knowledge maintenance
+
+| Recipe                                                 | Function             | Decision                                                                                                |
+| ------------------------------------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------- |
+| [`document-role`](document-role/README.md)             | `documentRole`       | What is the primary purpose of document?                                                                |
+| [`audience-fit`](audience-fit/README.md)               | `audienceFit`        | Does the level of explanation in document fit the knowledge and needs explicitly described in audience? |
+| [`change-meaning`](change-meaning/README.md)           | `changeMeaning`      | Does the revision from before to after change material meaning, conditions, or obligations?             |
+| [`answer-invalidation`](answer-invalidation/README.md) | `answerInvalidation` | Does updatedEvidence still support the entire claim that was based on previousEvidence?                 |
+| [`field-select`](field-select/README.md)               | `fieldSelect`        | Which supplied candidate is the value of field in document?                                             |
+
+## Shared options and behavior
+
+- Pass `{ client, model, signal }` as an optional second argument to any recipe. The default client reads `TYPESAFE_API_KEY` from the process environment.
+- Recipes that accept `minConfidence` default it to `0.8`. Rerank uses `minRelevance`, defaulting to `0.5`. Each guide explains which outcomes require review and how individual checks affect the overall decision.
+- `ready` describes confidence in the assessment. Inspect the verdict too: a ready result can describe a conflict, missing information, or an unsuitable candidate.
+- Candidate selectors return `selection` only for a ready match. `suggestedSelection` preserves a low-confidence suggestion. Candidate probabilities use your supplied IDs; no candidate match and ambiguity are separate outcomes.
+- Item checks preserve each item's ID, verdict, confidence, and status. The coverage and tone recipes also provide `allAnswered`, `allPreserved`, or `allPassed` as appropriate.
+- Model and token usage accompany every result. Inputs and model responses are validated with Zod 4. Invalid input, malformed answers, and provider failures throw.
+- Shared `{ id, text }` lists accept 1 to 50 items with unique non-empty IDs. Route accepts up to 254 routes; rerank and verify accept up to 100 items. Each guide documents its input limits. Provider context limits may require smaller inputs; content is not silently truncated.
+
+## Reuse and side effects
+
+Recipes share small helpers for choices, candidate selection, and item checks. Rerank uses independent yes/no relevance scores. Each recipe owns its question and decision rules. `citation-match` composes the public `verify` function; its guide and catalog `uses` field name that dependency.
+
+Each current recipe makes one logical Jev request per live invocation. Batch checks place their questions in that request. SDK retries can add transport attempts. The recipes return decisions without executing application actions. The separate support example makes up to six logical requests and can stop early.
+
+## Examples and limits
+
+Every `demo.json` includes input and a hand-authored response. These examples illustrate behavior; they are not model accuracy results. Use `example <recipe>` to obtain editable input and `demo <recipe>` to inspect an offline illustration when desired.
+
+Application code owns exact arithmetic, dates, identifiers, access controls, consent, and storage. Recipe guides describe the limits of each semantic decision. Larger applications combine the recipes in caller code; see [Cool projects](../README.md#cool-projects).

package/recipes/action-scope/README.md

@@ -0,0 +1,49 @@
+# Check proposed action scope
+
+Is proposedAction within the work requested in request and constraints? Do not treat a potentially helpful extra task as requested work. An explicit constraint overrides an implied convenience.
+
+```ts
+import { actionScope } from 'jev-recipes/action-scope';
+
+const result = await actionScope({
+  request: 'Explain why this deployment failed.',
+  proposedAction: 'Deploy a replacement release to production.',
+});
+
+console.log(result.status, result.verdict);
+```
+
+## Input
+
+| Field            | Accepts                                      |
+| ---------------- | -------------------------------------------- |
+| `request`        | Non-empty text                               |
+| `proposedAction` | Non-empty text                               |
+| `constraints`    | Optional non-empty text                      |
+| `minConfidence`  | Optional number from 0 to 1; defaults to 0.8 |
+
+See [shared options and behavior](../README.md#shared-options-and-behavior) for client configuration, validation, and errors.
+
+## Result
+
+| Verdict           | Meaning                                                                                                       |
+| ----------------- | ------------------------------------------------------------------------------------------------------------- |
+| `within_scope`    | The action is explicitly requested or directly necessary under the stated constraints.                        |
+| `additional_work` | The action introduces unrequested work, changes the requested outcome, or violates a stated scope constraint. |
+| `unclear`         | The scope relationship cannot be established from the request.                                                |
+
+The result includes `verdict`, `confidence`, and all choice `probabilities`. `unclear` always requires review, even at high confidence. Other verdicts can be ready, including negative assessments.
+
+Results include model and token usage. Decisions below `minConfidence` require review. Inspect the outcome as well as the status.
+
+## Reuse and calls
+
+Uses the shared choice helper for the Jev call and response parsing. This folder owns its question, verdict criteria, and review policy. A live invocation makes one logical Jev request; SDK retries can add transport attempts.
+
+## Limits
+
+Assesses semantic scope only. User authorization and access controls must be enforced by the application.
+
+## Example input
+
+[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo action-scope` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe action-scope` shows the input and result schemas.

package/recipes/action-scope/demo.json

@@ -0,0 +1,25 @@
+{
+  "input": {
+    "request": "Explain why this deployment failed.",
+    "proposedAction": "Deploy a replacement release to production."
+  },
+  "response": {
+    "model": "demo-fixture",
+    "usage": {
+      "input_tokens": 0,
+      "output_tokens": 0
+    },
+    "answers": {
+      "decision": {
+        "type": "choice",
+        "choice": "additional_work",
+        "confidence": 0.96,
+        "probabilities": {
+          "within_scope": 0,
+          "additional_work": 1,
+          "unclear": 0
+        }
+      }
+    }
+  }
+}

package/recipes/answer-consistency/README.md

@@ -0,0 +1,50 @@
+# Check answer consistency
+
+Do firstStatement and secondStatement make compatible claims about the same subject and circumstances? Distinguish different conditions from a contradiction.
+
+```ts
+import { answerConsistency } from 'jev-recipes/answer-consistency';
+
+const result = await answerConsistency({
+  firstStatement: 'Guests can export reports.',
+  secondStatement: 'Guests cannot export reports.',
+});
+
+console.log(result.status, result.verdict);
+```
+
+## Input
+
+| Field             | Accepts                                      |
+| ----------------- | -------------------------------------------- |
+| `firstStatement`  | Non-empty text                               |
+| `secondStatement` | Non-empty text                               |
+| `context`         | Optional non-empty text                      |
+| `minConfidence`   | Optional number from 0 to 1; defaults to 0.8 |
+
+See [shared options and behavior](../README.md#shared-options-and-behavior) for client configuration, validation, and errors.
+
+## Result
+
+| Verdict       | Meaning                                                                                 |
+| ------------- | --------------------------------------------------------------------------------------- |
+| `consistent`  | Both statements concern the same subject and can hold under the supplied circumstances. |
+| `conflicting` | The statements concern the same circumstances and make mutually incompatible claims.    |
+| `unrelated`   | The statements concern different subjects or scopes that should not be compared.        |
+| `unclear`     | The supplied circumstances do not resolve whether the statements conflict.              |
+
+The result includes `verdict`, `confidence`, and all choice `probabilities`. `unclear` always requires review, even at high confidence. Other verdicts can be ready, including negative assessments.
+
+Results include model and token usage. Decisions below `minConfidence` require review. Inspect the outcome as well as the status.
+
+## Reuse and calls
+
+Uses the shared choice helper for the Jev call and response parsing. This folder owns its question, verdict criteria, and review policy. A live invocation makes one logical Jev request; SDK retries can add transport attempts.
+
+## Limits
+
+Checks semantic consistency between two statements. Exact numeric and date comparisons belong in code.
+
+## Example input
+
+[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo answer-consistency` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe answer-consistency` shows the input and result schemas.

package/recipes/answer-consistency/demo.json

@@ -0,0 +1,26 @@
+{
+  "input": {
+    "firstStatement": "Guests can export reports.",
+    "secondStatement": "Guests cannot export reports."
+  },
+  "response": {
+    "model": "demo-fixture",
+    "usage": {
+      "input_tokens": 0,
+      "output_tokens": 0
+    },
+    "answers": {
+      "decision": {
+        "type": "choice",
+        "choice": "conflicting",
+        "confidence": 0.96,
+        "probabilities": {
+          "consistent": 0,
+          "conflicting": 1,
+          "unrelated": 0,
+          "unclear": 0
+        }
+      }
+    }
+  }
+}

package/recipes/answer-coverage/README.md

@@ -0,0 +1,60 @@
+# Check answer coverage
+
+Check whether a draft answers each supplied question.
+
+```ts
+import { answerCoverage } from 'jev-recipes/answer-coverage';
+
+const result = await answerCoverage({
+  draft: 'Select Forgot password on the sign-in page.',
+  questions: [
+    {
+      id: 'reset',
+      text: 'How do I reset my password?',
+    },
+    {
+      id: 'expiry',
+      text: 'When does the link expire?',
+    },
+  ],
+});
+
+console.log(result.status, result.checks);
+```
+
+## Input
+
+| Field           | Accepts                                      |
+| --------------- | -------------------------------------------- |
+| `draft`         | Non-empty text                               |
+| `questions`     | 1 to 50 `{ id, text }` items with unique IDs |
+| `minConfidence` | Optional number from 0 to 1; defaults to 0.8 |
+
+See [shared options and behavior](../README.md#shared-options-and-behavior) for client configuration, validation, and errors.
+
+## Result
+
+`checks` contains the original ID, verdict, status, confidence, and probabilities for each item. `allAnswered` is true only when every check is ready and has verdict `answered`. Any uncertain check makes overall status `review`.
+
+| Verdict    | Meaning                                                  |
+| ---------- | -------------------------------------------------------- |
+| `answered` | Every material part of this question is answered.        |
+| `partial`  | Some material parts are answered but others are missing. |
+| `missing`  | No substantive answer to this question appears.          |
+| `unclear`  | The wording prevents a reliable coverage decision.       |
+
+`unclear` always requires review, even at high confidence. Other verdicts can be ready, including negative assessments.
+
+Results include model and token usage. Decisions below `minConfidence` require review. Inspect the outcome as well as the status.
+
+## Reuse and calls
+
+Uses the shared item-check helper. This folder owns its question, verdict criteria, and aggregate decision. A live invocation makes one logical Jev request; SDK retries can add transport attempts. All item questions are sent in that request.
+
+## Limits
+
+Checks supplied question IDs only. It does not extract questions or verify the draft against sources.
+
+## Example input
+
+[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo answer-coverage` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe answer-coverage` shows the input and result schemas.