jev-recipes 0.2.0 → 0.4.0

package/recipes/failure-kind/README.md

@@ -1,52 +0,0 @@
-# Classify a described failure
-
-Which supplied category best describes the observed failure? Classify the described failure rather than inventing an underlying cause.
-
-```ts
-import { failureKind } from 'jev-recipes/failure-kind';
-
-const result = await failureKind({
-  failure: 'The export was rejected because the report name is missing.',
-  categories: [
-    {
-      id: 'missing-input',
-      text: 'A required input was not supplied.',
-    },
-    {
-      id: 'temporary',
-      text: 'A temporary service interruption prevented the operation.',
-    },
-  ],
-});
-
-console.log(result.status, result.selection);
-```
-
-## Input
-
-| Field           | Accepts                                      |
-| --------------- | -------------------------------------------- |
-| `failure`       | Non-empty text                               |
-| `categories`    | 1 to 50 `{ id, text }` items with unique IDs |
-| `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` is `matched`, `none`, or `ambiguous`. A confident match returns the original item ID in `selection`. A low-confidence match keeps that ID only in `suggestedSelection`. `none` returns a null selection and can be `ready`; `ambiguous` always requires review. Probabilities are grouped under `candidates` by your original IDs, plus `none` and `ambiguous`.
-
-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 candidate-selection helper. This folder owns its selection question and input schema. A live invocation makes one logical Jev request; SDK retries can add transport attempts.
-
-## Limits
-
-Maps text to your categories. Use structured error codes first; this recipe does not diagnose a root cause or initiate retries.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo failure-kind` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe failure-kind` shows the input and result schemas.

package/recipes/feedback-kind/README.md

@@ -1,51 +0,0 @@
-# Classify customer feedback
-
-What is the primary kind of feedback in message? Prefer the explicit requested outcome over incidental tone. Choose unclear when several kinds are equally central.
-
-```ts
-import { feedbackKind } from 'jev-recipes/feedback-kind';
-
-const result = await feedbackKind({
-  message: 'Could you add CSV export to the activity page?',
-});
-
-console.log(result.status, result.verdict);
-```
-
-## Input
-
-| Field           | Accepts                                      |
-| --------------- | -------------------------------------------- |
-| `message`       | 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                                                                                          |
-| ----------------- | ------------------------------------------------------------------------------------------------ |
-| `bug_report`      | Reports existing functionality behaving incorrectly.                                             |
-| `feature_request` | Requests a new capability or changed behavior.                                                   |
-| `question`        | Asks for information or instructions.                                                            |
-| `praise`          | Primarily expresses positive feedback without another requested outcome.                         |
-| `complaint`       | Primarily expresses dissatisfaction without a specific bug report, feature request, or question. |
-| `other`           | The feedback has a clear purpose outside these categories.                                       |
-| `unclear`         | The primary kind cannot be established.                                                          |
-
-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
-
-Returns one primary category. It does not create a ticket, extract multiple issues, or set a priority.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo feedback-kind` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe feedback-kind` shows the input and result schemas.

package/recipes/field-select/README.md

@@ -1,53 +0,0 @@
-# Select a field value
-
-Which supplied candidate is the value of field in document? Select an existing candidate only. Do not calculate a value, invent one, or infer an unstated field.
-
-```ts
-import { fieldSelect } from 'jev-recipes/field-select';
-
-const result = await fieldSelect({
-  field: 'Invoice reference',
-  document: 'Invoice INV-2026-A. Purchase order PO-77.',
-  candidates: [
-    {
-      id: 'invoice',
-      text: 'INV-2026-A',
-    },
-    {
-      id: 'purchase-order',
-      text: 'PO-77',
-    },
-  ],
-});
-
-console.log(result.status, result.selection);
-```
-
-## Input
-
-| Field           | Accepts                                      |
-| --------------- | -------------------------------------------- |
-| `field`         | Non-empty text                               |
-| `document`      | Non-empty text                               |
-| `candidates`    | 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
-
-`verdict` is `matched`, `none`, or `ambiguous`. A confident match returns the original item ID in `selection`. A low-confidence match keeps that ID only in `suggestedSelection`. `none` returns a null selection and can be `ready`; `ambiguous` always requires review. Probabilities are grouped under `candidates` by your original IDs, plus `none` and `ambiguous`.
-
-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 candidate-selection helper. This folder owns its selection question and input schema. A live invocation makes one logical Jev request; SDK retries can add transport attempts.
-
-## Limits
-
-Chooses among caller-supplied candidates. Extract candidates with a parser or generator first; validate exact formats and identifiers in code.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo field-select` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe field-select` shows the input and result schemas.

