@llamaventures/cli 1.6.0 → 1.7.0

package/AGENT_BRIEFING.md

@@ -157,6 +157,9 @@ llama deal list [--owner ...] [--status ...]
 # Pipeline — write
 llama deal create "Company" --description "..."
 llama deal update <dealId> <field> <value>
+#   writable: status theirStage stage notes dealOwner source description website
+#             location founders proposedAmount roundSize valuation sector subsector
+#             foundedYear leadInvestor investors   (each write logs a deal_events row)
 
 # Brief blocks
 llama brief blocks <dealId>
@@ -205,6 +208,9 @@ llama wiki save <slug> --title "..." --file path.html --sources "..." [--content
 #   --content-type html (or markdown) overrides the inference.
 #   Refuses to switch content_type on an existing slug; delete + re-create
 #   if you really mean to change format.
+# Delete / restore (soft, reversible — CONSTITUTION §8):
+llama wiki delete  <slug> [--lang en|zh]
+llama wiki restore <slug> [--lang en|zh]
 
 # Timeline + posts
 llama timeline <dealId>
@@ -231,7 +237,7 @@ Tools available:
 - `auth_status` — verify creds + identity (call first if anything 401s)
 - `deal_search` / `deal_show` / `deal_create` / `deal_update`
 - `brief_blocks` / `brief_add_text` / `brief_add_link` / `brief_add_callout`
-- `wiki_search` / `wiki_save` (accepts `content_type: 'markdown' | 'html'` — HTML entries render as full-viewport sandboxed iframe at `/wiki/<slug>`)
+- `wiki_search` / `wiki_save` (accepts `content_type: 'markdown' | 'html'` — HTML entries render as full-viewport sandboxed iframe at `/wiki/<slug>`) / `wiki_delete` / `wiki_restore` (soft-delete, reversible)
 - `timeline` / `post`
 - `mentions_list`
 - `pitch_start` / `pitch_send_message` / `pitch_upload_file` / `pitch_status` / `pitch_finalize` — public intake (no Llama token needed; for founders / EAs / external agents)
@@ -241,6 +247,7 @@ You can also fetch this exact briefing as an MCP prompt named `agent_briefing`.
 ## Boundaries (what NOT to do)
 
 - **Don't impersonate a human's opinion.** Tag AI-generated content as `[AI · …]`.
+- **Don't vouch for facts you haven't checked.** When you `add fact`, pass `--attested` only if you actually verified the claim against its source. Without it the fact is stored as *unverified* — that's the honest default, not a failure. You cannot mark a fact as human-confirmed; only a person can raise it there.
 - **Don't use absolute language** ("only", "all", "best", "no one", "极") unless verifiable.
 - **Don't bypass `llama` CLI / MCP for pipeline writes.** CSRF defence, rate limits, audit logs all flow through it.
 - **Don't write to retired surfaces.** Google Sheet is read-only archive. Legacy `~/.llama-command/config.json` auto-migrates.

package/README.md

@@ -209,7 +209,14 @@ llama post     <dealId> "message body" [--link url]
 
 # Wiki
 llama wiki search "<query>"
-llama wiki save <slug> --title "..." --content "..."
+llama wiki read   <slug> [--lang en|zh]
+# Markdown entry:
+llama wiki save <slug> --title "..." --content "..." --sources "url1;url2"
+# HTML entry — standalone page at /wiki/<slug> (full-viewport sandboxed iframe):
+llama wiki save <slug> --title "..." --file page.html --sources "..." [--content-type html]
+# Delete / restore (soft, reversible):
+llama wiki delete  <slug> [--lang en|zh]
+llama wiki restore <slug> [--lang en|zh]
 
 # Mentions inbox
 llama mentions
@@ -255,6 +262,7 @@ brief_add_link         brief_add_callout
 timeline               post
 
 wiki_search            wiki_save
+wiki_delete            wiki_restore
 
 mentions_list
 

package/bin/llama-mcp.mjs

@@ -197,7 +197,8 @@ server.registerTool(
     description:
       "Update a single whitelisted field on a deal. Writable fields: status, theirStage, " +
       "notes, stage, dealOwner, source, description, website, location, founders, " +
-      "proposedAmount, roundSize, valuation. Logs a field_change event in deal_events.",
+      "proposedAmount, roundSize, valuation, sector, subsector, foundedYear, leadInvestor, " +
+      "investors. Logs a field_change event in deal_events.",
     inputSchema: {
       dealId: z.string(),
       field: z.string().describe("camelCase field name (see description for whitelist)"),
@@ -208,6 +209,82 @@ server.registerTool(
     callApi("POST", "/api/deals/update", { dealId, field, value })
 );
 
+// ============================================================
+// Deal facts (research substrate + trust ladder)
+// ============================================================
+
+server.registerTool(
+  "deal_fact_list",
+  {
+    description:
+      "List a deal's recorded facts (the research substrate). Each fact carries a " +
+      "category, a claim, a source, a confidence, and a trust rung (unverified → " +
+      "agent-verified → human-vouched → endorsed) plus who/what recorded it.",
+    inputSchema: {
+      dealId: z.string(),
+    },
+  },
+  async ({ dealId }) =>
+    callApi("GET", `/api/deals/${encodeURIComponent(dealId)}/facts`)
+);
+
+server.registerTool(
+  "deal_fact_add",
+  {
+    description:
+      "Record a factual claim about a deal. RESPONSIBILITY: set `attested` honestly — " +
+      "true ONLY if you actually verified the claim against its cited source (the fact " +
+      "is then stored at trust level 'agent-verified'); false/omitted if you are relaying " +
+      "something unconfirmed (stored 'unverified', which is the honest default). You CANNOT " +
+      "mark a fact as human-confirmed — only a person can raise it to 'human-vouched'. " +
+      "`confidence` is how certain the claim is; `attested` is whether YOU take responsibility " +
+      "for having checked it. category ∈ founders | financials | product | market | team | " +
+      "company_basics | risk | fundraise | milestone | meta.",
+    inputSchema: {
+      dealId: z.string(),
+      category: z.string(),
+      claim: z.string(),
+      source: z.string().optional().describe("where you found this (URL, 'deck p3', 'LinkedIn')"),
+      confidence: z.enum(["high", "medium", "low"]).optional(),
+      attested: z
+        .boolean()
+        .optional()
+        .describe("true → stored 'agent-verified'; false/omitted → 'unverified'. Answer honestly."),
+    },
+  },
+  async ({ dealId, category, claim, source, confidence, attested }) =>
+    callApi("POST", `/api/deals/${encodeURIComponent(dealId)}/facts`, {
+      category,
+      claim,
+      source: source ?? "",
+      confidence: confidence ?? "medium",
+      attested: attested === true,
+    })
+);
+
+server.registerTool(
+  "deal_fact_verify",
+  {
+    description:
+      "Verify a recorded fact. status='confirmed' vouches for it (raises to 'human-vouched'); " +
+      "status='disputed' marks it contradicted. Trust-ladder guardrails apply server-side " +
+      "(external-org callers are capped at 'unverified'; only Partners reach 'endorsed'). " +
+      "Optionally pass correctedValue when disputing.",
+    inputSchema: {
+      dealId: z.string(),
+      factId: z.union([z.string(), z.number()]),
+      status: z.enum(["confirmed", "disputed"]),
+      correctedValue: z.string().optional(),
+    },
+  },
+  async ({ dealId, factId, status, correctedValue }) =>
+    callApi(
+      "PATCH",
+      `/api/deals/${encodeURIComponent(dealId)}/facts/${encodeURIComponent(String(factId))}`,
+      { status, ...(correctedValue !== undefined ? { correctedValue } : {}) }
+    )
+);
+
 // ============================================================
 // Brief blocks
 // ============================================================
@@ -272,6 +349,108 @@ server.registerTool(
     addBriefBlock(dealId, { type: "callout", tone, heading: heading ?? "", body })
 );
 
+server.registerTool(
+  "brief_edit",
+  {
+    description:
+      "Edit an existing brief block in place. Pass only the fields you want to change " +
+      "(heading/body/url/label/description/tone). Meta toggles: locked (protect from bulk " +
+      "overwrite), hidden (fold), sourceSection (route watcher writes). Snapshots the prior " +
+      "version to history (reversible via brief_restore_version).",
+    inputSchema: {
+      dealId: z.string(),
+      blockId: z.string(),
+      heading: z.string().optional(),
+      body: z.string().optional(),
+      url: z.string().optional(),
+      label: z.string().optional(),
+      description: z.string().optional(),
+      tone: z.string().optional(),
+      locked: z.boolean().optional(),
+      hidden: z.boolean().optional(),
+      sourceSection: z.string().optional(),
+    },
+  },
+  async ({ dealId, blockId, heading, body, url, label, description, tone, locked, hidden, sourceSection }) => {
+    const patch = {};
+    for (const [k, v] of Object.entries({ heading, body, url, label, description, tone })) {
+      if (v !== undefined) patch[k] = v;
+    }
+    const meta = {};
+    if (locked !== undefined) meta.locked = locked;
+    if (hidden !== undefined) meta.hidden = hidden;
+    if (sourceSection !== undefined) meta.sourceSection = sourceSection;
+    if (Object.keys(meta).length > 0) patch.meta = meta;
+    return callApi(
+      "PATCH",
+      `/api/deals/${encodeURIComponent(dealId)}/blocks/${encodeURIComponent(blockId)}`,
+      patch
+    );
+  }
+);
+
+server.registerTool(
+  "brief_delete",
+  {
+    description:
+      "Soft-delete a brief block (reversible via brief_restore). Locked blocks are refused.",
+    inputSchema: { dealId: z.string(), blockId: z.string() },
+  },
+  async ({ dealId, blockId }) =>
+    callApi("DELETE", `/api/deals/${encodeURIComponent(dealId)}/blocks/${encodeURIComponent(blockId)}`)
+);
+
+server.registerTool(
+  "brief_restore",
+  {
+    description: "Restore a soft-deleted brief block.",
+    inputSchema: { dealId: z.string(), blockId: z.string() },
+  },
+  async ({ dealId, blockId }) =>
+    callApi("POST", `/api/deals/${encodeURIComponent(dealId)}/blocks/${encodeURIComponent(blockId)}/restore`)
+);
+
+server.registerTool(
+  "brief_history",
+  {
+    description:
+      "List the content-version history of a brief block (every overwrite is snapshotted). " +
+      "Use the returned history id with brief_restore_version.",
+    inputSchema: {
+      dealId: z.string(),
+      blockId: z.string(),
+      limit: z.number().optional(),
+    },
+  },
+  async ({ dealId, blockId, limit }) => {
+    const qs = limit ? `?limit=${encodeURIComponent(String(limit))}` : "";
+    return callApi(
+      "GET",
+      `/api/deals/${encodeURIComponent(dealId)}/blocks/${encodeURIComponent(blockId)}/history${qs}`
+    );
+  }
+);
+
+server.registerTool(
+  "brief_restore_version",
+  {
+    description:
+      "Restore a brief block to a specific historical version (find historyId via brief_history). " +
+      "Itself reversible — the outgoing version is snapshotted before replacement.",
+    inputSchema: {
+      dealId: z.string(),
+      blockId: z.string(),
+      historyId: z.number(),
+    },
+  },
+  async ({ dealId, blockId, historyId }) =>
+    callApi(
+      "POST",
+      `/api/deals/${encodeURIComponent(dealId)}/blocks/${encodeURIComponent(blockId)}/history`,
+      { history_id: historyId }
+    )
+);
+
 // ============================================================
 // Wiki (knowledge base)
 // ============================================================
@@ -380,6 +559,44 @@ server.registerTool(
     })
 );
 
+server.registerTool(
+  "wiki_delete",
+  {
+    description:
+      "Soft-delete a wiki page (reversible). The entry stops appearing in " +
+      "reads / search / backlinks; for HTML entries the standalone page + " +
+      "assets stop resolving too. Restore with wiki_restore. Use when the " +
+      "user asks to remove / delete / retire a wiki entry.",
+    inputSchema: {
+      slug: z.string().describe("kebab-case slug"),
+      lang: z.enum(["en", "zh"]).optional().describe("default: en"),
+    },
+  },
+  async ({ slug, lang }) =>
+    callApi(
+      "DELETE",
+      `/api/wiki/${encodeURIComponent(slug)}?lang=${lang === "zh" ? "zh" : "en"}`
+    )
+);
+
+server.registerTool(
+  "wiki_restore",
+  {
+    description:
+      "Restore a soft-deleted wiki page (undo wiki_delete). Brings back the " +
+      "entry + (for HTML entries) its standalone page and assets.",
+    inputSchema: {
+      slug: z.string().describe("kebab-case slug"),
+      lang: z.enum(["en", "zh"]).optional().describe("default: en"),
+    },
+  },
+  async ({ slug, lang }) =>
+    callApi(
+      "POST",
+      `/api/wiki/${encodeURIComponent(slug)}/restore?lang=${lang === "zh" ? "zh" : "en"}`
+    )
+);
+
 // ============================================================
 // Timeline + posts
 // ============================================================
@@ -444,6 +661,109 @@ server.registerTool(
   }
 );
 
