@dench.com/cli 3.6.0 → 3.6.2-staging.369

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/dench.ts

@@ -10,7 +10,7 @@ import {
   stat,
   writeFile,
 } from "node:fs/promises";
-import { homedir, hostname, userInfo } from "node:os";
+import { hostname, userInfo } from "node:os";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { ConvexHttpClient } from "convex/browser";
@@ -29,6 +29,7 @@ import {
   STAGING_HOST,
 } from "./host";
 import { cliVersion } from "./lib/cli-version";
+import { denchConfigDirectory } from "./lib/config-path.mjs";
 import { resolveOrganizationBySelector } from "./lib/organizationSelector";
 import { backendErrorText } from "./lib/public-error";
 import { normalizeUnipileToolkitSlug } from "./lib/unipile-toolkits";
@@ -210,7 +211,7 @@ const api = {
     },
   },
 };
-const CONFIG_DIR = join(homedir(), ".dench");
+const CONFIG_DIR = denchConfigDirectory();
 const CONFIG_PATH = join(CONFIG_DIR, "config.json");
 const args = process.argv.slice(2);
 const json = args.includes("--json");

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/config-path.mjs

@@ -0,0 +1,8 @@
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+
+/** Explicit CLI state isolation for managed agents; never changes the OS home. */
+export function denchConfigDirectory(env = process.env) {
+  const configured = env.DENCH_CONFIG_DIR?.trim();
+  return configured ? resolve(configured) : join(homedir(), ".dench");
+}

package/lib/load-dev-env.mjs

@@ -35,13 +35,12 @@
 // disabled.
 
 import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { denchConfigDirectory } from "./config-path.mjs";
 
 const WORKSPACE_PACKAGE_NAME = "ironclaw-cloud";
 const ENV_FILES = [".env", ".env.local"];
-const CONFIG_PATH = join(homedir(), ".dench", "config.json");
 
 const TRUE_ENV_VALUES = new Set(["1", "true", "yes", "on"]);
 
@@ -55,8 +54,9 @@ function argvOptIn(argv) {
   return argv.includes("--dev") || argv.includes("--use-dev-env");
 }
 
-function configOptIn() {
+function configOptIn(env) {
   try {
+    const CONFIG_PATH = join(denchConfigDirectory(env), "config.json");
     if (!existsSync(CONFIG_PATH)) return false;
     const raw = readFileSync(CONFIG_PATH, "utf8");
     const config = JSON.parse(raw);
@@ -70,7 +70,9 @@ function configOptIn() {
 
 function isLocalUrl(value) {
   try {
-    const url = new URL(/^https?:\/\//.test(value) ? value : `https://${value}`);
+    const url = new URL(
+      /^https?:\/\//.test(value) ? value : `https://${value}`,
+    );
     const host = url.hostname;
     return (
       host === "localhost" ||
@@ -90,7 +92,7 @@ export function shouldLoadDevEnv({
 } = {}) {
   if (envFlagEnabled(env.DENCH_USE_DEV_ENV)) return "env";
   if (argvOptIn(argv)) return "argv";
-  if (configOptIn()) return "config";
+  if (configOptIn(env)) return "config";
   return false;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dench.com/cli",
-  "version": "3.6.0",
+  "version": "3.6.2-staging.369",
   "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",