jev-recipes 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+- Add `outcome-framing`, `causal-attribution`, and `motivation-source`, bringing the source catalog to 87 recipes. Each classifies expressed wording using one logical Jev request, with documented psychology concepts, decision boundaries, and offline tests. No new runtime dependencies.
+- Generate a Psychology & behavior catalog subsection from recipe metadata tags, including relevant existing recipes, and add topic search and documentation checks.
+
+- Add `memory-subject`, `issue-recurrence`, and `question-assumption` to identify whom a memory describes, distinguish persistent and returning issues, and flag a specific assumption in a question. The source catalog now contains 84 recipes. Each uses one logical Jev request with no new runtime dependencies and includes a guide, offline fixture, contract tests, and discovery checks.
+
 - Add `checkers-move`: supply a structured board, player, and legal moves to receive a move ID in one logical Jev request. Includes American/English checkers instructions, board translation, input checks, and offline tests, bringing the source catalog to 81 recipes. No new runtime dependencies; live speed and playing strength remain unmeasured.
 
 - Add `take-turn` and `choose-action` for narrative turn eligibility and game action recommendations, with optional ordered player history, offline tests, and a gameplay composition guide. The source catalog now contains 80 recipes.

package/README.md

@@ -11,7 +11,7 @@
 
 <!-- BEGIN GENERATED: summary -->
 
-81 focused recipes for JavaScript and TypeScript. Route messages, check evidence, and label model responses with a function call.
+87 focused recipes for JavaScript and TypeScript. Route messages, check evidence, and label model responses with a function call.
 
 <!-- END GENERATED: summary -->
 
@@ -21,7 +21,7 @@ For example, give `route` a support message and descriptions of your teams. It r
 
 ## Watch Jev play checkers against Jev using the checkers-move recipe
 
-https://github.com/user-attachments/assets/4ac10e7b-b57c-4d73-a2fe-fee90cd1e58d
+[![Jev plays checkers against Jev using the checkers-move recipe](https://raw.githubusercontent.com/agencyenterprise/jev-recipes/main/examples/checkers/jev-vs-jev.gif)](https://www.youtube.com/shorts/Z282rGKysTg)
 
 ## Use a recipe
 
@@ -140,6 +140,8 @@ npx jev-recipes demo answerability
 
 For games, the [gameplay guide](https://github.com/agencyenterprise/jev-recipes/blob/main/docs/gameplay.md) starts with a checkers decision using just the board, player, and legal moves. It also covers general action selection and narrative turn eligibility.
 
+For psychology, browse [Psychology & behavior](https://github.com/agencyenterprise/jev-recipes/blob/main/recipes/README.md#psychology--behavior) for gain/loss framing, causal explanations, stated motivation, and related wording annotations. Search with `npx jev-recipes list psychology`.
+
 <a id="run-your-own-input-from-the-terminal"></a>
 
 ## Use the terminal

package/dist/catalog/generated/details/causal-attribution.json

@@ -0,0 +1,55 @@
+{
+  "inputSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "behavior": {
+        "type": "string",
+        "description": "One focal behavior or outcome identifying the person or actor whose behavior is being explained."
+      },
+      "explanation": {
+        "type": "string",
+        "description": "The supplied explanation to classify, including any quoted attribution."
+      },
+      "context": {
+        "type": "string",
+        "description": "Supplied identities or references needed to interpret the explanation."
+      },
+      "minConfidence": { "type": "number", "minimum": 0, "maximum": 1 }
+    },
+    "required": ["behavior", "explanation"]
+  },
+  "resultSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "model": { "type": "string" },
+      "usage": {
+        "type": "object",
+        "properties": {
+          "input_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+          "output_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
+        },
+        "required": ["input_tokens", "output_tokens"],
+        "additionalProperties": false
+      },
+      "status": { "type": "string", "enum": ["ready", "review"] },
+      "verdict": {
+        "type": "string",
+        "enum": ["personal", "situational", "mixed", "none", "unclear"]
+      },
+      "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+      "probabilities": {
+        "type": "object",
+        "propertyNames": {
+          "type": "string",
+          "enum": ["personal", "situational", "mixed", "none", "unclear"]
+        },
+        "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 },
+        "required": ["personal", "situational", "mixed", "none", "unclear"]
+      }
+    },
+    "required": ["model", "usage", "status", "verdict", "confidence", "probabilities"],
+    "additionalProperties": false
+  }
+}

