@dench.com/cli 3.6.1-staging.362 → 3.6.3-staging.372

package/app-sdk.d.ts

@@ -1040,6 +1040,8 @@ export interface ApiRequests {
   "crm.activity.list": Record<string, unknown>;
   /** The record's generated Brief: health, who owes the next move, open threads, commitments, risks, next step. Read this before the ledger. — `dench crm brief` — GET /api/v1/crm/objects/{objectName}/entries/{entryId}/brief */
   "crm.brief.get": Record<string, unknown>;
+  /** Read-only source diagnostics: accessible evidence, association reasons, last Brief source manifest, generation queue, and your mailbox delivery health. Bounded, cursor-paged snapshot; does not certify complete history. — `dench crm context` — GET /api/v1/crm/objects/{objectName}/entries/{entryId}/context */
+  "crm.context.get": Record<string, unknown>;
   /** Rebuild a record's Brief from the current timeline. — `dench crm brief --regenerate` — POST /api/v1/crm/objects/{objectName}/entries/{entryId}/brief/regenerate */
   "crm.brief.regenerate": Record<string, unknown>;
   /** Bounded per-source counts of a CRM entry's activity ledger. — `dench crm activity` — GET /api/v1/crm/objects/{objectName}/entries/{entryId}/activity/count */
@@ -4175,6 +4177,7 @@ export interface ApiResponses {
   "crm.entries.history": unknown;
   "crm.activity.list": unknown;
   "crm.brief.get": unknown;
+  "crm.context.get": unknown;
   "crm.brief.regenerate": unknown;
   "crm.activity.count": unknown;
   "crm.notes.list": unknown;
@@ -7507,6 +7510,10 @@ export type DenchApiTree = {
       /** Search for companies through the enrichment gateway (also `dench companies find`). (`dench crm companies search`) */
       search(args: Req<"crm.companies.search">): Promise<Res<"crm.companies.search">>;
     };
+    context: {
+      /** Read-only source diagnostics: accessible evidence, association reasons, last Brief source manifest, generation queue, and your mailbox delivery health. Bounded, cursor-paged snapshot; does not certify complete history. (`dench crm context`) */
+      get(args: Req<"crm.context.get">): Promise<Res<"crm.context.get">>;
+    };
     detections: {
       /** List account-detection verdicts — why a domain (or personal address) did or did not become an account: verdict, counterparty type, probabilities, evidence threads, the rows created. `kind` picks the creator: `detections` (email + sweep), `linkedin` (the LinkedIn resolver's rows) or `all` (default). Newest first. (`dench crm detections list`) */
       list(args?: Req<"crm.detections.list">): Promise<Res<"crm.detections.list">>;

package/crm-context.ts

@@ -0,0 +1,66 @@
+import { makeFunctionReference } from "convex/server";
+import {
+  assertNoUnknownFlags,
+  type CrmCliContext,
+  callQuery,
+  out,
+  shift,
+} from "./crm";
+import { getFlag } from "./lib/cli-args";
+
+const getContext = makeFunctionReference<"query">(
+  "functions/crm/contextDiagnostics:getForEntry",
+);
+
+// Keep the shipped CLI independent of application-only Convex source files.
+type ContextPage = {
+  record: { label: string };
+  generation: { state: string };
+  scopeLimited: boolean;
+  sourceLimited: boolean;
+  sources: Array<{
+    occurredAt: number;
+    kind: string;
+    title: string;
+    association: string;
+    usedByLastBrief: boolean;
+    sourceTable: string;
+    sourceId: string;
+  }>;
+  mailboxes: Array<{ email: string; label: string }>;
+  nextCursor: string | null;
+};
+
+/** Read-only: inspecting a sync never starts a generation or connector call. */
+export async function runContextCommand(ctx: CrmCliContext): Promise<void> {
+  const objectName = shift(ctx.args, "object name");
+  const entryId = shift(ctx.args, "entry id");
+  const cursor = getFlag(ctx.args, "--cursor");
+  assertNoUnknownFlags(ctx.args, "crm context");
+  const result = (await callQuery(ctx, getContext, {
+    objectName,
+    entryId,
+    ...(cursor ? { cursor } : {}),
+  })) as ContextPage;
+  if (ctx.jsonOutput) {
+    out(ctx, result);
+    return;
+  }
+  const lines = [
+    `${result.record.label} · Brief ${result.generation.state}`,
+    "Bounded snapshot of sources you can access; complete history is not certified.",
+    ...(result.scopeLimited ? ["Related-record scope reached its limit."] : []),
+    ...(result.sourceLimited
+      ? ["Source inspection reached its read limit."]
+      : []),
+    ...result.sources.map(
+      (row) =>
+        `${new Date(row.occurredAt).toISOString()}  ${row.kind}  ${row.title} [${row.association}; ${row.usedByLastBrief ? "used by last Brief" : "not in last Brief"}] ${row.sourceTable}:${row.sourceId}`,
+    ),
+    ...result.mailboxes.map((row) => `${row.email}: ${row.label}`),
+    ...(result.nextCursor
+      ? [`More sources: repeat with --cursor '${result.nextCursor}'`]
+      : []),
+  ];
+  out(ctx, lines.join("\n"));
+}

package/crm.ts

@@ -40,6 +40,7 @@ import {
   runTasksCommand,
   runWatchCommand,
 } from "./crm-comments";
+import { runContextCommand } from "./crm-context";
 import { runDetectionsCommand } from "./crm-detections";
 import { runPrivacyCommand } from "./crm-privacy";
 import {
@@ -1087,6 +1088,8 @@ export async function runCrmCommand(opts: {
       return await runActivityCommand(ctx);
     case "brief":
       return await runBriefCommand(ctx);
+    case "context":
+      return await runContextCommand(ctx);
     case "notes":
       return await runNotesCommand(ctx);
     case "watch":
@@ -1164,6 +1167,7 @@ const CRM_SUBCOMMANDS = [
   "comments",
   "activity",
   "brief",
+  "context",
   "notes",
   "watch",
   "tasks",
@@ -4775,6 +4779,7 @@ Privacy (sharing is the default; this is YOUR opt-out for one record):
 
 Brief (what the record means right now — the FIRST thing to read):
   dench crm brief <object> <entryId> [--regenerate] [--json]
+  dench crm context <object> <entryId> [--cursor <cursor>] [--json]
       Generated from the timeline; read-only. Health, who owes the next
       move, open threads, commitments, risks, next step.
       Empty on a record nobody has opened yet — the call itself starts one;

package/lib/app-sdk-catalog.generated.ts

@@ -186,6 +186,7 @@ export const APP_SDK_OPERATIONS: readonly AppSdkOperationInfo[] = [
   {"id":"crm.entries.history","group":"crm","summary":"List a CRM entry's audit history.","cli":"dench crm history","method":"GET","path":"/crm/objects/{objectName}/entries/{entryId}/history","permission":"crm:read","pathParams":["objectName","entryId"]},
   {"id":"crm.activity.list","group":"crm","summary":"List a CRM entry's activity ledger (comments, notes, field changes, emails, meetings, Slack, LinkedIn) in one timeline, newest first by default.","cli":"dench crm activity","method":"GET","path":"/crm/objects/{objectName}/entries/{entryId}/activity","permission":"crm:read","pathParams":["objectName","entryId"]},
   {"id":"crm.brief.get","group":"crm","summary":"The record's generated Brief: health, who owes the next move, open threads, commitments, risks, next step. Read this before the ledger.","cli":"dench crm brief","method":"GET","path":"/crm/objects/{objectName}/entries/{entryId}/brief","permission":"crm:read","pathParams":["objectName","entryId"]},
+  {"id":"crm.context.get","group":"crm","summary":"Read-only source diagnostics: accessible evidence, association reasons, last Brief source manifest, generation queue, and your mailbox delivery health. Bounded, cursor-paged snapshot; does not certify complete history.","cli":"dench crm context","method":"GET","path":"/crm/objects/{objectName}/entries/{entryId}/context","permission":"crm:read","pathParams":["objectName","entryId"]},
   {"id":"crm.brief.regenerate","group":"crm","summary":"Rebuild a record's Brief from the current timeline.","cli":"dench crm brief --regenerate","method":"POST","path":"/crm/objects/{objectName}/entries/{entryId}/brief/regenerate","permission":"crm:write","pathParams":["objectName","entryId"]},
   {"id":"crm.activity.count","group":"crm","summary":"Bounded per-source counts of a CRM entry's activity ledger.","cli":"dench crm activity","method":"GET","path":"/crm/objects/{objectName}/entries/{entryId}/activity/count","permission":"crm:read","pathParams":["objectName","entryId"]},
   {"id":"crm.notes.list","group":"crm","summary":"List a CRM entry's notes (titled, document-style comments), newest first.","cli":"dench crm notes list","method":"GET","path":"/crm/objects/{objectName}/entries/{entryId}/notes","permission":"crm:read","pathParams":["objectName","entryId"]},

package/lib/command-registry.ts

@@ -1625,6 +1625,25 @@ const rawApiOperations = [
       }),
     },
   }),
+  op({
+    id: "crm.context.get",
+    group: "crm",
+    summary:
+      "Read-only source diagnostics: accessible evidence, association reasons, last Brief source manifest, generation queue, and your mailbox delivery health. Bounded, cursor-paged snapshot; does not certify complete history.",
+    cli: "dench crm context",
+    method: "GET",
+    path: "/crm/objects/{objectName}/entries/{entryId}/context",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: {
+      ...convex("query", "functions/crm/contextDiagnostics:getForEntry"),
+      transformArgs: (input) => ({
+        objectName: input.objectName,
+        entryId: input.entryId,
+        ...(typeof input.cursor === "string" ? { cursor: input.cursor } : {}),
+      }),
+    },
+  }),
   op({
     id: "crm.brief.regenerate",
     group: "crm",

package/lib/enrichment-gateway.ts

@@ -195,6 +195,7 @@ export type SignalRow = {
     personName?: string;
     personTitle?: string;
     personLinkedinUrl?: string;
+    personAvatarUrl?: string;
     term?: string;
     postUrl?: string;
     postText?: string;
@@ -1677,6 +1678,7 @@ export type SignalBuyer = {
   firstName?: string;
   title?: string;
   linkedinUrl?: string;
+  avatarUrl?: string;
   email?: string;
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dench.com/cli",
-  "version": "3.6.1-staging.362",
+  "version": "3.6.3-staging.372",
   "description": "Dench agent workspace CLI.",
   "type": "module",
   "bin": {
@@ -31,6 +31,7 @@
     "chat-spawn.ts",
     "crm.ts",
     "crm-comments.ts",
+    "crm-context.ts",
     "crm-analytics.ts",
     "crm-detections.ts",
     "crm-privacy.ts",