@dayofweek/dcli 1.9.1 → 1.11.0

package/README.md

@@ -188,6 +188,38 @@ customer is irreversible and outward-facing, so it cannot happen as a side
 effect of reading the inbox — a person approves the exact text first, and
 `--approved` records that they did.
 
+## Cross-org reads (staff)
+
+Admin tokens can read across every organization. Both listings are
+cursor-paged: filters apply within each scanned page, so a page can be short
+or empty while more rows remain — `--all` walks the pages for you.
+
+```bash
+dcli admin entities --category supply --all --json      # every producer, every org
+dcli admin entities --role producer --with-roles --json  # first page, roles attached
+dcli admin entities --search huseby --json
+dcli admin entities --limit 500 --cursor <nextCursor> --json
+
+dcli admin market-intel stats --json                     # the market intelligence register, counted
+dcli admin market-intel list --type farm --region Agder --all --json
+dcli admin market-intel list --bbox 57.95,6.35,59.70,9.40 --json
+dcli admin market-intel get <id> --json
+```
+
+Entity rows carry `typeName` and `typeCategory` resolved from the entity's
+type — count on those, not on the legacy `entityType` string. The market
+intelligence register is a separate table from the entity hierarchy (every row
+has coordinates; `linkedEntity` names the hierarchy entity it points at, if
+any), so "how many producers do we know of" reads both.
+
+An area's actors can be tied to the platform entity they are:
+
+```bash
+dcli brain actors list --area <areaId> --match --json    # unlinked actors get name-matched candidates (admins)
+dcli brain actors link --area <areaId> --actor <actorId> --entity <entityId>
+dcli brain actors link --area <areaId> --actor <actorId> --unlink
+```
+
 ## Legacy platform commands
 
 Existing read/proposal workflows remain compatible:

package/dist/bin/dcli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Command } from "commander";
-import { ApiError, DayOfWeekClient, toArrayBuffer } from "../client.js";
+import { ApiError, DayOfWeekClient, toArrayBuffer, collectAdminPages } from "../client.js";
 import { getToken, getApiUrl, saveConfig, loadConfig, saveCredential, deleteCredential } from "../config.js";
 import { browserLogin } from "../auth/login.js";
 import { parseBrainResource } from "../uri.js";
@@ -326,8 +326,29 @@ brainActors
     .command("list")
     .description("List an area's actors (active, sorted by name)")
     .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .option("--match", "Suggest matching platform entities for unlinked actors (admins)")
     .action(async (opts) => {
-    output(await getClient().listBrainActors(opts.area));
+    output(await getClient().listBrainActors(opts.area, { match: opts.match }));
+});
+brainActors
+    .command("link")
+    .description("Link an actor to the platform entity it is (or --unlink)")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .requiredOption("--actor <actorId>", "Actor id (from `brain actors list`)")
+    .option("--entity <entityId>", "Platform entity id (from `admin entities` or `read entities`)")
+    .option("--unlink", "Remove the current link")
+    .action(async (opts) => {
+    if (!opts.entity && !opts.unlink) {
+        throw new Error("Provide --entity <entityId> to link, or --unlink to remove the link");
+    }
+    if (opts.entity && opts.unlink) {
+        throw new Error("--entity and --unlink are mutually exclusive");
+    }
+    output(await getClient().linkBrainActor({
+        areaId: opts.area,
+        actorId: opts.actor,
+        entityId: opts.unlink ? null : opts.entity,
+    }));
 });
 brainActors
     .command("add")
@@ -430,6 +451,71 @@ brainSource
     }
     output(await getClient().scopeBrainSource(sourceId, opts.actor ?? null));
 });