package/dist/catalog/generated/details/issue-recurrence.json

@@ -0,0 +1,46 @@
+{
+  "inputSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "issue": {
+        "type": "string",
+        "description": "One specific problem whose reported recurrence should be assessed."
+      },
+      "message": { "type": "string", "description": "The latest customer report about the issue." },
+      "history": {
+        "type": "string",
+        "description": "Earlier reports in chronological order, oldest first, with speaker identities and reported outcomes."
+      },
+      "minConfidence": { "type": "number", "minimum": 0, "maximum": 1 }
+    },
+    "required": ["issue", "message"]
+  },
+  "resultSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "model": { "type": "string" },
+      "usage": {
+        "type": "object",
+        "properties": {
+          "input_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+          "output_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
+        },
+        "required": ["input_tokens", "output_tokens"],
+        "additionalProperties": false
+      },
+      "status": { "type": "string", "enum": ["ready", "review"] },
+      "verdict": { "type": "string", "enum": ["new", "ongoing", "returned", "unclear"] },
+      "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+      "probabilities": {
+        "type": "object",
+        "propertyNames": { "type": "string", "enum": ["new", "ongoing", "returned", "unclear"] },
+        "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 },
+        "required": ["new", "ongoing", "returned", "unclear"]
+      }
+    },
+    "required": ["model", "usage", "status", "verdict", "confidence", "probabilities"],
+    "additionalProperties": false
+  }
+}

package/dist/catalog/generated/details/memory-subject.json

@@ -0,0 +1,49 @@
+{
+  "inputSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "statement": {
+        "type": "string",
+        "description": "One atomic statement or candidate memory whose subject should be identified."
+      },
+      "user": {
+        "type": "string",
+        "description": "The person whose memory profile is being considered, including their speaker role when relevant."
+      },
+      "context": {
+        "type": "string",
+        "description": "Supplied speaker identities or surrounding text needed to resolve references."
+      },
+      "minConfidence": { "type": "number", "minimum": 0, "maximum": 1 }
+    },
+    "required": ["statement", "user"]
+  },
+  "resultSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "model": { "type": "string" },
+      "usage": {
+        "type": "object",
+        "properties": {
+          "input_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+          "output_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
+        },
+        "required": ["input_tokens", "output_tokens"],
+        "additionalProperties": false
+      },
+      "status": { "type": "string", "enum": ["ready", "review"] },
+      "verdict": { "type": "string", "enum": ["user", "other", "shared", "unclear"] },
+      "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+      "probabilities": {
+        "type": "object",
+        "propertyNames": { "type": "string", "enum": ["user", "other", "shared", "unclear"] },
+        "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 },
+        "required": ["user", "other", "shared", "unclear"]
+      }
+    },
+    "required": ["model", "usage", "status", "verdict", "confidence", "probabilities"],
+    "additionalProperties": false
+  }
+}

package/dist/catalog/generated/details/motivation-source.json

@@ -0,0 +1,55 @@
+{
+  "inputSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "activity": {
+        "type": "string",
+        "description": "One focal activity and its actor when needed to distinguish whose stated reason is being classified."
+      },
+      "statement": {
+        "type": "string",
+        "description": "Text stating or reporting why the actor does the activity."
+      },
+      "context": {
+        "type": "string",
+        "description": "Supplied speaker identities or references needed to interpret the stated reason."
+      },
+      "minConfidence": { "type": "number", "minimum": 0, "maximum": 1 }
+    },
+    "required": ["activity", "statement"]
+  },
+  "resultSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "model": { "type": "string" },
+      "usage": {
+        "type": "object",
+        "properties": {
+          "input_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+          "output_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
+        },
+        "required": ["input_tokens", "output_tokens"],
+        "additionalProperties": false
+      },
+      "status": { "type": "string", "enum": ["ready", "review"] },
+      "verdict": {
+        "type": "string",
+        "enum": ["intrinsic", "extrinsic", "mixed", "not_stated", "unclear"]
+      },
+      "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+      "probabilities": {
+        "type": "object",
+        "propertyNames": {
+          "type": "string",
+          "enum": ["intrinsic", "extrinsic", "mixed", "not_stated", "unclear"]
+        },
+        "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 },
+        "required": ["intrinsic", "extrinsic", "mixed", "not_stated", "unclear"]
+      }
+    },
+    "required": ["model", "usage", "status", "verdict", "confidence", "probabilities"],
+    "additionalProperties": false
+  }
+}