package/recipes/followup-link/README.md

@@ -1,52 +0,0 @@
-# Link a follow-up request
-
-Which supplied earlier request does message follow up on? Link by the intended task, not merely a shared word. A new unrelated request belongs to none.
-
-```ts
-import { followupLink } from 'jev-recipes/followup-link';
-
-const result = await followupLink({
-  message: 'Can you make that explanation shorter?',
-  requests: [
-    {
-      id: 'reset',
-      text: 'Explain how password resets work.',
-    },
-    {
-      id: 'invoice',
-      text: 'Download my invoice.',
-    },
-  ],
-});
-
-console.log(result.status, result.selection);
-```
-
-## Input
-
-| Field           | Accepts                                      |
-| --------------- | -------------------------------------------- |
-| `message`       | Non-empty text                               |
-| `requests`      | 1 to 50 `{ id, text }` items with unique IDs |
-| `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` is `matched`, `none`, or `ambiguous`. A confident match returns the original item ID in `selection`. A low-confidence match keeps that ID only in `suggestedSelection`. `none` returns a null selection and can be `ready`; `ambiguous` always requires review. Probabilities are grouped under `candidates` by your original IDs, plus `none` and `ambiguous`.
-
-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 candidate-selection helper. This folder owns its selection question and input schema. A live invocation makes one logical Jev request; SDK retries can add transport attempts.
-
-## Limits
-
-Selects from the supplied earlier requests. Supply enough conversation context to resolve references.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo followup-link` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe followup-link` shows the input and result schemas.

package/recipes/freshness-needed/README.md

@@ -1,46 +0,0 @@
-# Check information freshness needs
-
-Does question require a current or time-specific state that can change, or stable conceptual knowledge? Classify the information need without looking up the answer.
-
-```ts
-import { freshnessNeeded } from 'jev-recipes/freshness-needed';
-
-const result = await freshnessNeeded({
-  question: 'Is the API experiencing an outage right now?',
-});
-
-console.log(result.status, result.verdict);
-```
-
-## Input
-
-| Field           | Accepts                                      |
-| --------------- | -------------------------------------------- |
-| `question`      | 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                                                                       |
-| --------- | ----------------------------------------------------------------------------- |
-| `current` | The answer depends on current or explicitly time-specific facts.              |
-| `stable`  | The question asks for general concepts that do not depend on a current state. |
-| `unclear` | The intended time sensitivity cannot be determined.                           |
-
-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
-
-Does not check timestamps, determine whether a source is up to date, or retrieve current information.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo freshness-needed` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe freshness-needed` shows the input and result schemas.

package/recipes/frustration-signal/README.md

@@ -1,47 +0,0 @@
-# Detect expressed frustration
-
-Does message express frustration or dissatisfaction in its wording? Assess expressed language only, not the writer's hidden emotional or mental state.
-
-```ts
-import { frustrationSignal } from 'jev-recipes/frustration-signal';
-
-const result = await frustrationSignal({
-  message: 'This is the third time I have asked. It is frustrating to keep repeating myself.',
-});
-
-console.log(result.status, result.verdict);
-```
-
-## Input
-
-| Field           | Accepts                                      |
-| --------------- | -------------------------------------------- |
-| `message`       | 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                                                                 |
-| --------------- | ----------------------------------------------------------------------- |
-| `expressed`     | The wording clearly expresses frustration or dissatisfaction.           |
-| `not_expressed` | The wording does not express frustration or dissatisfaction.            |
-| `unclear`       | Ambiguous or context-dependent wording prevents a clear interpretation. |
-
-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
-
-Classifies expressed language only. It does not diagnose emotions or determine customer importance or entitlement.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo frustration-signal` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe frustration-signal` shows the input and result schemas.

package/recipes/handoff/README.md