+const brainTags = brain
+    .command("tags")
+    .description("Work with an area's tag vocabulary and resource couplings");
+brainTags
+    .command("list")
+    .description("List an area's tags (predefined hierarchical set + user-defined)")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .action(async (opts) => {
+    output(await getClient().listBrainTags(opts.area));
+});
+brainTags
+    .command("add")
+    .description("Add a user-defined tag (idempotent on the derived key)")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .requiredOption("--label <label>", "Tag label")
+    .option("--parent <key>", "Parent tag key (makes this a child tag)")
+    .option("--description <text>", "What the tag means")
+    .action(async (opts) => {
+    output(await getClient().createBrainTag({
+        areaId: opts.area,
+        label: opts.label,
+        parentKey: opts.parent,
+        description: opts.description,
+    }));
+});
+brainTags
+    .command("couplings")
+    .description("List tag/actor couplings — filter by actor, tag, source or note")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .option("--tag <key>", "Resources coupled to this tag")
+    .option("--actor <actorId>", "Resources coupled to this actor")
+    .option("--source <sourceId>", "One source's tags and actors")
+    .option("--note <noteId>", "One note/page's tags and actors")
+    .action(async (opts) => {
+    output(await getClient().listBrainCouplings({
+        areaId: opts.area,
+        tag: opts.tag,
+        actor: opts.actor,
+        source: opts.source,
+        note: opts.note,
+    }));
+});
+brainTags
+    .command("couple")
+    .description("Couple a source/note to a tag or an actor (--remove uncouples)")
+    .option("--source <sourceId>", "Source to couple")
+    .option("--note <noteId>", "Note/page to couple")
+    .option("--tag <key>", "Tag key (from `brain tags list`)")
+    .option("--actor <actorId>", "Actor id (from `brain actors list`)")
+    .option("--remove", "Remove the coupling instead of adding it")
+    .action(async (opts) => {
+    if (Boolean(opts.source) === Boolean(opts.note)) {
+        throw new Error("Pass exactly one of --source <sourceId> or --note <noteId>");
+    }
+    if (Boolean(opts.tag) === Boolean(opts.actor)) {
+        throw new Error("Pass exactly one of --tag <key> or --actor <actorId>");
+    }
+    output(await getClient().coupleBrainResource({
+        sourceId: opts.source,
+        noteId: opts.note,
+        tagKey: opts.tag,
+        actorId: opts.actor,
+        remove: opts.remove,
+    }));
+});
 auth
     .command("devices")
     .description("List your agent tokens")