package/dist/catalog/generated/details/outcome-framing.json

@@ -0,0 +1,49 @@
+{
+  "inputSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "text": { "type": "string", "description": "The wording presented to the decision maker." },
+      "outcome": {
+        "type": "string",
+        "description": "One focal outcome, including whose outcome it is and what counts as a benefit or harm."
+      },
+      "context": {
+        "type": "string",
+        "description": "Supplied references or baseline information needed to interpret the wording."
+      },
+      "minConfidence": { "type": "number", "minimum": 0, "maximum": 1 }
+    },
+    "required": ["text", "outcome"]
+  },
+  "resultSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "model": { "type": "string" },
+      "usage": {
+        "type": "object",
+        "properties": {
+          "input_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+          "output_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
+        },
+        "required": ["input_tokens", "output_tokens"],
+        "additionalProperties": false
+      },
+      "status": { "type": "string", "enum": ["ready", "review"] },
+      "verdict": { "type": "string", "enum": ["gain", "loss", "mixed", "neutral", "unclear"] },
+      "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+      "probabilities": {
+        "type": "object",
+        "propertyNames": {
+          "type": "string",
+          "enum": ["gain", "loss", "mixed", "neutral", "unclear"]
+        },
+        "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 },
+        "required": ["gain", "loss", "mixed", "neutral", "unclear"]
+      }
+    },
+    "required": ["model", "usage", "status", "verdict", "confidence", "probabilities"],
+    "additionalProperties": false
+  }
+}

package/dist/catalog/generated/details/question-assumption.json

@@ -0,0 +1,49 @@
+{
+  "inputSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "question": {
+        "type": "string",
+        "description": "One question, including any framing visible to the respondent."
+      },
+      "claim": {
+        "type": "string",
+        "description": "One specific proposition to check for an assumption in the question."
+      },
+      "context": {
+        "type": "string",
+        "description": "Supplied context needed to resolve references and interpret the question and claim."
+      },
+      "minConfidence": { "type": "number", "minimum": 0, "maximum": 1 }
+    },
+    "required": ["question", "claim"]
+  },
+  "resultSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "model": { "type": "string" },
+      "usage": {
+        "type": "object",
+        "properties": {
+          "input_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+          "output_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
+        },
+        "required": ["input_tokens", "output_tokens"],
+        "additionalProperties": false
+      },
+      "status": { "type": "string", "enum": ["ready", "review"] },
+      "verdict": { "type": "string", "enum": ["assumed", "not_assumed", "unclear"] },
+      "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+      "probabilities": {
+        "type": "object",
+        "propertyNames": { "type": "string", "enum": ["assumed", "not_assumed", "unclear"] },
+        "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 },
+        "required": ["assumed", "not_assumed", "unclear"]
+      }
+    },
+    "required": ["model", "usage", "status", "verdict", "confidence", "probabilities"],
+    "additionalProperties": false
+  }
+}

package/dist/catalog/generated/loaders.js