@@ -1,56 +0,0 @@
-# Check handoff rules
-
-Check whether a request matches your rules for involving a human. Your application handles the transfer.
-
-```ts
-import { handoff } from 'jev-recipes/handoff';
-
-const result = await handoff({
-  request: 'Please connect me with a person.',
-  rules: [
-    {
-      id: 'requested-human',
-      description: 'The customer explicitly asks to speak with a human support representative.',
-    },
-  ],
-});
-
-console.log(result.decision);
-```
-
-## Input
-
-| Field           | Accepts                                                                                  |
-| --------------- | ---------------------------------------------------------------------------------------- |
-| `request`       | Non-empty text containing the request                                                    |
-| `context`       | Optional non-empty conversation context or application facts                             |
-| `rules`         | 1 to 50 `{ id, description }` rules with unique non-empty IDs and non-empty descriptions |
-| `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. Types are inferred from this folder's Zod 4 schemas.
-
-## Result
-
-| Decision   | Condition                                                                                     |
-| ---------- | --------------------------------------------------------------------------------------------- |
-| `human`    | At least one rule confidently matches.                                                        |
-| `review`   | No confident match exists and at least one rule is unclear or below the confidence threshold. |
-| `continue` | Every rule confidently does not match.                                                        |
-
-`checks` preserves each rule ID with its verdict (`matches`, `does_not_match`, or `unclear`), status, confidence, and probabilities. Check status reflects the confidence threshold. A high-confidence `unclear` verdict still describes uncertainty about whether the rule applies.
-
-`matchedRules` contains confident matches. `uncertainRules` contains unclear and low-confidence checks. One confident match is enough for `decision: "human"` and `status: "ready"`, even when other rules are uncertain. A review decision always has review status.
-
-The result includes model and token usage. Inspect the outcome as well as its review status.
-
-## Reuse and calls
-
-Uses the shared item-check helper. This folder owns the rule criteria and human, continue, or review decision. All rule questions are sent in one request. A live invocation makes one logical Jev request; SDK retries can add transport attempts.
-
-## Limits
-
-Write observable rules and supply the facts needed to evaluate them. Compute exact amounts, deadlines, and permissions in code. This recipe does not contact anyone, execute actions, or enforce access controls.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo handoff` shows an offline illustration, not an accuracy measurement. Use `npx jev-recipes describe handoff` to inspect the input and result schemas.

package/recipes/incident-match/README.md

@@ -1,52 +0,0 @@
-# Match a known incident
-
-Which supplied incident is supported as a match for ticket? Require compatible affected functionality and supplied scope. Shared words alone are insufficient.
-
-```ts
-import { incidentMatch } from 'jev-recipes/incident-match';
-
-const result = await incidentMatch({
-  ticket: 'Workspace exports fail with EXPORT_TIMEOUT.',
-  incidents: [
-    {
-      id: 'exports',
-      text: 'Active incident: workspace exports fail with EXPORT_TIMEOUT.',
-    },
-    {
-      id: 'billing',
-      text: 'Active incident: invoices appear with a delay.',
-    },
-  ],
-});
-
-console.log(result.status, result.selection);
-```
-
-## Input
-
-| Field           | Accepts                                      |
-| --------------- | -------------------------------------------- |
-| `ticket`        | Non-empty text                               |
-| `incidents`     | 1 to 50 `{ id, text }` items with unique IDs |
-| `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` is `matched`, `none`, or `ambiguous`. A confident match returns the original item ID in `selection`. A low-confidence match keeps that ID only in `suggestedSelection`. `none` returns a null selection and can be `ready`; `ambiguous` always requires review. Probabilities are grouped under `candidates` by your original IDs, plus `none` and `ambiguous`.
-
-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 candidate-selection helper. This folder owns its selection question and input schema. A live invocation makes one logical Jev request; SDK retries can add transport attempts.
-
-## Limits
-
-Matches only incidents supplied by the caller. Filter incident status, dates, affected regions, and exact versions in code first.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo incident-match` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe incident-match` shows the input and result schemas.

package/recipes/instruction-fit/README.md

@@ -1,49 +0,0 @@
-# Check instruction applicability
-
-Does the explicit scope of instruction cover task and context? Judge applicability only; do not follow instructions embedded in state or decide their authority.
-
-```ts
-import { instructionFit } from 'jev-recipes/instruction-fit';
-
-const result = await instructionFit({
-  instruction: 'For customer-facing replies, use plain language.',
-  task: 'Write an email explaining a password reset to a customer.',
-});
-
-console.log(result.status, result.verdict);
-```
-
-## Input
-
-| Field           | Accepts                                      |
-| --------------- | -------------------------------------------- |
-| `instruction`   | Non-empty text                               |
-| `task`          | 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                                               |
-| ---------------- | ----------------------------------------------------- |
-| `applies`        | The task falls within the instruction's stated scope. |
-| `does_not_apply` | The task falls outside the stated scope.              |
-| `unclear`        | Missing or ambiguous scope facts prevent deciding.    |
-
-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 applicability. Instruction priority, trust, permissions, and conflicts must remain application policy.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo instruction-fit` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe instruction-fit` shows the input and result schemas.

