@wrangled/cli 0.3.25 → 0.3.26

package/dist/main.js

@@ -1326,7 +1326,11 @@ const commands = {
             const { fact } = await api(await resolveConnection(options.apiUrl), `${FACTS_PATH}/${encodeURIComponent(args[0])}`);
             if (options.format === "json")
                 return printJson({ fact });
-            printFields({ ...factRow(fact), summary: fact.summary, value: fact.value, evidence: fact.evidence, author: fact.author, "confirmed by": fact.confirmedBy, "decided by": fact.decidedBy, replaces: fact.replaces });
+            const nameKey = fact.key === NAME_KEY ? nameKeyLines(fact.value) : null;
+            const value = nameKey ? { means: fact.value.means } : { value: fact.value };
+            printFields({ ...factRow(fact), summary: fact.summary, ...value, evidence: fact.evidence, author: fact.author, "confirmed by": fact.confirmedBy, "decided by": fact.decidedBy, replaces: fact.replaces });
+            if (nameKey)
+                console.log(nameKey.join("\n"));
         },
     },
     "facts propose": {
@@ -1948,6 +1952,27 @@ function voiceLineRow(l) {
 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) };
 }
+/** The definition key that holds a workspace's name key: the server's NameKey, read here without its schema. */
+const NAME_KEY = "ad_name_key";
+const NAME_LEVELS = { campaign: "campaign", ad_set: "ad set", ad: "ad" };
+const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const arrayOf = (v) => (Array.isArray(v) ? v.filter(isObject) : []);
+/** A name key as lines a person reads: each pattern with an example name and what its segments mean, then the questions left. Null when the value holds none. */
+function nameKeyLines(value) {
+    const nameKey = isObject(value) && isObject(value.name_key) ? value.name_key : null;
+    if (!nameKey || !isObject(nameKey.levels))
+        return null;
+    const levels = nameKey.levels;
+    const patterns = Object.entries(NAME_LEVELS).flatMap(([level, label]) => arrayOf(levels[level]).map((pattern) => {
+        const segments = arrayOf(pattern.segments).map((s) => {
+            const meaning = typeof s.label === "string" ? s.label : String(s.meaning ?? "unknown").replaceAll("_", " ");
+            return `${String(s.name)} = ${meaning}${s.certainty === "guess" ? " (a guess)" : ""}`;
+        });
+        return `- ${label} names like ${String(pattern.example)}: ${segments.join("; ")}`;
+    }));
+    const questions = arrayOf(nameKey.open_questions).map((q) => `- ${String(q.text)}`);
+    return ["", "Name patterns:", ...(patterns.length > 0 ? patterns : ["- none yet"]), "", "Open questions:", ...(questions.length > 0 ? questions : ["- none"])];
+}
 const STORIES_PATH = "/api/v1/stories";
 function printStory(story) {
     const corrects = story.previousId ? `, correcting ${story.previousId}` : "";

package/package.json

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