@llamaventures/cli 1.10.0 → 1.12.0

package/AGENT_BRIEFING.md

@@ -47,7 +47,8 @@ A teammate says "I just met them and heard…" or pastes a chunk of notes. Your
    - **Verifiable claims → facts.** `llama deal fact add <dealId> --category <cat> --claim "…" --source "<where it came from>"`. 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.
    - **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. **Confirm accuracy.** After filing, tell them in plain language what you recorded and where, and ask if it's right. Facts you add stay **unverified** until a human confirms them (then they rise to human-vouched) — the confirmation IS the trust step. Never silently mark something verified.
+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.
+   - **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`.
 

package/bin/llama-mcp.mjs

@@ -307,10 +307,16 @@ server.registerTool(
   "deal_feed",
   {
     description:
-      "The unified, time-sorted stream of everything a HUMAN has added to a deal — " +
+      "The unified, time-sorted stream of every contribution to a deal — " +
       "facts + notes/discussion + legacy posts, merged at query time, newest first. " +
-      "Excludes AI-generated content. Each item: kind (fact|note), ts, who, text, " +
-      "and for facts: source + trust rung + category.",
+      "Shows contributions from ANYONE — a teammate, their AI assistant, or an " +
+      "autonomous system agent; nothing is hidden. Each item carries `who` (the " +
+      "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 " +
+      "facts + discussion notes. Each item: kind (fact|note), ts, who, agent, " +
+      "origin, text, and for facts: source + trust rung + category.",
     inputSchema: {
       dealId: z.string(),
     },

package/bin/llama.mjs

@@ -225,7 +225,7 @@ Manually-set \`llc_\` tokens are used as a fallback.
 Deals:
   llama deal create "Company" --source <name> --description "..." --website https://...
   llama deal show <dealId>
-  llama deal feed <dealId>                                     # everything humans added (facts + notes), newest first
+  llama deal feed <dealId>                                     # every contribution (facts + notes), human-typed or assistant-drafted, newest first
   llama deal update <dealId> <field> <value>
       Writable fields: status, theirStage, stage, notes, dealOwner, source,
       description, website, location, founders, proposedAmount, roundSize,
@@ -375,6 +375,11 @@ Deal page HTML (hand-authored sandboxed pages on /deals/<id>/browse/<slug>):
     llama html docs create <dealId> <slug> [--title "..."]    # pre-create a slot
     llama html docs archive <dealId> <slug>                   # soft-archive (browse hides)
 
+  Link a card to a wiki article (one file, multiple entrances — the wiki
+  stays canonical, the deal card is a live, read-only pointer):
+    llama html link <dealId> --wiki <slug> [--lang en|zh] [--title "..."]
+    llama html unlink <dealId> <slug>                         # revert to a normal self-hosted doc
+
   Update an EXISTING artifact (slug must exist):
     llama html upload <dealId> --doc <slug> --file <path> [--assets DIR]
 
@@ -423,7 +428,7 @@ const HELP_ROOT = `Llama Command CLI — the \`llama\` command for the Llama Ven
 Common:
   llama deal search "<name>"        find a deal in the pipeline
   llama deal show <dealId>          full deal record
-  llama deal feed <dealId>          everything humans added, newest first
+  llama deal feed <dealId>          every contribution (facts + notes), newest first
   llama post <dealId> "..."         add a note to a deal
   llama agent-onboard               print the AI-agent workflow contract
 
@@ -2132,6 +2137,27 @@ Routing — is this the right command?
       return `/api/deals/${encodeURIComponent(dealId)}/documents/${encodeURIComponent(slug)}/html`;
     }
 
+    // Surface a clean `linked_wiki` field on linked docs so the listing
+    // reads as "this card points at wiki/<slug>" rather than exposing the
+    // raw source_wiki_* columns. Non-linked docs are returned unchanged.
+    function withLinkedWiki(data) {
+      if (!data || !Array.isArray(data.documents)) return data;
+      return {
+        ...data,
+        documents: data.documents.map((d) =>
+          d && d.source_wiki_slug
+            ? {
+                ...d,
+                linked_wiki: {
+                  slug: d.source_wiki_slug,
+                  lang: d.source_wiki_lang || "en",
+                },
+              }
+            : d,
+        ),
+      };
+    }
+
     // docs — list / create / archive documents on a deal.
     //
     // Forms:
@@ -2159,7 +2185,7 @@ Routing — is this the right command?
           "GET",
           `/api/deals/${encodeURIComponent(dealId)}/documents`,
         );
-        print(data);
+        print(withLinkedWiki(data));
         return;
       }
       if (docSub === "list") {
@@ -2171,7 +2197,7 @@ Routing — is this the right command?
           "GET",
           `/api/deals/${encodeURIComponent(dealId)}/documents`,
         );
-        print(data);
+        print(withLinkedWiki(data));
         return;
       }
       if (docSub === "create") {
@@ -2210,6 +2236,82 @@ Routing — is this the right command?
       );
     }
 
+    // link — turn a deal doc card into a live, read-only pointer to a wiki
+    // HTML article. "One file, multiple entrances": the wiki stays the
+    // canonical home, the card just renders the wiki's HTML. Edits go to
+    // the wiki source; uploads to a linked slug are refused server-side.
+    //
+    //   llama html link <dealId> --wiki <slug> [--lang en|zh] [--title "..."]
+    //
+    // Default deal-side slug = the wiki slug. Default title = the wiki
+    // article's title (fetched from `llama wiki read`).
+    if (sub === "link") {
+      const dealId = rest[0];
+      const { flags } = parseFlags(rest.slice(1), ["wiki", "lang", "title", "slug"]);
+      const wikiSlug =
+        typeof flags.wiki === "string" && flags.wiki.trim()
+          ? flags.wiki.trim()
+          : null;
+      if (!dealId || !wikiSlug) {
+        throw new Error(
+          "Usage: llama html link <dealId> --wiki <slug> [--lang en|zh] [--title \"...\"]",
+        );
+      }
+      const lang = flags.lang === "zh" ? "zh" : "en";
+      // Deal-side slug defaults to the wiki slug; --slug overrides.
+      const dealSlug =
+        typeof flags.slug === "string" && flags.slug.trim()
+          ? flags.slug.trim()
+          : wikiSlug;
+      // Title defaults to the wiki article's title.
+      let title =
+        typeof flags.title === "string" && flags.title.trim()
+          ? flags.title.trim()
+          : null;
+      if (!title) {
+        try {
+          const article = await request(
+            "GET",
+            `/api/wiki/${encodeURIComponent(wikiSlug)}?lang=${lang}`,
+          );
+          title = article?.frontmatter?.title || wikiSlug;
+        } catch {
+          // Fall back to the slug as the title; the server still validates
+          // that the wiki article exists + is HTML on the POST below.
+          title = wikiSlug;
+        }
+      }
+      const data = await request(
+        "POST",
+        `/api/deals/${encodeURIComponent(dealId)}/documents`,
+        {
+          slug: dealSlug,
+          title,
+          source_wiki_slug: wikiSlug,
+          source_wiki_lang: lang,
+        },
+      );
+      print(data);
+      return;
+    }
+
+    // unlink — revert a linked card back to a normal self-hosted doc.
+    //   llama html unlink <dealId> <slug>
+    if (sub === "unlink") {
+      const dealId = rest[0];
+      const slug = rest[1];
+      if (!dealId || !slug) {
+        throw new Error("Usage: llama html unlink <dealId> <slug>");
+      }
+      const data = await request(
+        "PATCH",
+        `/api/deals/${encodeURIComponent(dealId)}/documents/${encodeURIComponent(slug)}`,
+        { source_wiki_slug: null },
+      );
+      print(data);
+      return;
+    }
+
     // show — fetch the current HTML. Default: print to stdout (pipeable).
     if (sub === "show") {
       const dealId = rest[0];
@@ -2648,7 +2750,7 @@ Routing — is this the right command?
     }
 
     throw new Error(
-      `Unknown html subcommand "${sub || ""}". Use: docs / show / upload / versions / restore / reset.`,
+      `Unknown html subcommand "${sub || ""}". Use: docs / link / unlink / show / upload / versions / restore / reset.`,
     );
   }
 

package/package.json

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