+server.registerTool(
+  "mentions_resolve",
+  {
+    description: "Mark an @-mention as resolved (clears it from the recipient's open cues).",
+    inputSchema: { mentionId: z.union([z.string(), z.number()]) },
+  },
+  async ({ mentionId }) =>
+    callApi("POST", `/api/mentions/${encodeURIComponent(String(mentionId))}/resolve`)
+);
+
+// ============================================================
+// 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)
+// ============================================================
+
+server.registerTool(
+  "deal_refresh_brief",
+  {
+    description:
+      "Trigger a stale-section re-evaluation of a deal's brief. Pass force=true to bypass the " +
+      "debounce. Returns a runId (or null if debounced / deal inactive).",
+    inputSchema: {
+      dealId: z.string(),
+      force: z.boolean().optional(),
+    },
+  },
+  async ({ dealId, force }) =>
+    callApi(
+      "POST",
+      `/api/deals/${encodeURIComponent(dealId)}/refresh-brief${force ? "?force=1" : ""}`
+    )
+);
+
+server.registerTool(
+  "deal_refresh_persona",
+  {
+    description:
+      "Regenerate one persona's analysis section for a deal. persona ∈ gavin | kyle | jack | " +
+      "david | bryan | herman | hongjiang | liuyi | kevin. 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 })
+);
+
 // ============================================================
 // External pitch (founder intake) — no Llama Command token required
 // ============================================================

package/bin/llama.mjs

@@ -226,6 +226,13 @@ Deals:
   llama deal create "Company" --source <name> --description "..." --website https://...
   llama deal show <dealId>
   llama deal update <dealId> <field> <value>
+      Writable fields: status, theirStage, stage, notes, dealOwner, source,
+      description, website, location, founders, proposedAmount, roundSize,
+      valuation, sector, subsector, foundedYear, leadInvestor, investors.
+      e.g.  llama deal update <dealId> website https://acme.ai
+            llama deal update <dealId> sector "Developer Tools"
+            llama deal update <dealId> foundedYear 2024
+            llama deal update <dealId> leadInvestor "Acme Capital"
   llama deal search <query> [--founder name] [--owner <user-key>] [--status Diligence]
                             [--theirStage Raising] [--stage Seed]
                             [--limit 200] [--offset 0]
@@ -307,7 +314,7 @@ Deal soft-delete / restore / trash list:
 
 Deal facts (AI-extracted or human-asserted, with verification):
   llama deal fact list <dealId>                                # ⚠ session-only on server today
-  llama deal fact add <dealId> --category <cat> --claim "<text>" [--source <url>] [--confidence high|medium|low]
+  llama deal fact add <dealId> --category <cat> --claim "<text>" [--source <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):
@@ -343,6 +350,9 @@ Wiki:
       (.html / .htm extension auto-implies content_type=html)
   ➜ Use Wiki when the artifact is NOT tied to one specific deal — sector landscape, market map,
     thesis, framework, methodology. For deal-specific HTML use "llama html upload <dealId>" instead.
+  Delete / restore (soft — reversible):
+    llama wiki delete <slug> [--lang en|zh]
+    llama wiki restore <slug> [--lang en|zh]
 
 Memo (long-form HTML investment memo — Memo tab in the UI):
   llama memo show <dealId> [--out <path>] [--json]          # default: html → stdout (pipeable to file / browser)
@@ -1144,14 +1154,18 @@ https://command.llamaventures.vc/settings/tokens, run
       if (!flags.category || !flags.claim) {
         throw new Error(
           `Usage: llama deal fact add <dealId> --category <cat> --claim "<text>" ` +
-          `[--source <url>] [--confidence high|medium|low]`
+          `[--source <url>] [--confidence high|medium|low] [--attested]`
         );
       }
+      // --attested: the caller takes responsibility that this is accurate
+      // (verified against the source). With it, the fact is recorded as
+      // vouched; without it, it stays unverified. Declare honestly.
       print(await request("POST", `/api/deals/${encodeURIComponent(dealId)}/facts`, {
         category: String(flags.category),
         claim: String(flags.claim),
         source: flags.source ? String(flags.source) : "",
         confidence: flags.confidence ? String(flags.confidence) : "medium",
+        attested: flags.attested === true,
       }));
       return;
     }