@@ -11,6 +11,7 @@ export const recipeLoaders = {
     'audience-fit': () => import('../../recipes/audience-fit/index.js').then((recipe) => (input, options) => recipe.audienceFit(recipe.audienceFitInputSchema.parse(input), options)),
     'cache-match': () => import('../../recipes/cache-match/index.js').then((recipe) => (input, options) => recipe.cacheMatch(recipe.cacheMatchInputSchema.parse(input), options)),
     'cancellation-check': () => import('../../recipes/cancellation-check/index.js').then((recipe) => (input, options) => recipe.cancellationCheck(recipe.cancellationCheckInputSchema.parse(input), options)),
+    'causal-attribution': () => import('../../recipes/causal-attribution/index.js').then((recipe) => (input, options) => recipe.causalAttribution(recipe.causalAttributionInputSchema.parse(input), options)),
     'certainty-match': () => import('../../recipes/certainty-match/index.js').then((recipe) => (input, options) => recipe.certaintyMatch(recipe.certaintyMatchInputSchema.parse(input), options)),
     'change-meaning': () => import('../../recipes/change-meaning/index.js').then((recipe) => (input, options) => recipe.changeMeaning(recipe.changeMeaningInputSchema.parse(input), options)),
     'checkers-move': () => import('../../recipes/checkers-move/index.js').then((recipe) => (input, options) => recipe.checkersMove(recipe.checkersMoveInputSchema.parse(input), options)),
@@ -42,14 +43,19 @@ export const recipeLoaders = {
     'instruction-fit': () => import('../../recipes/instruction-fit/index.js').then((recipe) => (input, options) => recipe.instructionFit(recipe.instructionFitInputSchema.parse(input), options)),
     'intent-change': () => import('../../recipes/intent-change/index.js').then((recipe) => (input, options) => recipe.intentChange(recipe.intentChangeInputSchema.parse(input), options)),
     'issue-impact': () => import('../../recipes/issue-impact/index.js').then((recipe) => (input, options) => recipe.issueImpact(recipe.issueImpactInputSchema.parse(input), options)),
+    'issue-recurrence': () => import('../../recipes/issue-recurrence/index.js').then((recipe) => (input, options) => recipe.issueRecurrence(recipe.issueRecurrenceInputSchema.parse(input), options)),
     'memory-relation': () => import('../../recipes/memory-relation/index.js').then((recipe) => (input, options) => recipe.memoryRelation(recipe.memoryRelationInputSchema.parse(input), options)),
     'memory-scope': () => import('../../recipes/memory-scope/index.js').then((recipe) => (input, options) => recipe.memoryScope(recipe.memoryScopeInputSchema.parse(input), options)),
+    'memory-subject': () => import('../../recipes/memory-subject/index.js').then((recipe) => (input, options) => recipe.memorySubject(recipe.memorySubjectInputSchema.parse(input), options)),
     'memory-value': () => import('../../recipes/memory-value/index.js').then((recipe) => (input, options) => recipe.memoryValue(recipe.memoryValueInputSchema.parse(input), options)),
+    'motivation-source': () => import('../../recipes/motivation-source/index.js').then((recipe) => (input, options) => recipe.motivationSource(recipe.motivationSourceInputSchema.parse(input), options)),
+    'outcome-framing': () => import('../../recipes/outcome-framing/index.js').then((recipe) => (input, options) => recipe.outcomeFraming(recipe.outcomeFramingInputSchema.parse(input), options)),
     'passage-duplicate': () => import('../../recipes/passage-duplicate/index.js').then((recipe) => (input, options) => recipe.passageDuplicate(recipe.passageDuplicateInputSchema.parse(input), options)),
     'preference-kind': () => import('../../recipes/preference-kind/index.js').then((recipe) => (input, options) => recipe.preferenceKind(recipe.preferenceKindInputSchema.parse(input), options)),
     'promise-check': () => import('../../recipes/promise-check/index.js').then((recipe) => (input, options) => recipe.promiseCheck(recipe.promiseCheckInputSchema.parse(input), options)),
     'query-equivalence': () => import('../../recipes/query-equivalence/index.js').then((recipe) => (input, options) => recipe.queryEquivalence(recipe.queryEquivalenceInputSchema.parse(input), options)),
     'query-specificity': () => import('../../recipes/query-specificity/index.js').then((recipe) => (input, options) => recipe.querySpecificity(recipe.querySpecificityInputSchema.parse(input), options)),
+    'question-assumption': () => import('../../recipes/question-assumption/index.js').then((recipe) => (input, options) => recipe.questionAssumption(recipe.questionAssumptionInputSchema.parse(input), options)),
     'question-leading': () => import('../../recipes/question-leading/index.js').then((recipe) => (input, options) => recipe.questionLeading(recipe.questionLeadingInputSchema.parse(input), options)),
     'reference-resolve': () => import('../../recipes/reference-resolve/index.js').then((recipe) => (input, options) => recipe.referenceResolve(recipe.referenceResolveInputSchema.parse(input), options)),
     'repeated-attempt': () => import('../../recipes/repeated-attempt/index.js').then((recipe) => (input, options) => recipe.repeatedAttempt(recipe.repeatedAttemptInputSchema.parse(input), options)),