@@ -1284,22 +1370,86 @@ function registerAdminCommands() {
         .description("Admin-only cross-org operations (DoW staff)");
     admin
         .command("entities")
-        .description("List entities across all orgs with admin filters")
-        .option("--type <entityType>", "Filter by entity type")
+        .description("List entities across all orgs with admin filters (cursor-paged)")
+        .option("--type <entityType>", "Filter by type name (farm, producer, restaurant, …)")
+        .option("--category <category>", "Filter by type category (supply, demand, partner, financial, …)")
+        .option("--role <role>", "Only entities holding an active role: customer, partner, investor, producer, market_intel")
+        .option("--with-roles", "Attach each entity's active roles")
         .option("--missing-location", "Only entities lacking metadata.places[].lat/lng")
         .option("--search <query>", "Substring match on name")
         .option("--org <slug>", "Restrict to a single org slug or ID")
-        .option("--limit <count>", "Max results (default 200)", parseInt)
+        .option("--limit <count>", "Rows scanned per page (default 200, max 2000)", parseInt)
+        .option("--cursor <cursor>", "Continue from a previous page's nextCursor")
+        .option("--all", "Walk every page and return all matches")
         .action(async (opts) => {
         const client = getClient();
-        const result = await client.adminListEntities({
+        const fetchPage = (cursor) => client.adminListEntities({
             org: opts.org,
             type: opts.type,
+            category: opts.category,
+            role: opts.role,
+            withRoles: opts.withRoles,
             missingLocation: opts.missingLocation,
             search: opts.search,
             limit: opts.limit,
+            cursor,
         });
-        output(result);
+        output(opts.all ? await collectAdminPages(fetchPage, opts.cursor) : await fetchPage(opts.cursor));
+    });
+    // The market intelligence register is a separate table from the entity
+    // hierarchy: businesses recorded for research and prospecting, each with
+    // coordinates. A platform-wide "how many do we know of" reads both.
+    const marketIntel = admin
+        .command("market-intel")
+        .description("The market intelligence register — businesses recorded for research and prospecting");
+    marketIntel
+        .command("list")
+        .description("List register rows (cursor-paged, newest first)")
+        .option("--type <entityType>", "farm, restaurant, farm_shop, retail_store, distributor, processor, market, cooperative, supplier, customer, competitor, other")
+        .option("--relationship <type>", "prospect, active_customer, supplier, partner, competitor, market_research, other")
+        .option("--priority <priority>", "critical, high, medium, low, watching")
+        .option("--stage <stage>", "Opportunity stage (research, qualified_lead, negotiation, …)")
+        .option("--region <region>", "Exact match on region (case-insensitive)")
+        .option("--search <query>", "Substring match on name")
+        .option("--bbox <latMin,lngMin,latMax,lngMax>", "Only rows inside a lat/lng box")
+        .option("--active", "Only active rows")
+        .option("--inactive", "Only inactive rows")
+        .option("--org <slug>", "Restrict to the owning org")
+        .option("--limit <count>", "Rows scanned per page (default 200, max 2000)", parseInt)
+        .option("--cursor <cursor>", "Continue from a previous page's nextCursor")
+        .option("--all", "Walk every page and return all matches")
+        .action(async (opts) => {
+        if (opts.active && opts.inactive) {
+            throw new Error("--active and --inactive are mutually exclusive");
+        }
+        const client = getClient();
+        const fetchPage = (cursor) => client.adminListMarketIntel({
+            org: opts.org,
+            type: opts.type,
+            relationship: opts.relationship,
+            priority: opts.priority,
+            stage: opts.stage,
+            region: opts.region,
+            search: opts.search,
+            bbox: opts.bbox,
+            active: opts.active ? true : opts.inactive ? false : undefined,
+            limit: opts.limit,
+            cursor,
+        });
+        output(opts.all ? await collectAdminPages(fetchPage, opts.cursor) : await fetchPage(opts.cursor));
+    });
+    marketIntel
+        .command("get <id>")
+        .description("One register record with its latest interactions")
+        .action(async (id) => {
+        output(await getClient().adminGetMarketIntel(id));
+    });
+    marketIntel
+        .command("stats")
+        .description("Counts by type, relationship, priority, stage, region and country")
+        .option("--org <slug>", "Restrict to the owning org")
+        .action(async (opts) => {
+        output(await getClient().adminMarketIntelStats(opts.org));
     });
     admin
         .command("proposals")

package/dist/bundle/dcli.cjs

@@ -4209,6 +4209,21 @@ var ApiError = class extends Error {
     this.name = "ApiError";
   }
 };
+async function collectAdminPages(fetchPage, startCursor) {
+  const results = [];
+  let cursor = startCursor;
+  let scanned = 0;
+  let pages = 0;
+  for (; ; ) {
+    const page = await fetchPage(cursor);
+    results.push(...page.results);
+    scanned += page.scanned ?? page.results.length;
+    pages += 1;
+    if (page.isDone || !page.nextCursor) break;
+    cursor = page.nextCursor;
+  }
+  return { results, total: results.length, scanned, isDone: true, nextCursor: null, truncated: false, pages };
+}
 var DayOfWeekClient = class {
   baseUrl;
   token;
@@ -4427,12 +4442,43 @@ var DayOfWeekClient = class {
     const params = new URLSearchParams();
     if (opts?.org) params.set("org", opts.org);
     if (opts?.type) params.set("type", opts.type);
+    if (opts?.category) params.set("category", opts.category);
+    if (opts?.role) params.set("role", opts.role);
+    if (opts?.withRoles) params.set("with-roles", "1");
     if (opts?.missingLocation) params.set("missing-location", "1");
     if (opts?.search) params.set("search", opts.search);
     if (opts?.limit) params.set("limit", String(opts.limit));
+    if (opts?.cursor) params.set("cursor", opts.cursor);
     const qs = params.toString();
     return this.get(`/admin/entities${qs ? `?${qs}` : ""}`);
   }
+  // The market intelligence register: businesses recorded for research and
+  // prospecting, each with coordinates — a separate table from the entity
+  // hierarchy, so a platform-wide count has to read both.
+  async adminListMarketIntel(opts) {
+    const params = new URLSearchParams();
+    if (opts?.org) params.set("org", opts.org);
+    if (opts?.type) params.set("type", opts.type);
+    if (opts?.relationship) params.set("relationship", opts.relationship);
+    if (opts?.priority) params.set("priority", opts.priority);
+    if (opts?.stage) params.set("stage", opts.stage);
+    if (opts?.region) params.set("region", opts.region);
+    if (opts?.search) params.set("search", opts.search);
+    if (opts?.bbox) params.set("bbox", opts.bbox);
+    if (opts?.active !== void 0) params.set("active", opts.active ? "1" : "0");
+    if (opts?.limit) params.set("limit", String(opts.limit));
+    if (opts?.cursor) params.set("cursor", opts.cursor);
+    const qs = params.toString();
+    return this.get(`/admin/market-intel${qs ? `?${qs}` : ""}`);
+  }
+  /** One register record in full, with its latest interactions. */
+  async adminGetMarketIntel(id) {
+    return this.get(`/admin/market-intel/${encodeURIComponent(id)}`);
+  }
+  /** Counts over the whole register — by type, relationship, priority, stage, region, country. */
+  async adminMarketIntelStats(org) {
+    return this.get(`/admin/market-intel/stats${org ? `?org=${encodeURIComponent(org)}` : ""}`);
+  }
   async adminListProposals(opts) {
     const params = new URLSearchParams();
     if (opts?.status) params.set("status", opts.status);
@@ -4472,9 +4518,19 @@ var DayOfWeekClient = class {
   async listBrainSources(areaId) {
     return this.get(`/brain/sources?area=${encodeURIComponent(areaId)}`);
   }
-  /** An area's actors (people and organizations, the Actors tab). Active only. */
-  async listBrainActors(areaId) {
-    return this.get(`/brain/actors?area=${encodeURIComponent(areaId)}`);
+  /**
+   * An area's actors (people and organizations, the Actors tab). Active only.
+   * With `match`, admins also get `candidates` on unlinked actors — the
+   * platform entities whose name matches — to review before linking.
+   */
+  async listBrainActors(areaId, opts) {
+    const params = new URLSearchParams({ area: areaId });
+    if (opts?.match) params.set("match", "1");
+    return this.get(`/brain/actors?${params.toString()}`);
+  }
+  /** Link an actor to the platform entity it is; `entityId: null` unlinks. */
+  async linkBrainActor(input) {
+    return this.post("/brain/actors/link", input);
   }
   /**
    * Create an actor in an area. Idempotent on (area, name): an existing active
@@ -4518,6 +4574,27 @@ var DayOfWeekClient = class {
   async scopeBrainSource(sourceId, actorId) {
     return this.patch(`/brain/sources/${encodeURIComponent(sourceId)}/actor`, { actorId });
   }
+  /** The area's tag vocabulary: predefined hierarchical set + user-defined. */
+  async listBrainTags(areaId) {
+    return this.get(`/brain/tags?area=${encodeURIComponent(areaId)}`);
+  }
+  /** Add a user-defined tag to an area's vocabulary. Idempotent on the key. */
+  async createBrainTag(input) {
+    return this.post("/brain/tags", input);
+  }
+  /** Tag/actor couplings, filterable by actor, tag, source or note. */
+  async listBrainCouplings(input) {
+    const params = new URLSearchParams({ area: input.areaId });
+    if (input.tag) params.set("tag", input.tag);
+    if (input.actor) params.set("actor", input.actor);
+    if (input.source) params.set("source", input.source);
+    if (input.note) params.set("note", input.note);
+    return this.get(`/brain/tags/couplings?${params.toString()}`);
+  }
+  /** Couple (or uncouple, with remove) a source/note to a tag or an actor. */
+  async coupleBrainResource(input) {
+    return this.post("/brain/tags/couplings", input);
+  }
   /** Entities with an active customer role and no investor/partner/producer role. */
   async adminCustomersOnly() {
     return this.get("/admin/customers-only");
@@ -5144,7 +5221,7 @@ var import_promises4 = require("node:readline/promises");
 // package.json
 var package_default = {
   name: "@dayofweek/dcli",
-  version: "1.9.1",
+  version: "1.11.0",
   description: "CLI for the Day of Week AgTech platform \u2014 read data and submit proposals for review",
   license: "MIT",
   type: "module",
@@ -5475,8 +5552,21 @@ brainSource.command("download <uri>").description("Download exact original bytes
   }));
 });
 var brainActors = brain.command("actors").description("Work with an area's actors (people and organizations)");
-brainActors.command("list").description("List an area's actors (active, sorted by name)").requiredOption("--area <areaId>", "Area id (from `brain list`)").action(async (opts) => {
-  output(await getClient().listBrainActors(opts.area));
+brainActors.command("list").description("List an area's actors (active, sorted by name)").requiredOption("--area <areaId>", "Area id (from `brain list`)").option("--match", "Suggest matching platform entities for unlinked actors (admins)").action(async (opts) => {
+  output(await getClient().listBrainActors(opts.area, { match: opts.match }));
+});
+brainActors.command("link").description("Link an actor to the platform entity it is (or --unlink)").requiredOption("--area <areaId>", "Area id (from `brain list`)").requiredOption("--actor <actorId>", "Actor id (from `brain actors list`)").option("--entity <entityId>", "Platform entity id (from `admin entities` or `read entities`)").option("--unlink", "Remove the current link").action(async (opts) => {
+  if (!opts.entity && !opts.unlink) {
+    throw new Error("Provide --entity <entityId> to link, or --unlink to remove the link");
+  }
+  if (opts.entity && opts.unlink) {
+    throw new Error("--entity and --unlink are mutually exclusive");
+  }
+  output(await getClient().linkBrainActor({
+    areaId: opts.area,
+    actorId: opts.actor,
+    entityId: opts.unlink ? null : opts.entity
+  }));
 });
 brainActors.command("add").description("Add an actor to an area (idempotent on name)").requiredOption("--area <areaId>", "Area id (from `brain list`)").requiredOption("--name <name>", "Actor name (person or organization)").option("--kind <kind>", "person | organization", "organization").option("--role <text>", "Role or relationship in the project").option("--description <text>", "Longer free-text description").action(async (opts) => {
   if (opts.kind !== "person" && opts.kind !== "organization") {
@@ -5532,6 +5622,42 @@ brainSource.command("scope <sourceId>").description("Scope a source to an actor
   }
   output(await getClient().scopeBrainSource(sourceId, opts.actor ?? null));
 });
+var brainTags = brain.command("tags").description("Work with an area's tag vocabulary and resource couplings");
+brainTags.command("list").description("List an area's tags (predefined hierarchical set + user-defined)").requiredOption("--area <areaId>", "Area id (from `brain list`)").action(async (opts) => {
+  output(await getClient().listBrainTags(opts.area));
+});
+brainTags.command("add").description("Add a user-defined tag (idempotent on the derived key)").requiredOption("--area <areaId>", "Area id (from `brain list`)").requiredOption("--label <label>", "Tag label").option("--parent <key>", "Parent tag key (makes this a child tag)").option("--description <text>", "What the tag means").action(async (opts) => {
+  output(await getClient().createBrainTag({
+    areaId: opts.area,
+    label: opts.label,
+    parentKey: opts.parent,
+    description: opts.description
+  }));
+});
+brainTags.command("couplings").description("List tag/actor couplings \u2014 filter by actor, tag, source or note").requiredOption("--area <areaId>", "Area id (from `brain list`)").option("--tag <key>", "Resources coupled to this tag").option("--actor <actorId>", "Resources coupled to this actor").option("--source <sourceId>", "One source's tags and actors").option("--note <noteId>", "One note/page's tags and actors").action(async (opts) => {
+  output(await getClient().listBrainCouplings({
+    areaId: opts.area,
+    tag: opts.tag,
+    actor: opts.actor,
+    source: opts.source,
+    note: opts.note
+  }));
+});
+brainTags.command("couple").description("Couple a source/note to a tag or an actor (--remove uncouples)").option("--source <sourceId>", "Source to couple").option("--note <noteId>", "Note/page to couple").option("--tag <key>", "Tag key (from `brain tags list`)").option("--actor <actorId>", "Actor id (from `brain actors list`)").option("--remove", "Remove the coupling instead of adding it").action(async (opts) => {
+  if (Boolean(opts.source) === Boolean(opts.note)) {
+    throw new Error("Pass exactly one of --source <sourceId> or --note <noteId>");
+  }
+  if (Boolean(opts.tag) === Boolean(opts.actor)) {
+    throw new Error("Pass exactly one of --tag <key> or --actor <actorId>");
+  }
+  output(await getClient().coupleBrainResource({
+    sourceId: opts.source,
+    noteId: opts.note,
+    tagKey: opts.tag,
+    actorId: opts.actor,
+    remove: opts.remove
+  }));
+});
 auth.command("devices").description("List your agent tokens").action(async () => {
   const client = getClient();
   const devices = await client.listDevices();
@@ -6097,16 +6223,47 @@ function registerAdminCommands() {
   const cfg = loadConfig();
   if (!cfg.isAdmin) return;
   const admin = program2.command("admin", { hidden: true }).description("Admin-only cross-org operations (DoW staff)");
-  admin.command("entities").description("List entities across all orgs with admin filters").option("--type <entityType>", "Filter by entity type").option("--missing-location", "Only entities lacking metadata.places[].lat/lng").option("--search <query>", "Substring match on name").option("--org <slug>", "Restrict to a single org slug or ID").option("--limit <count>", "Max results (default 200)", parseInt).action(async (opts) => {
+  admin.command("entities").description("List entities across all orgs with admin filters (cursor-paged)").option("--type <entityType>", "Filter by type name (farm, producer, restaurant, \u2026)").option("--category <category>", "Filter by type category (supply, demand, partner, financial, \u2026)").option("--role <role>", "Only entities holding an active role: customer, partner, investor, producer, market_intel").option("--with-roles", "Attach each entity's active roles").option("--missing-location", "Only entities lacking metadata.places[].lat/lng").option("--search <query>", "Substring match on name").option("--org <slug>", "Restrict to a single org slug or ID").option("--limit <count>", "Rows scanned per page (default 200, max 2000)", parseInt).option("--cursor <cursor>", "Continue from a previous page's nextCursor").option("--all", "Walk every page and return all matches").action(async (opts) => {
     const client = getClient();
-    const result = await client.adminListEntities({
+    const fetchPage = (cursor) => client.adminListEntities({
       org: opts.org,
       type: opts.type,
+      category: opts.category,
+      role: opts.role,
+      withRoles: opts.withRoles,
       missingLocation: opts.missingLocation,
       search: opts.search,
-      limit: opts.limit
+      limit: opts.limit,
+      cursor
     });
-    output(result);
+    output(opts.all ? await collectAdminPages(fetchPage, opts.cursor) : await fetchPage(opts.cursor));
+  });
+  const marketIntel = admin.command("market-intel").description("The market intelligence register \u2014 businesses recorded for research and prospecting");
+  marketIntel.command("list").description("List register rows (cursor-paged, newest first)").option("--type <entityType>", "farm, restaurant, farm_shop, retail_store, distributor, processor, market, cooperative, supplier, customer, competitor, other").option("--relationship <type>", "prospect, active_customer, supplier, partner, competitor, market_research, other").option("--priority <priority>", "critical, high, medium, low, watching").option("--stage <stage>", "Opportunity stage (research, qualified_lead, negotiation, \u2026)").option("--region <region>", "Exact match on region (case-insensitive)").option("--search <query>", "Substring match on name").option("--bbox <latMin,lngMin,latMax,lngMax>", "Only rows inside a lat/lng box").option("--active", "Only active rows").option("--inactive", "Only inactive rows").option("--org <slug>", "Restrict to the owning org").option("--limit <count>", "Rows scanned per page (default 200, max 2000)", parseInt).option("--cursor <cursor>", "Continue from a previous page's nextCursor").option("--all", "Walk every page and return all matches").action(async (opts) => {
+    if (opts.active && opts.inactive) {
+      throw new Error("--active and --inactive are mutually exclusive");
+    }
+    const client = getClient();
+    const fetchPage = (cursor) => client.adminListMarketIntel({
+      org: opts.org,
+      type: opts.type,
+      relationship: opts.relationship,
+      priority: opts.priority,
+      stage: opts.stage,
+      region: opts.region,
+      search: opts.search,
+      bbox: opts.bbox,
+      active: opts.active ? true : opts.inactive ? false : void 0,
+      limit: opts.limit,
+      cursor
+    });
+    output(opts.all ? await collectAdminPages(fetchPage, opts.cursor) : await fetchPage(opts.cursor));
+  });
+  marketIntel.command("get <id>").description("One register record with its latest interactions").action(async (id) => {
+    output(await getClient().adminGetMarketIntel(id));
+  });
+  marketIntel.command("stats").description("Counts by type, relationship, priority, stage, region and country").option("--org <slug>", "Restrict to the owning org").action(async (opts) => {
+    output(await getClient().adminMarketIntelStats(opts.org));
   });
   admin.command("proposals").description("List agent proposals across all orgs").option("--status <status>", "Filter: pending, approved, rejected, failed").option("--source-agent <name>", "Filter by sourceAgent identifier").option("--limit <count>", "Max results (default 100)", parseInt).action(async (opts) => {
     const client = getClient();

package/dist/client.d.ts

@@ -13,6 +13,27 @@ export declare class ApiError extends Error {
     requestId?: string | undefined;
     constructor(status: number, message: string, code?: string | undefined, requestId?: string | undefined);
 }
+/**
+ * One page of a cursor-paged admin read. Filters apply within the scanned
+ * page, so `results` can be shorter than the page size — even empty — while
+ * `isDone` is still false. `nextCursor` is the only way forward.
+ */
+export type AdminPage<T = any> = {
+    results: T[];
+    total: number;
+    scanned: number;
+    isDone: boolean;
+    nextCursor: string | null;
+    truncated: boolean;
+};
+/**
+ * Walk a cursor-paged admin read to the end and return every match as one
+ * page. This is the loop behind `--all`; without it every caller re-invents
+ * it, or reaches for a giant `--limit` and still misses rows.
+ */
+export declare function collectAdminPages<T>(fetchPage: (cursor?: string) => Promise<AdminPage<T>>, startCursor?: string): Promise<AdminPage<T> & {
+    pages: number;
+}>;
 export declare class DayOfWeekClient {
     private baseUrl;
     private token;
@@ -146,14 +167,31 @@ export declare class DayOfWeekClient {
     adminListEntities(opts?: {
         org?: string;
         type?: string;
+        category?: string;
+        role?: string;
+        withRoles?: boolean;
         missingLocation?: boolean;
         search?: string;
         limit?: number;
-    }): Promise<{
-        results: any[];
-        truncated: boolean;
-        total: number;
-    }>;
+        cursor?: string;
+    }): Promise<AdminPage>;
+    adminListMarketIntel(opts?: {
+        org?: string;
+        type?: string;
+        relationship?: string;
+        priority?: string;
+        stage?: string;
+        region?: string;
+        search?: string;
+        bbox?: string;
+        active?: boolean;
+        limit?: number;
+        cursor?: string;
+    }): Promise<AdminPage>;
+    /** One register record in full, with its latest interactions. */
+    adminGetMarketIntel(id: string): Promise<any>;
+    /** Counts over the whole register — by type, relationship, priority, stage, region, country. */
+    adminMarketIntelStats(org?: string): Promise<any>;
     adminListProposals(opts?: {
         status?: string;
         sourceAgent?: string;
@@ -199,8 +237,20 @@ export declare class DayOfWeekClient {
     }): Promise<any>;
     /** Area sources, metadata only, newest first — the freshness evidence. */
     listBrainSources(areaId: string): Promise<any>;
-    /** An area's actors (people and organizations, the Actors tab). Active only. */
-    listBrainActors(areaId: string): Promise<any>;
+    /**
+     * An area's actors (people and organizations, the Actors tab). Active only.
+     * With `match`, admins also get `candidates` on unlinked actors — the
+     * platform entities whose name matches — to review before linking.
+     */
+    listBrainActors(areaId: string, opts?: {
+        match?: boolean;
+    }): Promise<any>;
+    /** Link an actor to the platform entity it is; `entityId: null` unlinks. */
+    linkBrainActor(input: {
+        areaId: string;
+        actorId: string;
+        entityId: string | null;
+    }): Promise<any>;
     /**
      * Create an actor in an area. Idempotent on (area, name): an existing active
      * actor comes back with `created: false` instead of a duplicate, so imports
@@ -251,6 +301,31 @@ export declare class DayOfWeekClient {
     }): Promise<any>;
     /** Scope a source to an actor (actorId null returns it to area level). */
     scopeBrainSource(sourceId: string, actorId: string | null): Promise<any>;
+    /** The area's tag vocabulary: predefined hierarchical set + user-defined. */
+    listBrainTags(areaId: string): Promise<any>;
+    /** Add a user-defined tag to an area's vocabulary. Idempotent on the key. */
+    createBrainTag(input: {
+        areaId: string;
+        label: string;
+        parentKey?: string;
+        description?: string;
+    }): Promise<any>;
+    /** Tag/actor couplings, filterable by actor, tag, source or note. */
+    listBrainCouplings(input: {
+        areaId: string;
+        tag?: string;
+        actor?: string;
+        source?: string;
+        note?: string;
+    }): Promise<any>;
+    /** Couple (or uncouple, with remove) a source/note to a tag or an actor. */
+    coupleBrainResource(input: {
+        sourceId?: string;
+        noteId?: string;
+        tagKey?: string;
+        actorId?: string;
+        remove?: boolean;
+    }): Promise<any>;
     /** Entities with an active customer role and no investor/partner/producer role. */
     adminCustomersOnly(): Promise<any>;
     /** Tips mailed to press@mail.dayofweek.com, read by the press-scan skill. */

package/dist/client.js

@@ -29,6 +29,27 @@ export class ApiError extends Error {
         this.name = "ApiError";
     }
 }
+/**
+ * Walk a cursor-paged admin read to the end and return every match as one
+ * page. This is the loop behind `--all`; without it every caller re-invents
+ * it, or reaches for a giant `--limit` and still misses rows.
+ */
+export async function collectAdminPages(fetchPage, startCursor) {
+    const results = [];
+    let cursor = startCursor;
+    let scanned = 0;
+    let pages = 0;
+    for (;;) {
+        const page = await fetchPage(cursor);
+        results.push(...page.results);
+        scanned += page.scanned ?? page.results.length;
+        pages += 1;
+        if (page.isDone || !page.nextCursor)
+            break;
+        cursor = page.nextCursor;
+    }
+    return { results, total: results.length, scanned, isDone: true, nextCursor: null, truncated: false, pages };
+}
 export class DayOfWeekClient {
     baseUrl;
     token;
@@ -280,15 +301,61 @@ export class DayOfWeekClient {
             params.set("org", opts.org);
         if (opts?.type)
             params.set("type", opts.type);
+        if (opts?.category)
+            params.set("category", opts.category);
+        if (opts?.role)
+            params.set("role", opts.role);
+        if (opts?.withRoles)
+            params.set("with-roles", "1");
         if (opts?.missingLocation)
             params.set("missing-location", "1");
         if (opts?.search)
             params.set("search", opts.search);
         if (opts?.limit)
             params.set("limit", String(opts.limit));
+        if (opts?.cursor)
+            params.set("cursor", opts.cursor);
         const qs = params.toString();
         return this.get(`/admin/entities${qs ? `?${qs}` : ""}`);
     }
+    // The market intelligence register: businesses recorded for research and
+    // prospecting, each with coordinates — a separate table from the entity
+    // hierarchy, so a platform-wide count has to read both.
+    async adminListMarketIntel(opts) {
+        const params = new URLSearchParams();
+        if (opts?.org)
+            params.set("org", opts.org);
+        if (opts?.type)
+            params.set("type", opts.type);
+        if (opts?.relationship)
+            params.set("relationship", opts.relationship);
+        if (opts?.priority)
+            params.set("priority", opts.priority);
+        if (opts?.stage)
+            params.set("stage", opts.stage);
+        if (opts?.region)
+            params.set("region", opts.region);
+        if (opts?.search)
+            params.set("search", opts.search);
+        if (opts?.bbox)
+            params.set("bbox", opts.bbox);
+        if (opts?.active !== undefined)
+            params.set("active", opts.active ? "1" : "0");
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        if (opts?.cursor)
+            params.set("cursor", opts.cursor);
+        const qs = params.toString();
+        return this.get(`/admin/market-intel${qs ? `?${qs}` : ""}`);
+    }
+    /** One register record in full, with its latest interactions. */
+    async adminGetMarketIntel(id) {
+        return this.get(`/admin/market-intel/${encodeURIComponent(id)}`);
+    }
+    /** Counts over the whole register — by type, relationship, priority, stage, region, country. */
+    async adminMarketIntelStats(org) {
+        return this.get(`/admin/market-intel/stats${org ? `?org=${encodeURIComponent(org)}` : ""}`);
+    }
     async adminListProposals(opts) {
         const params = new URLSearchParams();
         if (opts?.status)
@@ -332,9 +399,20 @@ export class DayOfWeekClient {
     async listBrainSources(areaId) {
         return this.get(`/brain/sources?area=${encodeURIComponent(areaId)}`);
     }
-    /** An area's actors (people and organizations, the Actors tab). Active only. */
-    async listBrainActors(areaId) {
-        return this.get(`/brain/actors?area=${encodeURIComponent(areaId)}`);
+    /**
+     * An area's actors (people and organizations, the Actors tab). Active only.
+     * With `match`, admins also get `candidates` on unlinked actors — the
+     * platform entities whose name matches — to review before linking.
+     */
+    async listBrainActors(areaId, opts) {
+        const params = new URLSearchParams({ area: areaId });
+        if (opts?.match)
+            params.set("match", "1");
+        return this.get(`/brain/actors?${params.toString()}`);
+    }
+    /** Link an actor to the platform entity it is; `entityId: null` unlinks. */
+    async linkBrainActor(input) {
+        return this.post("/brain/actors/link", input);
     }
     /**
      * Create an actor in an area. Idempotent on (area, name): an existing active
@@ -378,6 +456,31 @@ export class DayOfWeekClient {
     async scopeBrainSource(sourceId, actorId) {
         return this.patch(`/brain/sources/${encodeURIComponent(sourceId)}/actor`, { actorId });
     }
+    /** The area's tag vocabulary: predefined hierarchical set + user-defined. */
+    async listBrainTags(areaId) {
+        return this.get(`/brain/tags?area=${encodeURIComponent(areaId)}`);
+    }
+    /** Add a user-defined tag to an area's vocabulary. Idempotent on the key. */
+    async createBrainTag(input) {
+        return this.post("/brain/tags", input);
+    }
+    /** Tag/actor couplings, filterable by actor, tag, source or note. */
+    async listBrainCouplings(input) {
+        const params = new URLSearchParams({ area: input.areaId });
+        if (input.tag)
+            params.set("tag", input.tag);
+        if (input.actor)
+            params.set("actor", input.actor);
+        if (input.source)
+            params.set("source", input.source);
+        if (input.note)
+            params.set("note", input.note);
+        return this.get(`/brain/tags/couplings?${params.toString()}`);
+    }
+    /** Couple (or uncouple, with remove) a source/note to a tag or an actor. */
+    async coupleBrainResource(input) {
+        return this.post("/brain/tags/couplings", input);
+    }
     /** Entities with an active customer role and no investor/partner/producer role. */
     async adminCustomersOnly() {
         return this.get("/admin/customers-only");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dayofweek/dcli",
-  "version": "1.9.1",
-  "description": "CLI for the Day of Week AgTech platform \u2014 read data and submit proposals for review",
+  "version": "1.11.0",
+  "description": "CLI for the Day of Week AgTech platform — read data and submit proposals for review",
   "license": "MIT",
   "type": "module",
   "bin": {