@llamaventures/cli 1.19.0 → 1.20.0

package/AGENT_BRIEFING.md

@@ -63,10 +63,11 @@ A teammate says "I just met them and heard…" or pastes a chunk of notes. Your
 
 1. **Find the deal** — `llama deal search "<name>"` (Pipeline First). New name → offer to create it.
 2. **Split what they gave you into two kinds** — this is the whole data model:
+   - **A source packet with 2+ facts, or facts + a note → ingest once.** Build a JSON object with `source`, `facts`, and optional `note`, then run `llama deal ingest <dealId> --file <packet.json>`. This is the preferred agent path: one atomic, deduplicated, retry-safe commit. Reuse an explicit `idempotencyKey` when retrying the same material. The matching MCP tool is `deal_ingest` and uses the same packet shape.
    - **Verifiable claims → facts.** `llama deal fact add <dealId> --category <cat> --claim "…" --source "<where it came from>" --source-url <url>`. A claim someone *relayed* ("their ARR is $3M", "raised from a16z") is a fact at **unverified** trust — it's hearsay until checked. Pass `--attested` ONLY if you actually verified it against a source yourself. In raw API terms, the fact text field is `claim` (`value` is only a compatibility alias), `source` is the human-readable provenance label, and `sourceUrl` is the canonical URL.
    - **Their judgment / impression → a note.** `llama post <dealId> "…"`. "Founder seemed evasive", "I'd lean pass", "worth a second meeting" — opinion, not fact. Attributed, never "verified".
    - A pasted blob → pull the verifiable claims out as facts, capture their take as a note.
-3. **Read it back before you claim it's saved.** A tool call returning `{ok:true}` is NOT proof the content is where the user will look for it. After filing, run `llama deal feed <dealId>` and confirm your fact/note actually appears, THEN tell the user in plain language what you recorded and where. Never say "记好了 / saved" from the return value alone — the #1 failure is an agent writing to the wrong surface (e.g. the brief, which is the Memo and does NOT appear in the feed) and reporting success anyway. If it's not in the feed, you routed it wrong — fix it.
+3. **Read it back before you claim it's saved.** A generic tool call returning `{ok:true}` is NOT proof the content is where the user will look for it. `deal ingest` is the exception because its response is built from the rows and note block read back after commit: confirm `createdFacts`, `skippedFacts`, `note`, and `summary` in that receipt. For every other write, run `llama deal feed <dealId>` and confirm your fact/note actually appears. Never say "记好了 / saved" from a request acknowledgment alone — the #1 failure is an agent writing to the wrong surface (e.g. the brief, which is the Memo and does NOT appear in the feed) and reporting success anyway. If the authoritative ingest receipt or the feed read-back does not contain the material, fix it before reporting success.
    - **Authorship is automatic, don't fake it.** Everything you write via CLI/MCP is recorded as "via assistant" (you're the accountable human's assistant). You can't and shouldn't make it read as human-typed — that honesty is the feature. Facts you add stay **unverified** until a human confirms them; if you pass `--attested` (only when you actually checked the source) your ceiling is **agent-verified**, never human-vouched. Only a person, signed in at the browser, can vouch. The confirmation IS the trust step — never silently mark something verified.
 
 Why split it: facts and opinions live in different layers so the deal keeps one clean **source of truth** (facts, sourced + trust-rated) separate from people's **takes** (notes). The four layers — facts / notes / brief (AI's synthesis) / timeline — are documented in Llama Command's `docs/SCHEMA.md`.
@@ -130,6 +131,7 @@ These three look similar but land in different surfaces. Don't infer from the co
 
 | You want to… | Command | Lands in |
 |---|---|---|
+| File a **source packet** with multiple facts and/or one note | `llama deal ingest <dealId> --file packet.json` | Facts + optional note → deal **Feed**, atomically and retry-safe |
 | Record a **sourced, verifiable fact** | `llama deal fact add <dealId> --category <cat> --claim "…" --source "deck p3" --source-url <url>` | Facts → deal **Feed** (FACT card) + citable in the **Memo** |
 | Leave a **comment / opinion / question / reaction** for the team | `llama post <dealId> "…"` (`@name` to notify) | Posts → deal **Feed** (POST card); `@mention` fires email + UI badge |
 | Write **narrative that belongs in the IC memo** | `llama brief add-text <dealId> --heading "…" --body "…"` | Brief blocks → **Memo tab only — NOT in the Feed** |
@@ -298,7 +300,7 @@ Run `llama --help` for the full surface (~40 commands).
 
 ## MCP-native agents
 
