@llamaventures/cli 2.2.0 → 2.3.0

package/AGENT_BRIEFING.md

@@ -168,9 +168,11 @@ means the truth depends on who judges: a value or comparative word with no
 stated benchmark, or a claim about someone's future behavior or inner state. If
 yes, the type is `human_subjective_view.people` (founders or team) or
 `human_subjective_view.business` (company, product, market or deal),
-`value.speaker` names that user, and `value.rawText` quotes the user verbatim
-from `origin.originalUserUtterance`. CLI and Core reject anything else. If no,
-choose any type that fits; founder words are `founder_claim`.
+`value.speaker` names that user, `value.rawText` quotes the user verbatim
+from `origin.originalUserUtterance`, and `value.summary` is your own
+restatement of those words (never a substitute for them). CLI and Core reject
+anything else. If no, choose any type that fits; founder words are
+`founder_claim`.
 
 ```json
 {

package/CHANGELOG.md

@@ -6,6 +6,14 @@ this project adheres to [Semantic Versioning](https://semver.org).
 
 ## [Unreleased]
 
+## [2.3.0] - 2026-09-04
+
+### Changed
+- `human_subjective_view.people|business` now also requires `value.summary`,
+  the agent's own restatement of the user's words, and rejects a summary that
+  merely repeats `value.rawText`. Core enforces the same rule; the Deal Page
+  shows both the summary and the verbatim text.
+
 ## [2.2.0] - 2026-09-04
 
 ### Added

package/bin/llama-mcp.mjs

@@ -152,7 +152,7 @@ server.registerTool(
 server.registerTool(
   "write_deal",
   {
-    description: "The only Deal mutation tool. Pass one command: input.submit, information.put, page.patch, or artifact.put. All Page content fields are Agent-writable; author controls attribution, not permission. Before page.patch, use get_live_deal_page_schema for the exact fields being changed and write bilingual Page prose. page.patch is JSON Merge Patch: arrays replace whole arrays, so read-modify-write and preserve sibling slots. A Llama user's own judgment is human_subjective_view.people or human_subjective_view.business and must carry value.speaker plus value.rawText quoted verbatim from origin.originalUserUtterance; it is rejected otherwise.",
+    description: "The only Deal mutation tool. Pass one command: input.submit, information.put, page.patch, or artifact.put. All Page content fields are Agent-writable; author controls attribution, not permission. Before page.patch, use get_live_deal_page_schema for the exact fields being changed and write bilingual Page prose. page.patch is JSON Merge Patch: arrays replace whole arrays, so read-modify-write and preserve sibling slots. A Llama user's own judgment is human_subjective_view.people or human_subjective_view.business and must carry value.speaker, value.rawText quoted verbatim from origin.originalUserUtterance, and value.summary (the agent's restatement); it is rejected otherwise.",
     // MCP SDK 1.30 only publishes object schemas at the tool root. Nesting one
     // command preserves the real discriminated union instead of flattening four
     // incompatible operations into false affordances.

package/bin/llama.mjs

@@ -103,7 +103,7 @@ create JSON:
 write JSON (CLI derives idempotencyKey when omitted):
   input.submit:    {"operation":"input.submit","dealId":"<uuid>","content":"<original input>","format":"text","source":{},"origin":{"kind":"user","originalUserUtterance":"..."}}
   information.put:{"operation":"information.put","dealId":"<uuid>","type":"founder_claim","labels":["founder-stated"],"subject":{"topic":"traction"},"value":{"content":"...","source":{"kind":"first_meeting_transcript"}},"origin":{"kind":"user","originalUserUtterance":"..."}}
-  human judgment:  {"operation":"information.put","dealId":"<uuid>","type":"human_subjective_view.people","subject":{"topic":"founder_execution"},"value":{"speaker":"<Llama user>","rawText":"<the user's verbatim words>","summary":"<optional agent summary>"},"origin":{"kind":"user","originalUserUtterance":"<complete user input; must contain rawText>"}}
+  human judgment:  {"operation":"information.put","dealId":"<uuid>","type":"human_subjective_view.people","subject":{"topic":"founder_execution"},"value":{"speaker":"<Llama user>","rawText":"<the user's verbatim words>","summary":"<the agent's restatement>"},"origin":{"kind":"user","originalUserUtterance":"<complete user input; must contain rawText>"}}
   page.patch:      {"operation":"page.patch","dealId":"<uuid>","patch":{"description":{"en":"...","zh":"..."}},"origin":{"kind":"agent"}}
   artifact.put:    {"operation":"artifact.put","dealId":"<uuid>","kind":"deck","title":"deck.pdf","mimeType":"application/pdf","contentBase64":"<file bytes, base64>","origin":{"kind":"user","originalUserUtterance":"..."}}
 
@@ -119,8 +119,9 @@ value.source records where the evidence came from.
 human_subjective_view.people|business is a Llama user's own judgment about the
 team or the deal. Subjective = the truth depends on who judges: a value or
 comparative word with no benchmark, or a claim about someone's future behavior
-or inner state. It requires value.speaker and value.rawText quoted verbatim from
-origin.originalUserUtterance; CLI and Core reject anything else. Other types are free.
+or inner state. It requires value.speaker, value.rawText quoted verbatim from
+origin.originalUserUtterance, and value.summary, the agent's own restatement of
+those words; CLI and Core reject anything else. Other types are free.
 
 Core owns Chat Records, append-only Deal Events, Drive provisioning, audit,
 and idempotency. User-originated work must preserve exact wording in

package/lib/build-manifest.json

@@ -1,8 +1,8 @@
 {
   "format": "llama.cli-build.v1",
   "packageName": "@llamaventures/cli",
-  "packageVersion": "2.2.0",
-  "sourceSha": "2f4c73310ed6c5d36a47a275490ff1082321ca27",
+  "packageVersion": "2.3.0",
+  "sourceSha": "c68a1849a4c43edbcc340a8f47f21cf16ca615ef",
   "sourceKind": "github",
   "sourceDirty": false,
   "coreApiContract": {

package/lib/deal-actions.mjs

@@ -12,8 +12,9 @@ export const DEAL_WRITE_OPERATIONS = Object.freeze([
 /**
  * A Llama user's own subjective judgment about the team (.people) or the deal
  * (.business). An agent may record it, but the record must name the user and
- * quote them verbatim from their own input, so the type alone stays a reliable
- * filter. Core enforces the same rule; this check only fails faster.
+ * quote them verbatim from their own input, plus the agent's own restatement in
+ * value.summary, so the type alone stays a reliable filter and every record
+ * reads the same way. Core enforces the same rule; this check only fails faster.
  */
 export const HUMAN_SUBJECTIVE_VIEW_TYPES = Object.freeze([
   "human_subjective_view.people",
@@ -72,6 +73,13 @@ export function validateHumanSubjectiveView(information, origin) {
       "human_subjective_view.* value.rawText must appear verbatim inside origin.originalUserUtterance; do not paraphrase",
     );
   }
+  const summary = stringField(information.value, "summary");
+  if (!summary) {
+    throw new Error("human_subjective_view.* requires value.summary: the agent's restatement of the user's words");
+  }
+  if (normalizeWhitespace(summary) === normalizeWhitespace(rawText)) {
+    throw new Error("human_subjective_view.* value.summary must restate value.rawText, not repeat it");
+  }
   return information;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaventures/cli",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "CLI + MCP server for the Llama Ventures investment workbench (command.llamaventures.vc).",
   "type": "module",
   "scripts": {