@llamaventures/cli 1.11.0 → 1.13.0

package/bin/llama.mjs

@@ -228,12 +228,18 @@ Deals:
   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,
-      valuation, sector, subsector, foundedYear, leadInvestor, investors.
+      description, website, location, founders, founderInfo, proposedAmount,
+      roundSize, valuation, deckLink, folderUrl, sector, subsector,
+      foundedYear, leadInvestor, investors, agentActive.
       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 extra set <dealId> <key> <value>        # system-admin only
+      Patch one top-level key in deals.extra JSONB. Value is parsed as
+      JSON when possible ('{"a":1}', 'true', '3'), else stored as a
+      string. Audited to deal_events as field_change "extra.<key>".
+  llama deal extra unset <dealId> <key>              # delete the key (admin)
   llama deal search <query> [--founder name] [--owner <user-key>] [--status Diligence]
                             [--theirStage Raising] [--stage Seed]
                             [--limit 200] [--offset 0]
@@ -375,6 +381,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]
 
@@ -1095,6 +1106,39 @@ https://command.llamaventures.vc/settings/tokens, run
     return;
   }
 
+  // ----- deals.extra JSONB patches (system-admin only, server-gated) -----
+  // Same endpoint as `deal update`, but `extraKey` instead of `field`.
+  // Server patches one top-level key via jsonb_set and audits the change
+  // to deal_events as field_change with field "extra.<key>". value=null
+  // deletes the key.
+  if (area === "deal" && action === "extra") {
+    const sub = rest[0];
+    const dealId = rest[1];
+    const key = rest[2];
+    if (sub === "set") {
+      const raw = rest.slice(3).join(" ");
+      if (!dealId || !key || !raw) {
+        throw new Error(
+          "Usage: llama deal extra set <dealId> <key> <value>  (value parsed as JSON when possible, else stored as string)"
+        );
+      }
+      let value;
+      try {
+        value = JSON.parse(raw);
+      } catch {
+        value = raw;
+      }
+      print(await request("POST", "/api/deals/update", { dealId, extraKey: key, value }));
+      return;
+    }
+    if (sub === "unset") {
+      if (!dealId || !key) throw new Error("Usage: llama deal extra unset <dealId> <key>");
+      print(await request("POST", "/api/deals/update", { dealId, extraKey: key, value: null }));
+      return;
+    }
+    throw new Error("Usage: llama deal extra set|unset <dealId> <key> [value]");
+  }
+
   if (area === "deal" && action === "search") {
     const { flags, positional } = parseFlags(rest);
     const q = positional.join(" ").trim();
@@ -2132,6 +2176,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 +2224,7 @@ Routing — is this the right command?
           "GET",
           `/api/deals/${encodeURIComponent(dealId)}/documents`,
         );
-        print(data);
+        print(withLinkedWiki(data));
         return;
       }
       if (docSub === "list") {
@@ -2171,7 +2236,7 @@ Routing — is this the right command?
           "GET",
           `/api/deals/${encodeURIComponent(dealId)}/documents`,
         );
-        print(data);
+        print(withLinkedWiki(data));
         return;
       }
       if (docSub === "create") {
@@ -2210,6 +2275,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 +2789,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.11.0",
+  "version": "1.13.0",
   "description": "CLI + MCP server for the Llama Ventures investment workbench (command.llamaventures.vc).",
   "type": "module",
   "bin": {