@wrangled/cli 0.3.22 → 0.3.23

package/dist/guide.js

@@ -35,9 +35,10 @@ To read the whole library with your own tools, such as "every email we have" or
 
 ## Know-how library: Creative Cartel
 
-For what has worked for others, such as "how do members test new hooks" or "what do people say about advertorials", search the know-how library: \`${cli} knowledge search "<question>"\`. Today it holds Creative Cartel's library (\`creative-cartel\`) and the team's own Exodus copy and ad frameworks (\`exodus\`), both copied into this server every Monday afternoon. It works only when the key has library access (\`${cli} whoami\` says); without it the answer is \`knowledge_not_allowed\`. It finds snippets by their words and by their meaning, and returns them short, never whole documents: each at most 280 characters, with its title, link, kind, caveat, evidence and the day its library was copied in. Evidence \`reported member statement\` is a member's claim, not a checked result; weigh it that way and say so when you use it. Evidence \`team method\` is the team's own framework: reason with it, never paste it into client work. The library writes no answer for you: read the snippets and decide. Use your own words: saving text that repeats 12 words in a row from anything in the library is refused with \`copies_library_text\`.
+For what has worked for others, such as "how do members test new hooks" or "what do people say about advertorials", search the know-how library: \`${cli} knowledge search "<question>"\`. Today it holds Creative Cartel's library (\`creative-cartel\`) the team's own Exodus copy and ad frameworks (\`exodus\`), and Meta's advertising standards (\`meta-policy\`), all copied into this server every Monday afternoon. It works only when the key has library access (\`${cli} whoami\` says); without it the answer is \`knowledge_not_allowed\`. It finds snippets by their words and by their meaning, and returns them short, never whole documents: each at most 280 characters, with its title, link, kind, caveat, evidence and the day its library was copied in. Evidence \`reported member statement\` is a member's claim, not a checked result; weigh it that way and say so when you use it. Evidence \`team method\` is the team's own framework: reason with it, never paste it into client work. The library writes no answer for you: read the snippets and decide. Use your own words: saving text that repeats 12 words in a row from anything in the library is refused with \`copies_library_text\`.
 
 - The question is 1 to 4000 characters. \`--limit\` is 1 to 12 (default 5). \`--kind\` (message, transcript, document, note) keeps one kind of source. \`--library <slug>\` keeps one library.
+- \`--library meta-policy\` searches Meta's own advertising standards, copied from Meta's site every Monday. Before you write or judge an ad, check its claims there, such as income, health or before-and-after claims: \`${cli} knowledge search --library meta-policy "income claims"\`. Its evidence is \`meta_published_policy\`, Meta's published rule; Meta's reviewers still decide each ad.
 - \`knowledge_not_synced\` means the library has not been copied into this server yet, so nothing was searched; the weekly sync fills it.
 
 ## Query workflow: schema first
@@ -190,7 +191,7 @@ Tag ads, emails, texts and pages only with the words \`${cli} grammar\` lists (\
 
 ## What customers keep saying
 
-Every hour an AI reads the workspace's new Facebook and Instagram comments, Google reviews and Reddit posts and comments, pulls out openers (lines that would open an ad), objections (why people hesitate) and phrases (customers' own words for their problem or result), and groups the ones that say the same thing. Names, emails, phone numbers and handles are taken out first. \`${cli} voice\` lists the groups, most common first (\`--kind opener|objection|phrase\`, \`--limit <n>\` up to 200, \`--json\`), each with how many rows said it, their likes, and up to 3 real quotes. In \`--json\`, each quote's \`{kind, ref, quote}\` goes straight into a creative's \`researchSources\`, and a group itself can be cited as its \`ref\`, \`voice_clusters:<id>\`. The same rows are in the \`voice_clusters\` and \`voice_insights\` tables.
+Every hour an AI reads what is new in the workspace's Facebook and Instagram comments, Google reviews, Reddit posts and comments, recorded calls and meetings (Fathom, Zoom, CallRail) and chats (GoHighLevel texts and chat, Closebot), pulls out openers (lines that would open an ad), objections (why people hesitate), pains (problems they live with), desires (results they want) and phrases (exact wording worth copying into an ad), and groups the ones that say the same thing. From calls and chats only the customer's words count, and names, emails, phone numbers and handles are taken out first. \`${cli} voice\` lists the groups, most common first (\`--kind opener|objection|pain|desire|phrase\`, \`--limit <n>\` up to 200, \`--json\`), each with how many sources said it (a conversation counts once), their likes, and up to 3 real quotes. \`${cli} voice --since <YYYY-MM-DD> --sort useful\` lists single lines said since that day instead, the most usable in an ad first: specific, first-person, recent and often said; \`--json\` adds each line's link. In \`--json\`, each quote's \`kind\` (a line's \`source\`) and \`ref\` go straight into a creative's \`researchSources\`, and a group itself can be cited as its \`ref\`, \`voice_clusters:<id>\`. The same rows are in the \`voice_clusters\` and \`voice_insights\` tables.
 
 ## The weekly story
 

package/dist/main.js

@@ -15,6 +15,7 @@ import { SKILL_NAME_PATTERN } from "./skill-zip.js";
 import { installSkillFolder, operatorConnection, packSkill, parseSkillRef, readSkillFolder, unpackSkill, } from "./skills.js";
 const DEFAULT_WAIT_SECONDS = 300;
 const SERVER_WAIT_CAP = 50;
+const VOICE_USAGE = "voice [--kind opener|objection|pain|desire|phrase] [--since <YYYY-MM-DD>] [--sort common|useful] [--limit <n>] [--json]";
 const commands = {
     login: {
         usage: `login   (paste the key when asked, pipe it on stdin, or set ${envPrefix}_API_KEY)`,
@@ -1125,21 +1126,30 @@ const commands = {
         },
     },
     voice: {
-        usage: "voice [--kind opener|objection|phrase] [--limit <n>] [--json]   what customers keep saying, most common first",
+        usage: `${VOICE_USAGE}   what customers keep saying, most common first, or with --sort useful the most usable single lines`,
         async run(args, options) {
             if (args.length > 0)
-                throw new CliError("Usage: voice [--kind opener|objection|phrase] [--limit <n>] [--json]", exitCodes.usage);
+                throw new CliError(`Usage: ${VOICE_USAGE}`, exitCodes.usage);
             const query = new URLSearchParams();
             if (options.kind)
                 query.set("kind", options.kind);
+            if (options.since)
+                query.set("since", options.since);
+            if (options.sort)
+                query.set("sort", options.sort);
             if (options.limit)
                 query.set("limit", options.limit);
-            const { clusters } = await api(await resolveConnection(options.apiUrl), `${VOICE_PATH}${query.size ? `?${query}` : ""}`);
+            const read = await api(await resolveConnection(options.apiUrl), `${VOICE_PATH}${query.size ? `?${query}` : ""}`);
             if (options.format === "json")
-                return printJson({ clusters });
-            if (clusters.length === 0)
+                return printJson(read);
+            if ("lines" in read) {
+                if (read.lines.length === 0)
+                    return console.log("Nothing said in that time yet.");
+                return console.log(renderTable(VOICE_LINE_COLUMNS, read.lines.map(voiceLineRow)));
+            }
+            if (read.clusters.length === 0)
                 return console.log("Nothing grouped yet.");
-            console.log(renderTable(VOICE_COLUMNS, clusters.map(voiceRow)));
+            console.log(renderTable(VOICE_COLUMNS, read.clusters.map(voiceRow)));
         },
     },
     "ads tags": {
@@ -1798,6 +1808,7 @@ const VOICE_SUGGESTIONS_PATH = "/api/v1/voice-lists/suggestions";
 const FACT_COLUMNS = ["id", "kind", "subject", "key", "status", "summary"];
 const VOICE_PATH = "/api/v1/voice";
 const VOICE_COLUMNS = ["ref", "kind", "said by", "likes", "label", "top quote"];
+const VOICE_LINE_COLUMNS = ["date", "kind", "source", "quote", "ref"];
 function knowledgeBlock(r, i) {
     const lines = [`${i + 1}. ${r.title}`, `   ${r.kind}, ${r.evidence.replaceAll("_", " ")} (${r.source}${r.syncedAt ? `, copied in ${r.syncedAt.slice(0, 10)}` : ""})`];
     if (r.url)
@@ -1818,6 +1829,9 @@ function contentTagRow(t) {
 function voiceRow(c) {
     return { ref: c.ref, kind: c.kind, "said by": c.supportCount, likes: c.likeSum, label: excerpt(c.label, 60), "top quote": c.evidence[0] ? excerpt(c.evidence[0].quote, 60) : null };
 }
+function voiceLineRow(l) {
+    return { date: l.date.slice(0, 10), kind: l.kind, source: l.source, quote: excerpt(l.quote, 80), ref: l.ref };
+}
 function factRow(f) {
     return { id: f.id, kind: f.kind, subject: `${f.subjectType}:${f.subjectRef}`, key: f.key, status: f.status, summary: excerpt(f.summary, 80) };
 }
@@ -1934,7 +1948,7 @@ Options:
   --order desc|asc      content search's sort direction (default: desc, best or newest first)
   --limit <n>           how many results content search, creatives list, campaigns, voice, ads tags, content tags and content to-check
                         return, or how many ads ads autotag tags and how many items content autotag tags
-  --library <slug>      with knowledge search, only this library: creative-cartel or exodus
+  --library <slug>      with knowledge search, only this library: creative-cartel, exodus or meta-policy
   --ad <id>             with ads tags, only this Meta ad's tags; with ads autotag, only this ad
   --kind email|text|page   with content tags and content autotag, only that kind (content autotag takes a comma list)
   --max-seconds <n>     stop a runner's run after this many seconds, if that comes before its deadline
@@ -1987,6 +2001,7 @@ function parseOptions(argv) {
             force: { type: "boolean", default: false },
             yes: { type: "boolean", default: false },
             from: { type: "string" },
+            since: { type: "string" },
             to: { type: "string" },
             grain: { type: "string" },
             channel: { type: "string" },
@@ -2082,6 +2097,7 @@ function parseOptions(argv) {
             force: values.force,
             yes: values.yes,
             from: values.from,
+            since: values.since,
             to: values.to,
             grain: values.grain,
             channel: values.channel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrangled/cli",
-  "version": "0.3.22",
+  "version": "0.3.23",
   "description": "Command-line access to your marketing data warehouse, for people and coding agents",
   "type": "module",
   "bin": {