@llamaventures/cli 2.1.3 → 2.2.0

package/AGENT_BRIEFING.md

@@ -162,16 +162,27 @@ Always submit raw user information first when losing it would be unacceptable:
 }
 ```
 
-Then, when useful, write a structured Information unit:
+Then, when useful, write a structured Information unit. Before each one, ask a
+single question: is this a Llama user's own subjective judgment? Subjective
+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`.
 
 ```json
 {
   "operation": "information.put",
   "dealId": "<uuid>",
-  "type": "founder.opinion",
-  "labels": ["human_view"],
+  "type": "human_subjective_view.people",
   "subject": {"person": "Founder name"},
-  "value": {"speaker": "user", "view": "strong product taste"},
+  "value": {
+    "speaker": "<Llama user>",
+    "rawText": "I think the founder has strong product taste.",
+    "summary": "Strong product taste, per the user."
+  },
   "origin": {
     "kind": "user",
     "originalUserUtterance": "I think the founder has strong product taste."

package/CHANGELOG.md

@@ -6,6 +6,17 @@ this project adheres to [Semantic Versioning](https://semver.org).
 
 ## [Unreleased]
 
+## [2.2.0] - 2026-09-04
+
+### Added
+- Define `human_subjective_view.people` and `human_subjective_view.business`
+  as the only Information types for a Llama user's own judgment. CLI and MCP
+  reject them locally unless `value.speaker` is set and `value.rawText`
+  appears verbatim inside `origin.originalUserUtterance`; retired aliases
+  (`human_view`, `human_statement`, `human_opinion`, `human_judgment`,
+  `partner_view`) are refused with the replacement named. Core enforces the
+  same rule server-side.
+
 ## [2.1.3] - 2026-09-03
 
 ### 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.",
+    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.",
     // 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,6 +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>"}}
   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":"..."}}
 
@@ -115,6 +116,12 @@ with storageKey (+ optional storageUrl) plus byteSize and sha256 instead.
 For Information, origin records who caused the write and preserves user words;
 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.
+
 Core owns Chat Records, append-only Deal Events, Drive provisioning, audit,
 and idempotency. User-originated work must preserve exact wording in
 origin.originalUserUtterance or reference origin.originatingChatRecordId.`;

package/lib/build-manifest.json

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

package/lib/deal-actions.mjs

@@ -9,6 +9,72 @@ export const DEAL_WRITE_OPERATIONS = Object.freeze([
   "artifact.put",
 ]);
 
+/**
+ * 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.
+ */
+export const HUMAN_SUBJECTIVE_VIEW_TYPES = Object.freeze([
+  "human_subjective_view.people",
+  "human_subjective_view.business",
+]);
+
+const RETIRED_HUMAN_VIEW_TYPES = Object.freeze([
+  "human_view",
+  "human_statement",
+  "human_opinion",
+  "human_judgment",
+  "partner_view",
+]);
+
+function normalizeWhitespace(text) {
+  return String(text).replace(/\s+/g, " ").trim();
+}
+
+function stringField(object, key) {
+  const value = object && typeof object === "object" && !Array.isArray(object) ? object[key] : undefined;
+  return typeof value === "string" ? value.trim() : "";
+}
+
+export function validateHumanSubjectiveView(information, origin) {
+  const type = stringField(information, "type");
+  const lower = type.toLowerCase();
+  if (RETIRED_HUMAN_VIEW_TYPES.includes(lower) || lower.startsWith("human_view.")) {
+    throw new Error(
+      `Information type "${type}" is retired: a Llama user's own judgment is human_subjective_view.people or human_subjective_view.business`,
+    );
+  }
+  if (lower !== "human_subjective_view" && !lower.startsWith("human_subjective_view.")) {
+    return information;
+  }
+  if (!HUMAN_SUBJECTIVE_VIEW_TYPES.includes(type)) {
+    throw new Error(
+      "human_subjective_view must be exactly human_subjective_view.people (team) or human_subjective_view.business (deal)",
+    );
+  }
+  const utterance = origin?.kind === "user" ? stringField(origin, "originalUserUtterance") : "";
+  if (!utterance) {
+    throw new Error(
+      "human_subjective_view.* must originate from a user and carry the user's words in origin.originalUserUtterance",
+    );
+  }
+  const speaker = stringField(information.value, "speaker");
+  const rawText = stringField(information.value, "rawText");
+  if (!speaker) {
+    throw new Error("human_subjective_view.* requires value.speaker: the Llama user whose judgment this is");
+  }
+  if (!rawText) {
+    throw new Error("human_subjective_view.* requires value.rawText: the user's verbatim words");
+  }
+  if (!normalizeWhitespace(utterance).includes(normalizeWhitespace(rawText))) {
+    throw new Error(
+      "human_subjective_view.* value.rawText must appear verbatim inside origin.originalUserUtterance; do not paraphrase",
+    );
+  }
+  return information;
+}
+
 function canonicalJson(value) {
   if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
   if (value && typeof value === "object") {
@@ -153,9 +219,14 @@ export function prepareDealCommand(action, input) {
   }
   if (action === "create") {
     validateLocalizedTextPairs(command.page ?? {});
+    const information = Array.isArray(command.information) ? command.information : [];
+    for (const item of information) validateHumanSubjectiveView(item, command.origin);
   }
   if (action === "write" && command.operation === "page.patch") {
     validateLocalizedTextPairs(command.patch ?? {});
   }
+  if (action === "write" && command.operation === "information.put") {
+    validateHumanSubjectiveView(command, command.origin);
+  }
   return ensureIdempotencyKey(validateCommandOrigin(command));
 }

package/package.json

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