@@ -1429,6 +1443,24 @@ Routing — is this the right command?
     return;
   }
 
+  // ----- Wiki: delete (soft) / restore -----
+  // Soft-delete (CONSTITUTION §8 reversible). For HTML entries the
+  // sentinel deal_browse_html body + assets are soft-deleted too;
+  // `llama wiki restore <slug>` brings it all back.
+  if (area === "wiki" && (action === "delete" || action === "restore")) {
+    const { flags, positional } = parseFlags(rest);
+    const slug = positional[0];
+    if (!slug) throw new Error(`Usage: llama wiki ${action} <slug> [--lang en|zh]`);
+    const lang = flags.lang === "zh" ? "zh" : "en";
+    const qs = `?lang=${lang}`;
+    if (action === "delete") {
+      print(await request("DELETE", `/api/wiki/${encodeURIComponent(slug)}${qs}`));
+    } else {
+      print(await request("POST", `/api/wiki/${encodeURIComponent(slug)}/restore${qs}`));
+    }
+    return;
+  }
+
   // ----- Brief blocks: list / add-* / edit / delete -----
   // The block-based deal brief stores an ordered array of typed blocks
   // (text / link / embed / callout) per deal. These commands wrap the
@@ -2139,8 +2171,8 @@ Routing — is this the right command?
       const { flags } = parseFlags(rest.slice(1), knownFlags);
 
       // --slug is the natural agent guess (DB column is `document_slug`).
-      // Accept it as an alias for --doc so the failure mode that bit
-      // Gavin (silent fall-through to 'main') can't happen again.
+      // Accept it as an alias for --doc so the earlier failure mode
+      // (silent fall-through to 'main') can't happen again.
       if (flags.slug && !flags.doc) {
         process.stderr.write("note: --slug accepted as alias for --doc.\n");
         flags.doc = flags.slug;

package/package.json

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