-If you support [MCP](https://modelcontextprotocol.io), **prefer the MCP server over parsing CLI output.** The same package ships `llama-mcp` (59 typed tools, identical auth chain).
+If you support [MCP](https://modelcontextprotocol.io), **prefer the MCP server over parsing CLI output.** The same package ships `llama-mcp` (55 typed tools, identical auth chain).
 
 Add to your MCP client config (Claude Desktop / Claude Code / Cursor / OpenClaw / Codex / etc.):
 

package/CHANGELOG.md

@@ -6,6 +6,30 @@ this project adheres to [Semantic Versioning](https://semver.org).
 
 ## [Unreleased]
 
+## [1.20.0] - 2026-07-22
+
+### Added
+- Add `llama deal ingest <dealId> --file <packet.json>` and the matching
+  `deal_ingest` MCP tool for atomic, retry-safe source packets containing up to
+  50 facts and an optional Feed note.
+- Add `llama pref list|add|retire|approve` and the `pref_list` / `pref_add` /
+  `pref_set_status` MCP tools for standing agent preferences (Core API 3.1.0).
+  Own user scope activates immediately; team scope requires system-admin
+  approval. Content is hard-capped at 280 chars.
+
+### Changed
+- Prefer packet ingest for multi-fact agent writes; Core now canonicalizes fact
+  categories and skips exact source-aware duplicates before committing.
+- Pin the Core API consumer contract to 3.1.0.
+
+### Removed
+- Remove the retired generated-persona refresh and skill-correction commands
+  from the CLI, MCP tool registry, and required Core operation inventory.
+  Llama Command keeps authenticated historical reads and 410 compatibility
+  tombstones, but new clients can no longer invoke the retired workflow.
+- Remove `llama eval` and the `record_eval_feedback` MCP tool; the server-side
+  Golden Query Eval candidate pipeline was retired with Core API 3.0.0.
+
 ## [1.19.0] - 2026-07-16
 
 ### Added

package/README.md

@@ -7,7 +7,7 @@
 <p align="center">
   <strong>The Llama Ventures CLI &amp; MCP server.</strong><br/>
   One package, two binaries: <code>llama</code> — the CLI for humans and scripts —
-  and <code>llama-mcp</code> — a stdio MCP server with 59 typed tools for any
+  and <code>llama-mcp</code> — a stdio MCP server with 55 typed tools for any
   MCP-native agent. Both share the same auth chain, HTTP client, and error
   format, and talk to <a href="https://command.llamaventures.vc">command.llamaventures.vc</a>.
 </p>
@@ -98,6 +98,7 @@ llama deal feed <dealId>               # every contribution, newest first
 llama activity new-deals --since 24h   # recent deal creations
 llama activity updated-deals --since 7d # meaningful updates grouped by deal
 llama deal create "Acme AI" --source alex --deal-owner owner@llamaventures.vc --source-direction Outbound --status Interested
+llama deal ingest <dealId> --file packet.json  # atomic multi-fact + optional Feed note; retry-safe
 llama deal fact add <dealId> --category funding --claim "Raised a seed round" --source "deck p3" --source-url https://...
 llama deal update <dealId> status Diligence
 llama post <dealId> "note body"
@@ -113,6 +114,13 @@ Status vocabulary — `Interested`: tracked before any contact ·
 signal exists. `sourceDirection` is separate: `Inbound` came to the firm,
 `Outbound` we reached out first.
 
+For a deck, meeting note, email, or research packet, prefer `deal ingest` over a
+loop of `deal fact add` calls. The JSON object accepts `source`, up to 50
+`facts`, an optional `note`, and an optional `idempotencyKey`. The server commits
+the packet atomically, maps common category aliases into the canonical taxonomy,
+and skips exact source-aware duplicates. `deal fact add` remains the simple path
+for one fact.
+
 Facts use `claim` for the fact text. `source` is a readable provenance label
 and `sourceUrl` is the canonical evidence URL; both round-trip from the API.
 For deal owners, use an exact `/api/field-options` `dealOwner` value, a user
@@ -129,12 +137,11 @@ reference (100+ commands). Deletes are soft and audit-logged everywhere.
 | `Error[UNAUTHORIZED]` | Server rejected the credentials | Token revoked / expired / wrong account |
 
 The MCP server returns the same prefixes inside `isError: true` content.
-Authenticated calls send bounded, content-redacted telemetry to Command;
-`llama eval good|bad --last` turns real searches into eval feedback.
+Authenticated calls send bounded, content-redacted telemetry to Command.
 
 ## MCP server
 
-`llama-mcp` is a stdio Model Context Protocol server exposing 59 typed tools
+`llama-mcp` is a stdio Model Context Protocol server exposing 55 typed tools
 that mirror the most-used CLI surface. Every tool is named and scoped — there
 is deliberately no generic API passthrough. Auth is identical to the CLI's
 chain. For the exact live list, pipe `tools/list` through it:

package/README.zh-CN.md

@@ -7,7 +7,7 @@
 <p align="center">
   <strong>Llama Ventures 的 CLI 与 MCP server。</strong><br/>
   一个包、两个可执行文件：<code>llama</code>——给人和脚本用的 CLI；
-  <code>llama-mcp</code>——带 59 个类型化工具的 stdio MCP server，任何
+  <code>llama-mcp</code>——带 55 个类型化工具的 stdio MCP server，任何
   MCP 原生 agent 都能接。两者共享同一认证链、同一 HTTP 客户端、同一错误格式，
   连接 <a href="https://command.llamaventures.vc">command.llamaventures.vc</a>。
 </p>
@@ -120,6 +120,7 @@ llama deal feed <dealId>               # 该 deal 的全部贡献，最新在前
 llama activity new-deals --since 24h   # 最近新建的 deal
 llama activity updated-deals --since 7d # 按 deal 聚合的实质更新
 llama deal create "Acme AI" --source alex --deal-owner owner@llamaventures.vc --source-direction Outbound --status Interested
+llama deal ingest <dealId> --file packet.json  # 多条 facts + 可选 Feed note，一次提交且可安全重试
 llama deal fact add <dealId> --category funding --claim "Raised a seed round" --source "deck p3" --source-url https://...
 llama deal update <dealId> status Diligence
 llama post <dealId> "备注内容"
@@ -134,6 +135,11 @@ Status 语义——`Interested`：接触前先记录关注 · `Outreached`：已
 尚无回应 · `Sourced`：已有真实关系信号。`sourceDirection` 是独立维度：
 `Inbound` 流入，`Outbound` 我们主动。
 
+处理 deck、会议笔记、邮件或研究材料时，优先使用 `deal ingest`，不要循环调用
+`deal fact add`。JSON 对象支持 `source`、最多 50 条 `facts`、可选 `note` 和可选
+`idempotencyKey`。服务端会原子提交整个材料包、把常见 category 别名归一到固定分类，
+并跳过来源一致的精确重复。只有真正的单条事实才用 `deal fact add`。
+
 Facts 的正文用 `claim`。`source` 是人可读来源标签，`sourceUrl` 是 canonical
 证据 URL；两者都会从 API 回显。`dealOwner` 请用 `/api/field-options`
 里的精确 `dealOwner` 值、用户邮箱，或数字 user id。
@@ -153,7 +159,7 @@ MCP server 在 `isError: true` 内容里返回相同前缀。认证请求会向
 
 ## MCP server
 
-`llama-mcp` 是 stdio MCP server，59 个类型化工具镜像 CLI 最常用的命令面。
+`llama-mcp` 是 stdio MCP server，55 个类型化工具镜像 CLI 最常用的命令面。
 每个工具具名、有边界——**故意不提供**通用 API passthrough。认证链与 CLI
 完全一致。精确工具清单以 `tools/list` 为准：
 

package/bin/llama-mcp.mjs

@@ -15,7 +15,6 @@ import { z } from "zod";
 import {
   getAuthHeaders,
   getBaseUrl,
-  getLastAgentEvent,
   readBriefing,
   request,
   requestSse,
@@ -84,20 +83,6 @@ function splitSources(value) {
     .filter(Boolean);
 }
 
-function expectedIds(value) {
-  const expected = { dealIds: [], wikiSlugs: [], raw: [] };
-  if (!value) return expected;
-  const items = Array.isArray(value) ? value : String(value).split(",");
-  for (const item of items.map((s) => String(s).trim()).filter(Boolean)) {
-    const [kind, ...rest] = item.split(":");
-    const id = rest.join(":").trim();
-    if (kind === "deal" && id) expected.dealIds.push(id);
-    else if ((kind === "wiki" || kind === "slug") && id) expected.wikiSlugs.push(id);
-    else expected.raw.push(item);
-  }
-  return expected;
-}
-
 function buildEnrichmentAgentMessage(args = {}) {
   if (args.message) return String(args.message);
   const sources = splitSources(args.sources) ?? [
@@ -257,41 +242,6 @@ server.registerTool(
   }
 );
 
-server.registerTool(
-  "record_eval_feedback",
-  {
-    description:
-      "Mark the latest llama CLI/MCP result as good/bad or add a real query " +
-      "to the Golden Query Eval candidate pool. Use when the user says a " +
-      "Llama Command search/result was right, wrong, missing a source, or should be regression-tested.",
-    inputSchema: {
-      action: z.enum(["good", "bad", "add"]).describe("feedback action"),
-      eventId: z.number().optional().describe("agent_client_events id; defaults to latest local event"),
-      query: z.string().optional().describe("required for manual add when no source event is available"),
-      surface: z.string().optional().describe("deal, wiki, activity, people, or manual"),
-      expect: z
-        .union([z.string(), z.array(z.string())])
-        .optional()
-        .describe("expected ids like wiki:llamaos-weekly-2026-06-17 or deal:<uuid>"),
-      reason: z.string().optional().describe("why this was good/bad or should be tracked"),
-      privacyLevel: z.string().optional().describe("default internal"),
-    },
-  },
-  async ({ action, eventId, query, surface, expect, reason, privacyLevel }) => {
-    const last = getLastAgentEvent();
-    const body = {
-      action,
-      eventId: eventId ?? last?.lastEventId,
-      query,
-      surface: surface ?? last?.lastSurface,
-      expected: expectedIds(expect),
-      reason,
-      privacyLevel: privacyLevel ?? "internal",
-    };
-    return callApi("POST", "/api/agent/eval-feedback", body);
-  }
-);
-
 server.registerTool(
   "skills_search",
   {
@@ -311,6 +261,60 @@ server.registerTool(
   }
 );
 
+server.registerTool(
+  "pref_list",
+  {
+    description:
+      "List standing agent preferences (team scope + the caller's user scope). " +
+      "These are injected into every server-side agent turn. Use status=proposed " +
+      "to review pending proposals awaiting approval.",
+    inputSchema: {
+      status: z.enum(["active", "proposed", "retired", "all"]).optional()
+        .describe("filter; defaults to active"),
+    },
+  },
+  async ({ status }) => {
+    const params = new URLSearchParams();
+    if (status) params.set("status", status);
+    return callApi("GET", `/api/agent/preferences${params.toString() ? `?${params}` : ""}`);
+  }
+);
+
+server.registerTool(
+  "pref_add",
+  {
+    description:
+      "Save a standing preference so every Llama agent follows it from the next " +
+      "turn on. Use when the user states a durable way they want agents to work " +
+      "(style, workflow, defaults). Content is hard-capped at 280 chars — if it " +
+      "does not fit, it is a procedure and belongs in a skill. Team scope needs " +
+      "system-admin approval; own user scope activates immediately.",
+    inputSchema: {
+      key: z.string().describe("short slug, e.g. reply-style.conclusion-first"),
+      content: z.string().describe("the preference, max 280 chars"),
+      scope: z.enum(["user", "team"]).optional().describe("default user (the caller)"),
+      evidence: z.string().optional().describe("what prompted this (run, correction)"),
+    },
+  },
+  async ({ key, content, scope, evidence }) =>
+    callApi("POST", "/api/agent/preferences", { key, content, scope, evidence })
+);
+
+server.registerTool(
+  "pref_set_status",
+  {
+    description:
+      "Approve (activate) or retire a standing preference by id. Own user scope " +
+      "is self-service; team scope requires a system admin.",
+    inputSchema: {
+      id: z.number().describe("preference id from pref_list"),
+      status: z.enum(["active", "retired"]).describe("new status"),
+    },
+  },
+  async ({ id, status }) =>
+    callApi("PATCH", `/api/agent/preferences/${encodeURIComponent(String(id))}`, { status })
+);
+
 server.registerTool(
   "skills_read",
   {
@@ -509,6 +513,50 @@ server.registerTool(
 // Deal facts (research substrate + trust ladder)
 // ============================================================
 
+server.registerTool(
+  "deal_ingest",
+  {
+    description:
+      "Preferred write tool when one source yields multiple facts, or facts plus a Feed note. " +
+      "Commits the packet atomically, canonicalizes fact categories, skips exact source-aware " +
+      "duplicates, and is safe to retry with the same idempotencyKey. Use deal_fact_add only " +
+      "for a genuinely single fact. Canonical categories: company_basics, team, product, market, " +
+      "financials, fundraise, risk, milestone, meta.",
+    inputSchema: {
+      dealId: z.string(),
+      idempotencyKey: z
+        .string()
+        .optional()
+        .describe("Stable key for retries. If omitted, the server derives one from packet content."),
+      source: z
+        .object({
+          kind: z.enum(["deck", "web", "meeting_note", "email", "human", "agent_inference"]).optional(),
+          title: z.string().optional(),
+          url: z.string().optional(),
+          contentHash: z.string().optional(),
+        })
+        .optional(),
+      facts: z
+        .array(z.object({
+          category: z.string(),
+          claim: z.string(),
+          source: z.string().optional(),
+          sourceUrl: z.string().optional(),
+          sourceKind: z.enum(["deck", "web", "meeting_note", "email", "human", "agent_inference"]).optional(),
+          confidence: z.enum(["high", "medium", "low"]).optional(),
+          attested: z.boolean().optional(),
+        }))
+        .max(50)
+        .optional(),
+      note: z.string().optional().describe("Opinion, impression, or context to add to the deal Feed."),
+    },
+  },
+  async ({ dealId, ...packet }) => {
+    // @core-api-operation POST /api/deals/{dealId}/ingest
+    return callApi("POST", `/api/deals/${encodeURIComponent(dealId)}/ingest`, packet);
+  }
+);
+
 server.registerTool(
   "deal_fact_list",
   {
@@ -613,7 +661,7 @@ server.registerTool(
       "accountable person, null only for principal-less system writes) and `agent` " +
       "(the assistant/system label when an AI did the writing, null when a human " +
       "typed it) so you can tell human-typed from assistant-drafted. The AI's " +
-      "regenerable brief/persona synthesis is NOT here (that's the Memo) — only " +
+      "regenerable brief synthesis is NOT here (that's the Memo) — only " +
       "facts + discussion notes. Each item: kind (fact|note), ts, who, agent, " +
       "origin, text, and for facts: source + trust rung + category.",
     inputSchema: {
@@ -993,63 +1041,7 @@ server.registerTool(
 );
 
 // ============================================================
-// Skill corrections (persona-owner pushback workflow)
-// ============================================================
-
-server.registerTool(
-  "skill_correction_list",
-  {
-    description:
-      "List the recorded corrections (long-term rules) for a persona/skill. These shape how " +
-      "that persona's analysis is generated.",
-    inputSchema: {
-      skillSlug: z.string(),
-      includeDeleted: z.boolean().optional(),
-    },
-  },
-  async ({ skillSlug, includeDeleted }) => {
-    const params = new URLSearchParams({ skill: skillSlug });
-    if (includeDeleted) params.set("include_deleted", "1");
-    return callApi("GET", `/api/skill-corrections?${params}`);
-  }
-);
-
-server.registerTool(
-  "skill_correction_add",
-  {
-    description:
-      "Record a long-term correction rule for a persona/skill (e.g. 'always check burn multiple " +
-      "before commenting on efficiency'). ALWAYS reconfirm the distilled rule with the user before " +
-      "calling — this changes how the persona behaves going forward. Optionally tie it to the deal/" +
-      "block where it came up.",
-    inputSchema: {
-      skillSlug: z.string(),
-      correctionText: z.string(),
-      dealUuid: z.string().optional(),
-      blockId: z.string().optional(),
-    },
-  },
-  async ({ skillSlug, correctionText, dealUuid, blockId }) =>
-    callApi("POST", "/api/skill-corrections", {
-      skill_slug: skillSlug,
-      correction_text: correctionText,
-      triggered_in_deal_uuid: dealUuid ?? null,
-      triggered_in_block_id: blockId ?? null,
-    })
-);
-
-server.registerTool(
-  "skill_correction_delete",
-  {
-    description: "Soft-delete a recorded skill correction by id.",
-    inputSchema: { id: z.union([z.string(), z.number()]) },
-  },
-  async ({ id }) =>
-    callApi("DELETE", `/api/skill-corrections/${encodeURIComponent(String(id))}`)
-);
-
-// ============================================================
-// Brief / persona refresh (signal-driven re-evaluation)
+// Brief refresh (signal-driven re-evaluation)
 // ============================================================
 
 server.registerTool(
@@ -1070,22 +1062,6 @@ server.registerTool(
     )
 );
 
-server.registerTool(
-  "deal_refresh_persona",
-  {
-    description:
-      "Regenerate one persona's analysis section for a deal. persona = a server-configured " +
-      "persona key (unknown keys are rejected; discover the roster via agent_bootstrap). " +
-      "Returns a runId (or null if debounced).",
-    inputSchema: {
-      dealId: z.string(),
-      persona: z.string(),
-    },
-  },
-  async ({ dealId, persona }) =>
-    callApi("POST", `/api/deals/${encodeURIComponent(dealId)}/refresh-persona`, { persona })
-);
-
 server.registerTool(
   "deal_agent_run",
   {

package/bin/llama.mjs

@@ -2,6 +2,7 @@
 
 import { createRequire } from "module";
 import { randomUUID } from "crypto";
+import { readFile } from "fs/promises";
 import readline from "readline";
 import {
   DEFAULT_BASE_URL,
@@ -11,7 +12,6 @@ import {
   TOKEN_FILE,
   getAuthHeaders,
   getBaseUrl,
-  getLastAgentEvent,
   getToken,
   print,
   readBriefing,
@@ -175,45 +175,6 @@ function slugifyTitle(title) {
   return slug;
 }
 
-function parseExpectedIds(raw) {
-  const text = typeof raw === "string" ? raw : "";
-  const expected = { dealIds: [], wikiSlugs: [], raw: [] };
-  for (const item of text.split(",").map((s) => s.trim()).filter(Boolean)) {
-    const [kind, ...rest] = item.split(":");
-    const value = rest.join(":").trim();
-    if (kind === "deal" && value) expected.dealIds.push(value);
-    else if ((kind === "wiki" || kind === "slug") && value) expected.wikiSlugs.push(value);
-    else expected.raw.push(item);
-  }
-  return expected;
-}
-
-async function submitEvalFeedback(action, flags, queryText = "") {
-  const useLast = flags.last !== false;
-  const last = useLast ? getLastAgentEvent() : null;
-  const eventId =
-    flags.event && flags.event !== true
-      ? Number(flags.event)
-      : last?.lastEventId ?? null;
-  if ((action === "good" || action === "bad") && !eventId && !queryText) {
-    throw new Error(`Usage: llama eval ${action} [--last] [--reason "..."]`);
-  }
-  const body = {
-    action,
-    eventId: Number.isFinite(eventId) ? eventId : undefined,
-    query: queryText || undefined,
-    surface: flags.surface && flags.surface !== true ? String(flags.surface) : last?.lastSurface ?? undefined,
-    expected:
-      flags.expect && flags.expect !== true
-        ? parseExpectedIds(String(flags.expect))
-        : {},
-    reason: flags.reason && flags.reason !== true ? String(flags.reason) : undefined,
-    privacyLevel:
-      flags.privacy && flags.privacy !== true ? String(flags.privacy) : "internal",
-  };
-  return request("POST", "/api/agent/eval-feedback", body);
-}
-
 // Client-side fuzzy match — used as a fallback when the server hasn't yet
 // shipped the search/filter API (Fix B, 2026-04-25). Once the server
 // returns the `{deals,total,limit,offset}` envelope, this path is never
@@ -403,8 +364,8 @@ Agent onboarding (run once on first install):
   llama activity new-deals --since 24h  # recent deal creations for agents
   llama activity updated-deals --since 7d # meaningful deal updates, grouped
   llama explain <url-or-object>         # explain Command URL/object status + lifecycle
-  llama eval good|bad --last            # mark the latest CLI/MCP result for eval
-  llama eval add "<query>" --expect wiki:<slug>|deal:<uuid>
+  llama pref list [--status proposed]   # standing agent preferences (injected every turn)
+  llama pref add reply-style "Lead with the conclusion." [--team]
 
 External pitch — talk to Llama Ventures' intake agent (no token required):
   llama pitch start --name "Jane Doe" --email "jane@acme.ai"
@@ -514,7 +475,7 @@ Brief blocks:
 
   Common flags on every add-*:
     --source-section <key>   Target a structured section (team, highlights, recommendation,
-                             <persona>_analysis, ...). Without this, blocks land in "_other"
+                             landscape_map, competitors). Without this, blocks land in "_other"
                              at the bottom of the TOC. AI writers want this.
     --reply-to <blockId>     Make the block a reply to <blockId>. Snapshots parent's heading
                              + 200-char excerpt into meta so the back-link survives parent
@@ -523,10 +484,9 @@ Brief blocks:
                              2026-05-03). Use bottom for batched writes that need to
                              preserve insertion order.
 
-Brief / persona refresh + agent-run revert:
+Brief refresh + agent-run revert:
   llama deal refresh-brief <dealId> [--force]                  # re-eval stale sections
                                                                 # --force = every unlocked watcher-managed section
-  llama deal refresh-persona <dealId> <persona-key>            # server validates persona key
   llama deal revert-run <dealId> <runId> --section <key>       # legacy 4-section model only
                                                                 # section: company|team|highlights|recommendation
 
@@ -536,17 +496,13 @@ Deal soft-delete / restore / trash list:
   llama deal trash                                             # list deleted deals
 
 Deal facts (AI-extracted or human-asserted, with verification):
+  llama deal ingest <dealId> --file <packet.json> [--idempotency-key <key>]  # atomic facts + optional Feed note
+    packet: {"source":{"kind":"meeting_note","title":"Office visit"},"facts":[{"category":"team","claim":"..."}],"note":"..."}
+    categories: company_basics | team | product | market | financials | fundraise | risk | milestone | meta
   llama deal fact list <dealId>
   llama deal fact add <dealId> --category <cat> --claim "<text>" [--source "..."] [--source-url <url>] [--confidence high|medium|low] [--attested]
   llama deal fact verify <dealId> <factId> --status confirmed|disputed [--corrected-value "..."]
 
-Skill corrections (persona-owner pushback — read by persona-watcher):
-  llama skill-correction list <skill-slug> [--include-deleted]
-  llama skill-correction add <skill-slug> "<correction text>" [--deal <uuid>] [--block <blockId>]
-  llama skill-correction delete <id>
-  Server enforces persona owner OR system admin on POST/DELETE; GET is open.
-  External personas (owner_email=null) are admin-only for write.
-
 Mentions / Inbox:
   llama mentions                                       # default: my unresolved cues
   llama mentions list [--everyone] [--all]             # --everyone = team-wide; --all = include resolved
@@ -663,7 +619,6 @@ Common:
   llama agent bootstrap             live Llama OS skill manifest from Command
   llama skills search "<query>"     discover which skill to read
   llama explain <url-or-object>     explain Command URLs, 404s, deleted objects
-  llama eval bad --last              mark latest CLI/MCP result as an eval candidate
 
 Command groups — run \`llama help <group>\` for that group's commands:
   deal        create · show · feed · update · enrich · search · collaborators · links · delete
@@ -672,7 +627,7 @@ Command groups — run \`llama help <group>\` for that group's commands:
   facts       deal facts + skill corrections (the sourced, trust-rated layer)
   timeline    timeline · posts · mentions
   wiki        cross-deal knowledge entries (markdown or HTML)
-  eval        mark real CLI/MCP searches good/bad or add a golden-query candidate
+  pref        standing agent preferences: list · add · retire · approve
   memo        long-form HTML investment memo
   html        deal-specific HTML artifacts (/deals/<id>/browse/<slug>)
   pitch       external founder intake (no token needed)
@@ -691,7 +646,7 @@ the CLI auto-detects it — no token needed (\`llc_\` tokens are a fallback).`;
 const HELP_AREA_MATCH = {
   deal: [/^Deals/, /^Collaborators/, /^Soft-delete/, /^Deal links/, /^Deal soft-delete/],
   activity: [/^Agent activity/],
-  brief: [/^Brief blocks/, /^Brief \/ persona/],
+  brief: [/^Brief blocks/],
   facts: [/^Deal facts/, /^Skill corrections/],
   timeline: [/^Timeline/, /^Mentions/],
   wiki: [/^Wiki/, /^Where does this HTML/],
@@ -1164,6 +1119,49 @@ async function main() {
     throw new Error(`Unknown skills subcommand "${sub}". Use: list / search / show.`);
   }
 
+  // `llama pref ...` — standing agent preferences (learning-domain v1).
+  // Own user scope activates immediately; team scope needs a system admin.
+  if (area === "pref" || area === "prefs" || area === "preferences") {
+    const sub = action;
+    if (!sub || sub === "list") {
+      const { flags } = parseFlags(rest, ["json", "status"]);
+      const params = new URLSearchParams();
+      if (flags.status && flags.status !== true) params.set("status", String(flags.status));
+      const result = await request("GET", `/api/agent/preferences${params.toString() ? `?${params}` : ""}`);
+      print(result);
+      return;
+    }
+    if (sub === "add") {
+      const { flags, positional } = parseFlags(rest, ["team", "evidence", "json"]);
+      const key = positional[0];
+      const content = positional.slice(1).join(" ").trim();
+      if (!key || !content) {
+        throw new Error('Usage: llama pref add <key> "<content, max 280 chars>" [--team] [--evidence "..."]');
+      }
+      const result = await request("POST", "/api/agent/preferences", {
+        scope: flags.team ? "team" : "user",
+        key,
+        content,
+        evidence: flags.evidence && flags.evidence !== true ? String(flags.evidence) : undefined,
+      });
+      print(result);
+      return;
+    }
+    if (sub === "retire" || sub === "approve") {
+      const { positional } = parseFlags(rest, ["json"]);
+      const id = Number(positional[0]);
+      if (!Number.isInteger(id) || id <= 0) {
+        throw new Error(`Usage: llama pref ${sub} <id>`);
+      }
+      const result = await request("PATCH", `/api/agent/preferences/${id}`, {
+        status: sub === "approve" ? "active" : "retired",
+      });
+      print(result);
+      return;
+    }
+    throw new Error(`Unknown pref subcommand "${sub}". Use: list / add / retire / approve.`);
+  }
+
   if (area === "explain" || (area === "agent" && action === "explain")) {
     const args = area === "explain" ? [action, ...rest].filter(Boolean) : rest;
     const { flags, positional } = parseFlags(args, ["json", "type", "id", "lang"]);
@@ -1201,43 +1199,6 @@ async function main() {
     return;
   }
 
-  if (area === "eval") {
-    const sub = action;
-    if (sub === "good" || sub === "bad") {
-      const { flags, positional } = parseFlags(rest, [
-        "last",
-        "event",
-        "reason",
-        "expect",
-        "surface",
-        "privacy",
-      ]);
-      const q = positional.join(" ").trim();
-      print(await submitEvalFeedback(sub, flags, q));
-      return;
-    }
-    if (sub === "add") {
-      const { flags, positional } = parseFlags(rest, [
-        "event",
-        "expect",
-        "reason",
-        "surface",
-        "privacy",
-      ]);
-      const q = positional.join(" ").trim();
-      if (!q && !flags.event) {
-        throw new Error(
-          `Usage: llama eval add "<query>" --surface deal|wiki --expect wiki:<slug>|deal:<uuid>`,
-        );
-      }
-      print(await submitEvalFeedback("add", flags, q));
-      return;
-    }
-    throw new Error(
-      "Usage: llama eval good|bad [--last] [--reason ...] OR llama eval add \"<query>\" --expect wiki:<slug>|deal:<uuid>",
-    );
-  }
-
   // `llama pitch ...` — external founder-pitch family. No Llama token
   // required; bootstraps a session against /api/external/* via PoW + cookie.
   // See lib/external.mjs and AGENT_BRIEFING.md for the full surface.
@@ -1763,6 +1724,36 @@ async function main() {
     return;
   }
 
+  // ----- Canonical source-packet ingest (atomic facts + optional Feed note) -----
+  if (area === "deal" && action === "ingest") {
+    const dealId = rest[0];
+    const { flags } = parseFlags(rest.slice(1), ["file", "idempotency-key"]);
+    if (!dealId || !flags.file || flags.file === true) {
+      throw new Error(
+        "Usage: llama deal ingest <dealId> --file <packet.json> [--idempotency-key <key>]\n" +
+        'Packet: {"source":{"kind":"meeting_note","title":"Office visit"},' +
+        '"facts":[{"category":"team","claim":"..."}],"note":"..."}'
+      );
+    }
+
+    let packet;
+    try {
+      packet = JSON.parse(await readFile(String(flags.file), "utf8"));
+    } catch (error) {
+      throw new Error(`Cannot read ingest packet ${flags.file}: ${error?.message ?? String(error)}`);
+    }
+    if (!packet || Array.isArray(packet) || typeof packet !== "object") {
+      throw new Error("Ingest packet must be a JSON object");
+    }
+    if (flags["idempotency-key"] !== undefined && flags["idempotency-key"] !== true) {
+      packet.idempotencyKey = String(flags["idempotency-key"]);
+    }
+
+    // @core-api-operation POST /api/deals/{dealId}/ingest
+    print(await request("POST", `/api/deals/${encodeURIComponent(dealId)}/ingest`, packet));
+    return;
+  }
+
   // ----- Deal facts (AI-extracted or human-asserted, with verification) -----
   if (area === "deal" && action === "fact") {
     const sub = rest[0];
@@ -1839,24 +1830,6 @@ async function main() {
     return;
   }
 
-  // ----- Persona refresh: re-run a single persona-watcher -----
-  // Persona keys are validated server-side. Returns runId or null
-  // (debounced / deal inactive). Used by /admin and the per-block
-  // "重新生成" flow.
-  if (area === "deal" && action === "refresh-persona") {
-    const dealId = rest[0];
-    const persona = rest[1];
-    if (!dealId || !persona) {
-      throw new Error(`Usage: llama deal refresh-persona <dealId> <persona-key>`);
-    }
-    print(await request(
-      "POST",
-      `/api/deals/${encodeURIComponent(dealId)}/refresh-persona`,
-      { persona }
-    ));
-    return;
-  }
-
   // ----- Agent-run revert (legacy 4-section brief model) -----
   // Reverts a single section to the `before` value snapshotted by the
   // watcher run. Does NOT re-fire the watcher (intentional: human action).
@@ -2135,7 +2108,7 @@ Routing — is this the right command?
     const meta = { updated_at: new Date().toISOString(), updated_by: "cli", by_agent: false };
 
     // --source-section <key>: target a structured section (e.g. team /
-    // highlights / <persona>_analysis). Without this, blocks land in the
+    // highlights / competitors). Without this, blocks land in the
     // "_other" group at the bottom of the TOC. AI writers want this
     // virtually always — without it they cannot contribute to existing
     // structured sections.
@@ -2379,63 +2352,6 @@ Routing — is this the right command?
     throw new Error(`Unknown mentions subcommand "${sub}". Use: list / show / resolve / unread.`);
   }
 
-  // ----- Skill corrections (persona-owner pushback workflow) -----
-  // Persona owners (or system admins) record long-term rules each
-  // persona-DD skill must obey. Read by the persona-watcher and prepended
-  // to the system prompt at run time. Soft-delete is non-cascading —
-  // deleting a row does NOT auto-fire watcher; the next natural run
-  // (manual / stale_re_eval) just stops including the deleted rule.
-  //
-  // Permissions enforced server-side: only the persona owner (per
-  // PERSONA_SKILLS in src/lib/persona-skills.ts) or a system admin can
-  // POST or DELETE. Anyone can GET. External personas (owner_email=null)
-  // are admin-only for write.
-  if (area === "skill-correction") {
-    const sub = action;
-
-    if (sub === "list") {
-      const skillSlug = rest[0];
-      if (!skillSlug) {
-        throw new Error("Usage: llama skill-correction list <skill-slug> [--include-deleted]");
-      }
-      const { flags } = parseFlags(rest.slice(1));
-      const params = new URLSearchParams({ skill: skillSlug });
-      if (flags["include-deleted"]) params.set("include_deleted", "1");
-      print(await request("GET", `/api/skill-corrections?${params.toString()}`));
-      return;
-    }
-
-    if (sub === "add") {
-      const { flags, positional } = parseFlags(rest);
-      const skillSlug = positional[0];
-      const correctionText = positional.slice(1).join(" ").trim();
-      if (!skillSlug || !correctionText) {
-        throw new Error(
-          `Usage: llama skill-correction add <skill-slug> "<correction text>" ` +
-          `[--deal <uuid>] [--block <blockId>]`
-        );
-      }
-      print(await request("POST", "/api/skill-corrections", {
-        skill_slug: skillSlug,
-        correction_text: correctionText,
-        triggered_in_deal_uuid: flags.deal ? String(flags.deal) : null,
-        triggered_in_block_id: flags.block ? String(flags.block) : null,
-      }));
-      return;
-    }
-
-    if (sub === "delete") {
-      const id = rest[0];
-      if (!id) throw new Error("Usage: llama skill-correction delete <id>");
-      print(await request("DELETE", `/api/skill-corrections/${encodeURIComponent(id)}`));
-      return;
-    }
-
-    throw new Error(
-      `Unknown skill-correction subcommand "${sub || ""}". Use: list / add / delete.`
-    );
-  }
-
   // ----- Memo (long-form HTML investment memo) -----
   // The Memo tab in the deal page renders HTML stored in deal_memos.
   // Two sources of memo content:

package/contracts/core-api.json

@@ -1,9 +1,9 @@
 {
   "format": "llama.core-api-contract.v1",
   "name": "llama-core-api",
-  "apiVersion": "1.0.1",
+  "apiVersion": "3.1.0",
   "openapiVersion": "3.0.3",
-  "sha256": "95ce3639aeee15b0fed09830116838f2a11fd2e40e4f35bf80d785664ecf8d96",
-  "pathCount": 211,
-  "operationCount": 273
+  "sha256": "51b134af7a63534406b3a216aeab190fd595f5270b2a10263730662f1c2f771a",
+  "pathCount": 212,
+  "operationCount": 275
 }

package/contracts/required-operations.json

@@ -2,90 +2,341 @@
   "format": "llama.cli-core-api-operations.v1",
   "coreApiContract": "contracts/core-api.json",
   "requiredOperations": [
-    { "method": "DELETE", "path": "/api/deals/{dealId}" },
-    { "method": "DELETE", "path": "/api/deals/{dealId}/blocks/{blockId}" },
-    { "method": "DELETE", "path": "/api/deals/{dealId}/collaborators/{userId}" },
-    { "method": "DELETE", "path": "/api/deals/{dealId}/documents/{slug}" },
-    { "method": "DELETE", "path": "/api/deals/{dealId}/documents/{slug}/html" },
-    { "method": "DELETE", "path": "/api/deals/{dealId}/links/{linkId}" },
-    { "method": "DELETE", "path": "/api/deals/{dealId}/memo" },
-    { "method": "DELETE", "path": "/api/skill-corrections/{id}" },
-    { "method": "DELETE", "path": "/api/wiki/{slug}" },
-    { "method": "GET", "path": "/api/admin/agent-events" },
-    { "method": "GET", "path": "/api/admin/auth-events" },
-    { "method": "GET", "path": "/api/admin/deal-events" },
-    { "method": "GET", "path": "/api/agent/activity" },
-    { "method": "GET", "path": "/api/agent/briefing" },
-    { "method": "GET", "path": "/api/agent/explain" },
-    { "method": "GET", "path": "/api/agent/manifest" },
-    { "method": "GET", "path": "/api/agent/skills" },
-    { "method": "GET", "path": "/api/agent/skills/{slug}" },
-    { "method": "GET", "path": "/api/deals" },
-    { "method": "GET", "path": "/api/deals/{dealId}" },
-    { "method": "GET", "path": "/api/deals/{dealId}/blocks" },
-    { "method": "GET", "path": "/api/deals/{dealId}/blocks/{blockId}" },
-    { "method": "GET", "path": "/api/deals/{dealId}/blocks/{blockId}/history" },
-    { "method": "GET", "path": "/api/deals/{dealId}/collaborators" },
-    { "method": "GET", "path": "/api/deals/{dealId}/command-center" },
-    { "method": "GET", "path": "/api/deals/{dealId}/documents" },
-    { "method": "GET", "path": "/api/deals/{dealId}/documents/{slug}/html" },
-    { "method": "GET", "path": "/api/deals/{dealId}/documents/{slug}/html/history" },
-    { "method": "GET", "path": "/api/deals/{dealId}/facts" },
-    { "method": "GET", "path": "/api/deals/{dealId}/feed" },
-    { "method": "GET", "path": "/api/deals/{dealId}/links" },
-    { "method": "GET", "path": "/api/deals/{dealId}/memo" },
-    { "method": "GET", "path": "/api/deals/{dealId}/timeline" },
-    { "method": "GET", "path": "/api/deals/deleted" },
-    { "method": "GET", "path": "/api/me" },
-    { "method": "GET", "path": "/api/me/nominations" },
-    { "method": "GET", "path": "/api/mentions" },
-    { "method": "GET", "path": "/api/mentions/unread-count" },
-    { "method": "GET", "path": "/api/oauth/authorize" },
-    { "method": "GET", "path": "/api/partner/approvals" },
-    { "method": "GET", "path": "/api/skill-corrections" },
-    { "method": "GET", "path": "/api/users" },
-    { "method": "GET", "path": "/api/wiki/{slug}" },
-    { "method": "GET", "path": "/api/wiki/search" },
-    { "method": "PATCH", "path": "/api/deals/{dealId}/blocks/{blockId}" },
-    { "method": "PATCH", "path": "/api/deals/{dealId}/documents/{slug}" },
-    { "method": "PATCH", "path": "/api/deals/{dealId}/facts/{factId}" },
-    { "method": "POST", "path": "/api/agent/client-events" },
-    { "method": "POST", "path": "/api/agent/eval-feedback" },
-    { "method": "POST", "path": "/api/deals/{dealId}/agent-runs/{runId}/revert" },
-    { "method": "POST", "path": "/api/deals/{dealId}/blocks/{blockId}/history" },
-    { "method": "POST", "path": "/api/deals/{dealId}/blocks/{blockId}/restore" },
-    { "method": "POST", "path": "/api/deals/{dealId}/collaborators" },
-    { "method": "POST", "path": "/api/deals/{dealId}/collaborators/{userId}/restore" },
-    { "method": "POST", "path": "/api/deals/{dealId}/documents" },
-    { "method": "POST", "path": "/api/deals/{dealId}/documents/{slug}/html/restore/{version}" },
-    { "method": "POST", "path": "/api/deals/{dealId}/enrich" },
-    { "method": "POST", "path": "/api/deals/{dealId}/facts" },
-    { "method": "POST", "path": "/api/deals/{dealId}/links" },
-    { "method": "POST", "path": "/api/deals/{dealId}/links/{linkId}/restore" },
-    { "method": "POST", "path": "/api/deals/{dealId}/memo" },
-    { "method": "POST", "path": "/api/deals/{dealId}/posts" },
-    { "method": "POST", "path": "/api/deals/{dealId}/propose-owner" },
-    { "method": "POST", "path": "/api/deals/{dealId}/refresh-brief" },
-    { "method": "POST", "path": "/api/deals/{dealId}/refresh-persona" },
-    { "method": "POST", "path": "/api/deals/{dealId}/restore" },
-    { "method": "POST", "path": "/api/deals/{dealId}/threads" },
-    { "method": "POST", "path": "/api/deals/{dealId}/threads/{threadId}" },
-    { "method": "POST", "path": "/api/deals/create" },
-    { "method": "POST", "path": "/api/deals/update" },
-    { "method": "POST", "path": "/api/external/chat" },
-    { "method": "POST", "path": "/api/external/start-session" },
-    { "method": "POST", "path": "/api/external/upload" },
-    { "method": "POST", "path": "/api/mentions/{id}/resolve" },
-    { "method": "POST", "path": "/api/nominations/{approvalId}" },
-    { "method": "POST", "path": "/api/oauth/revoke" },
-    { "method": "POST", "path": "/api/oauth/token" },
-    { "method": "POST", "path": "/api/partner/approvals" },
-    { "method": "POST", "path": "/api/skill-corrections" },
-    { "method": "POST", "path": "/api/wiki/{slug}/restore" },
-    { "method": "POST", "path": "/api/wiki/save" },
-    { "method": "PUT", "path": "/api/deals/{dealId}/blocks" },
-    { "method": "PUT", "path": "/api/deals/{dealId}/documents/{slug}/html" },
-    { "method": "PUT", "path": "/api/deals/{dealId}/founders" },
-    { "method": "PUT", "path": "/api/deals/{dealId}/memo" }
+    {
+      "method": "GET",
+      "path": "/api/admin/agent-events"
+    },
+    {
+      "method": "GET",
+      "path": "/api/admin/auth-events"
+    },
+    {
+      "method": "GET",
+      "path": "/api/admin/deal-events"
+    },
+    {
+      "method": "GET",
+      "path": "/api/agent/activity"
+    },
+    {
+      "method": "GET",
+      "path": "/api/agent/briefing"
+    },
+    {
+      "method": "POST",
+      "path": "/api/agent/client-events"
+    },
+    {
+      "method": "GET",
+      "path": "/api/agent/explain"
+    },
+    {
+      "method": "GET",
+      "path": "/api/agent/manifest"
+    },
+    {
+      "method": "GET",
+      "path": "/api/agent/preferences"
+    },
+    {
+      "method": "POST",
+      "path": "/api/agent/preferences"
+    },
+    {
+      "method": "PATCH",
+      "path": "/api/agent/preferences/{id}"
+    },
+    {
+      "method": "GET",
+      "path": "/api/agent/skills"
+    },
+    {
+      "method": "GET",
+      "path": "/api/agent/skills/{slug}"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/create"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/deleted"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/update"
+    },
+    {
+      "method": "DELETE",
+      "path": "/api/deals/{dealId}"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/agent-runs/{runId}/revert"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/blocks"
+    },
+    {
+      "method": "PUT",
+      "path": "/api/deals/{dealId}/blocks"
+    },
+    {
+      "method": "DELETE",
+      "path": "/api/deals/{dealId}/blocks/{blockId}"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/blocks/{blockId}"
+    },
+    {
+      "method": "PATCH",
+      "path": "/api/deals/{dealId}/blocks/{blockId}"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/blocks/{blockId}/history"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/blocks/{blockId}/history"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/blocks/{blockId}/restore"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/collaborators"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/collaborators"
+    },
+    {
+      "method": "DELETE",
+      "path": "/api/deals/{dealId}/collaborators/{userId}"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/collaborators/{userId}/restore"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/command-center"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/documents"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/documents"
+    },
+    {
+      "method": "DELETE",
+      "path": "/api/deals/{dealId}/documents/{slug}"
+    },
+    {
+      "method": "PATCH",
+      "path": "/api/deals/{dealId}/documents/{slug}"
+    },
+    {
+      "method": "DELETE",
+      "path": "/api/deals/{dealId}/documents/{slug}/html"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/documents/{slug}/html"
+    },
+    {
+      "method": "PUT",
+      "path": "/api/deals/{dealId}/documents/{slug}/html"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/documents/{slug}/html/history"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/documents/{slug}/html/restore/{version}"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/enrich"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/facts"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/facts"
+    },
+    {
+      "method": "PATCH",
+      "path": "/api/deals/{dealId}/facts/{factId}"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/feed"
+    },
+    {
+      "method": "PUT",
+      "path": "/api/deals/{dealId}/founders"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/ingest"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/links"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/links"
+    },
+    {
+      "method": "DELETE",
+      "path": "/api/deals/{dealId}/links/{linkId}"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/links/{linkId}/restore"
+    },
+    {
+      "method": "DELETE",
+      "path": "/api/deals/{dealId}/memo"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/memo"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/memo"
+    },
+    {
+      "method": "PUT",
+      "path": "/api/deals/{dealId}/memo"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/posts"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/propose-owner"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/refresh-brief"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/restore"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/threads"
+    },
+    {
+      "method": "POST",
+      "path": "/api/deals/{dealId}/threads/{threadId}"
+    },
+    {
+      "method": "GET",
+      "path": "/api/deals/{dealId}/timeline"
+    },
+    {
+      "method": "POST",
+      "path": "/api/external/chat"
+    },
+    {
+      "method": "POST",
+      "path": "/api/external/start-session"
+    },
+    {
+      "method": "POST",
+      "path": "/api/external/upload"
+    },
+    {
+      "method": "GET",
+      "path": "/api/me"
+    },
+    {
+      "method": "GET",
+      "path": "/api/me/nominations"
+    },
+    {
+      "method": "GET",
+      "path": "/api/mentions"
+    },
+    {
+      "method": "GET",
+      "path": "/api/mentions/unread-count"
+    },
+    {
+      "method": "POST",
+      "path": "/api/mentions/{id}/resolve"
+    },
+    {
+      "method": "POST",
+      "path": "/api/nominations/{approvalId}"
+    },
+    {
+      "method": "GET",
+      "path": "/api/oauth/authorize"
+    },
+    {
+      "method": "POST",
+      "path": "/api/oauth/revoke"
+    },
+    {
+      "method": "POST",
+      "path": "/api/oauth/token"
+    },
+    {
+      "method": "GET",
+      "path": "/api/partner/approvals"
+    },
+    {
+      "method": "POST",
+      "path": "/api/partner/approvals"
+    },
+    {
+      "method": "GET",
+      "path": "/api/users"
+    },
+    {
+      "method": "POST",
+      "path": "/api/wiki/save"
+    },
+    {
+      "method": "GET",
+      "path": "/api/wiki/search"
+    },
+    {
+      "method": "DELETE",
+      "path": "/api/wiki/{slug}"
+    },
+    {
+      "method": "GET",
+      "path": "/api/wiki/{slug}"
+    },
+    {
+      "method": "POST",
+      "path": "/api/wiki/{slug}/restore"
+    }
   ]
 }

package/lib/build-manifest.json

@@ -1,15 +1,15 @@
 {
   "format": "llama.cli-build.v1",
   "packageName": "@llamaventures/cli",
-  "packageVersion": "1.19.0",
-  "sourceSha": "5f615ca16d607fc0da09887952afdf42301a43f8",
+  "packageVersion": "1.20.0",
+  "sourceSha": "c9708c7ae6881e9e4a82972a521e748932a380ce",
   "sourceKind": "github",
   "sourceDirty": false,
   "coreApiContract": {
     "format": "llama.core-api-contract.v1",
     "name": "llama-core-api",
-    "apiVersion": "1.0.1",
+    "apiVersion": "3.1.0",
     "openapiVersion": "3.0.3",
-    "sha256": "95ce3639aeee15b0fed09830116838f2a11fd2e40e4f35bf80d785664ecf8d96"
+    "sha256": "51b134af7a63534406b3a216aeab190fd595f5270b2a10263730662f1c2f771a"
   }
 }

package/lib/client.mjs

@@ -198,7 +198,6 @@ function rememberAgentEvent(event) {
     ...readAgentSession(),
     sessionId: event.sessionId || currentAgentSessionId(),
     lastEventId: event.eventId,
-    lastCandidateId: event.candidateId ?? null,
     lastCommand: event.command ?? null,
     lastQuery: event.query ?? null,
     lastSurface: event.surface ?? null,
@@ -293,6 +292,7 @@ function inferCommand(method, endpoint) {
   if (pathname === "/api/deals") return verb === "GET" ? "deal.search" : "deal.write";
   if (pathname === "/api/deals/create") return "deal.create";
   if (pathname === "/api/deals/update") return "deal.update";
+  if (/^\/api\/deals\/[^/]+\/ingest$/.test(pathname)) return "deal.ingest";
   if (/^\/api\/deals\/[^/]+\/threads\/[^/]+$/.test(pathname)) return "deal.agent.run";
   if (/^\/api\/deals\/[^/]+\/threads$/.test(pathname)) return "deal.thread.create";
   if (/^\/api\/deals\/[^/]+\/facts/.test(pathname)) return verb === "GET" ? "deal.fact.list" : "deal.fact.write";

package/package.json

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