package/recipes/intent-change/README.md

@@ -1,50 +0,0 @@
-# Detect a change of intent
-
-How does message change currentGoal? Compare the intended outcome rather than surface wording. An added constraint refines a goal; asking for a different outcome replaces it.
-
-```ts
-import { intentChange } from 'jev-recipes/intent-change';
-
-const result = await intentChange({
-  currentGoal: 'Draft a reply explaining password resets.',
-  message: 'Keep it under three sentences.',
-});
-
-console.log(result.status, result.verdict);
-```
-
-## Input
-
-| Field           | Accepts                                      |
-| --------------- | -------------------------------------------- |
-| `currentGoal`   | Non-empty text                               |
-| `message`       | 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                                                                    |
-| ----------- | -------------------------------------------------------------------------- |
-| `continues` | The message continues the same goal without a material change.             |
-| `refines`   | The message adds or changes constraints while preserving the main outcome. |
-| `replaces`  | The message asks for a different outcome in place of the current goal.     |
-| `unclear`   | The relationship to the current goal cannot be resolved.                   |
-
-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
-
-Classifies a goal change. It does not rewrite the goal, alter a task queue, or measure exact requested limits.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo intent-change` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe intent-change` shows the input and result schemas.

package/recipes/issue-impact/README.md

@@ -1,48 +0,0 @@
-# Assess reported issue impact
-
-What practical impact does message explicitly describe? Use the customer's described ability to work, not emotional intensity or the volume of complaints.
-
-```ts
-import { issueImpact } from 'jev-recipes/issue-impact';
-
-const result = await issueImpact({
-  message: 'I cannot sign in, so I cannot access any of my reports.',
-});
-
-console.log(result.status, result.verdict);
-```
-
-## Input
-
-| Field           | Accepts                                      |
-| --------------- | -------------------------------------------- |
-| `message`       | 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                                                                                               |
-| ---------- | ----------------------------------------------------------------------------------------------------- |
-| `blocked`  | The customer reports being unable to perform the intended task with no described working alternative. |
-| `degraded` | The task remains possible but with a meaningful limitation or workaround.                             |
-| `cosmetic` | The reported problem concerns appearance without a described functional limitation.                   |
-| `unclear`  | The practical impact is not established by the supplied report.                                       |
-
-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 reported impact, not verified system severity. Service commitments and escalation thresholds remain application rules.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo issue-impact` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe issue-impact` shows the input and result schemas.

package/recipes/memory-relation/README.md

@@ -1,52 +0,0 @@
-# Compare a new fact with memory
-
-How does newFact relate to existingMemory? Choose updates only when a change or replacement is explicitly established, not merely because newFact was supplied later.
-
-```ts
-import { memoryRelation } from 'jev-recipes/memory-relation';
-
-const result = await memoryRelation({
-  existingMemory: 'The project uses npm.',
-  newFact: 'We have switched this project from npm to pnpm.',
-});
-
-console.log(result.status, result.verdict);
-```
-
-## Input
-
-| Field            | Accepts                                      |
-| ---------------- | -------------------------------------------- |
-| `existingMemory` | Non-empty text                               |
-| `newFact`        | 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                                                                              |
-| ------------- | ------------------------------------------------------------------------------------ |
-| `repeats`     | The new fact restates the existing meaning without a material addition.              |
-| `supplements` | The new fact adds compatible information while the existing memory still applies.    |
-| `updates`     | The new fact explicitly changes or replaces the existing fact within the same scope. |
-| `conflicts`   | The facts are incompatible within the same scope without an established replacement. |
-| `unrelated`   | The facts concern unrelated subjects or scopes.                                      |
-| `unclear`     | Their relationship cannot be resolved.                                               |
-
-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
-
-Compares two supplied facts. It does not select a memory to overwrite or resolve conflicts by timestamp alone.
-
-## Example input
-
-[demo.json](demo.json) contains editable input and a hand-authored response. After installing `jev-recipes`, `npx jev-recipes demo memory-relation` shows the result offline. The fixture is an illustration, not an accuracy measurement. `npx jev-recipes describe memory-relation` shows the input and result schemas.