@dayofweek/dcli 1.7.0 → 1.9.0

package/dist/bin/dcli.js

@@ -298,6 +298,117 @@ brainSource
         overwrite: opts.overwrite,
     }));
 });
+const 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("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") {
+        throw new Error(`--kind must be "person" or "organization", got "${opts.kind}"`);
+    }
+    output(await getClient().createBrainActor({
+        areaId: opts.area,
+        name: opts.name,
+        kind: opts.kind,
+        role: opts.role,
+        description: opts.description,
+    }));
+});
+brainActors
+    .command("matrix")
+    .description("The interview matrix: guide questions × active actors")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .action(async (opts) => {
+    output(await getClient().getBrainActorMatrix(opts.area));
+});
+brainActors
+    .command("extract")
+    .description("Trigger the platform's answer extraction (all active actors, or one)")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .option("--actor <actorId>", "Only this actor")
+    .action(async (opts) => {
+    output(await getClient().extractBrainActorAnswers({ areaId: opts.area, actorId: opts.actor }));
+});
+brainActors
+    .command("answer")
+    .description("Write one interview-matrix cell directly (marked capturedVia dcli, authoritative)")
+    .requiredOption("--actor <actorId>", "Actor id (from `brain actors list`)")
+    .requiredOption("--question <questionId>", "Question id (from `brain actors matrix`)")
+    .requiredOption("--answer <text>", "The answer; cite the source material in the text")
+    .option("--status <status>", "answered | partial | unknown", "answered")
+    .action(async (opts) => {
+    if (!["answered", "partial", "unknown"].includes(opts.status)) {
+        throw new Error(`--status must be answered, partial or unknown, got "${opts.status}"`);
+    }
+    output(await getClient().setBrainActorAnswer({
+        actorId: opts.actor,
+        questionId: opts.question,
+        answer: opts.answer,
+        status: opts.status,
+    }));
+});
+brainActors
+    .command("scores")
+    .description("Readiness scores: dimensions × active actors with full cells")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .action(async (opts) => {
+    output(await getClient().getBrainActorScores(opts.area));
+});
+brainActors
+    .command("score")
+    .description("Trigger the platform's readiness scoring (all active actors, or one)")
+    .requiredOption("--area <areaId>", "Area id (from `brain list`)")
+    .option("--actor <actorId>", "Only this actor")
+    .action(async (opts) => {
+    output(await getClient().scoreBrainActors({ areaId: opts.area, actorId: opts.actor }));
+});
+brainActors
+    .command("set-score")
+    .description("Write one readiness band directly (marked capturedVia dcli, authoritative)")
+    .requiredOption("--actor <actorId>", "Actor id (from `brain actors list`)")
+    .requiredOption("--dimension <key>", "Dimension key (from `brain actors scores`)")
+    .requiredOption("--band <band>", "red | orange | green")
+    .requiredOption("--rationale <text>", "Grounds for the band — required")
+    .option("--score <number>", "0..1 numeric backing (default derived from band)", parseFloat)
+    .option("--gaps <items...>", "Identified gaps")
+    .action(async (opts) => {
+    if (!["red", "orange", "green"].includes(opts.band)) {
+        throw new Error(`--band must be red, orange or green, got "${opts.band}"`);
+    }
+    output(await getClient().setBrainActorScore({
+        actorId: opts.actor,
+        dimensionKey: opts.dimension,
+        band: opts.band,
+        score: opts.score,
+        rationale: opts.rationale,
+        gaps: opts.gaps,
+    }));
+});
+brainSource
+    .command("scope <sourceId>")
+    .description("Scope a source to an actor (feeds the readiness tables)")
+    .option("--actor <actorId>", "Actor id (from `brain actors list`)")
+    .option("--clear", "Return the source to area level")
+    .action(async (sourceId, opts) => {
+    if (Boolean(opts.actor) === Boolean(opts.clear)) {
+        throw new Error("Pass exactly one of --actor <actorId> or --clear");
+    }
+    output(await getClient().scopeBrainSource(sourceId, opts.actor ?? null));
+});
 auth
     .command("devices")
     .description("List your agent tokens")

package/dist/bundle/dcli.cjs

@@ -4472,6 +4472,52 @@ 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)}`);
+  }
+  /**
+   * 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
+   * can re-run safely.
+   */
+  async createBrainActor(input) {
+    return this.post("/brain/actors", input);
+  }
+  /** The interview matrix: guide questions × active actors with answer cells. */
+  async getBrainActorMatrix(areaId) {
+    return this.get(`/brain/actors/matrix?area=${encodeURIComponent(areaId)}`);
+  }
+  /** Trigger the platform's answer extraction (one actor, or all active). */
+  async extractBrainActorAnswers(input) {
+    return this.post("/brain/actors/extract", input);
+  }
+  /**
+   * Write one interview-matrix cell directly. The cell is marked
+   * capturedVia "dcli" and the platform's extraction never overwrites it.
+   */
+  async setBrainActorAnswer(input) {
+    return this.post("/brain/actors/answers", input);
+  }
+  /** Readiness scores: dimensions × active actors with full cells. */
+  async getBrainActorScores(areaId) {
+    return this.get(`/brain/actors/scores?area=${encodeURIComponent(areaId)}`);
+  }
+  /** Trigger the platform's readiness scoring (one actor, or all active). */
+  async scoreBrainActors(input) {
+    return this.post("/brain/actors/score", input);
+  }
+  /**
+   * Write one readiness band directly (rationale required). The row is marked
+   * capturedVia "dcli" and the platform's scoring never overwrites it.
+   */
+  async setBrainActorScore(input) {
+    return this.post("/brain/actors/scores", input);
+  }
+  /** Scope a source to an actor (actorId null returns it to area level). */
+  async scopeBrainSource(sourceId, actorId) {
+    return this.patch(`/brain/sources/${encodeURIComponent(sourceId)}/actor`, { actorId });
+  }
   /** Entities with an active customer role and no investor/partner/producer role. */
   async adminCustomersOnly() {
     return this.get("/admin/customers-only");
@@ -5098,7 +5144,7 @@ var import_promises4 = require("node:readline/promises");
 // package.json
 var package_default = {
   name: "@dayofweek/dcli",
-  version: "1.7.0",
+  version: "1.9.0",
   description: "CLI for the Day of Week AgTech platform \u2014 read data and submit proposals for review",
   license: "MIT",
   type: "module",
@@ -5413,6 +5459,64 @@ brainSource.command("download <uri>").description("Download exact original bytes
     overwrite: opts.overwrite
   }));
 });
+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("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") {
+    throw new Error(`--kind must be "person" or "organization", got "${opts.kind}"`);
+  }
+  output(await getClient().createBrainActor({
+    areaId: opts.area,
+    name: opts.name,
+    kind: opts.kind,
+    role: opts.role,
+    description: opts.description
+  }));
+});
+brainActors.command("matrix").description("The interview matrix: guide questions \xD7 active actors").requiredOption("--area <areaId>", "Area id (from `brain list`)").action(async (opts) => {
+  output(await getClient().getBrainActorMatrix(opts.area));
+});
+brainActors.command("extract").description("Trigger the platform's answer extraction (all active actors, or one)").requiredOption("--area <areaId>", "Area id (from `brain list`)").option("--actor <actorId>", "Only this actor").action(async (opts) => {
+  output(await getClient().extractBrainActorAnswers({ areaId: opts.area, actorId: opts.actor }));
+});
+brainActors.command("answer").description("Write one interview-matrix cell directly (marked capturedVia dcli, authoritative)").requiredOption("--actor <actorId>", "Actor id (from `brain actors list`)").requiredOption("--question <questionId>", "Question id (from `brain actors matrix`)").requiredOption("--answer <text>", "The answer; cite the source material in the text").option("--status <status>", "answered | partial | unknown", "answered").action(async (opts) => {
+  if (!["answered", "partial", "unknown"].includes(opts.status)) {
+    throw new Error(`--status must be answered, partial or unknown, got "${opts.status}"`);
+  }
+  output(await getClient().setBrainActorAnswer({
+    actorId: opts.actor,
+    questionId: opts.question,
+    answer: opts.answer,
+    status: opts.status
+  }));
+});
+brainActors.command("scores").description("Readiness scores: dimensions \xD7 active actors with full cells").requiredOption("--area <areaId>", "Area id (from `brain list`)").action(async (opts) => {
+  output(await getClient().getBrainActorScores(opts.area));
+});
+brainActors.command("score").description("Trigger the platform's readiness scoring (all active actors, or one)").requiredOption("--area <areaId>", "Area id (from `brain list`)").option("--actor <actorId>", "Only this actor").action(async (opts) => {
+  output(await getClient().scoreBrainActors({ areaId: opts.area, actorId: opts.actor }));
+});
+brainActors.command("set-score").description("Write one readiness band directly (marked capturedVia dcli, authoritative)").requiredOption("--actor <actorId>", "Actor id (from `brain actors list`)").requiredOption("--dimension <key>", "Dimension key (from `brain actors scores`)").requiredOption("--band <band>", "red | orange | green").requiredOption("--rationale <text>", "Grounds for the band \u2014 required").option("--score <number>", "0..1 numeric backing (default derived from band)", parseFloat).option("--gaps <items...>", "Identified gaps").action(async (opts) => {
+  if (!["red", "orange", "green"].includes(opts.band)) {
+    throw new Error(`--band must be red, orange or green, got "${opts.band}"`);
+  }
+  output(await getClient().setBrainActorScore({
+    actorId: opts.actor,
+    dimensionKey: opts.dimension,
+    band: opts.band,
+    score: opts.score,
+    rationale: opts.rationale,
+    gaps: opts.gaps
+  }));
+});
+brainSource.command("scope <sourceId>").description("Scope a source to an actor (feeds the readiness tables)").option("--actor <actorId>", "Actor id (from `brain actors list`)").option("--clear", "Return the source to area level").action(async (sourceId, opts) => {
+  if (Boolean(opts.actor) === Boolean(opts.clear)) {
+    throw new Error("Pass exactly one of --actor <actorId> or --clear");
+  }
+  output(await getClient().scopeBrainSource(sourceId, opts.actor ?? null));
+});
 auth.command("devices").description("List your agent tokens").action(async () => {
   const client = getClient();
   const devices = await client.listDevices();

package/dist/client.d.ts

@@ -199,6 +199,58 @@ 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>;
+    /**
+     * 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
+     * can re-run safely.
+     */
+    createBrainActor(input: {
+        areaId: string;
+        name: string;
+        kind: "person" | "organization";
+        role?: string;
+        description?: string;
+    }): Promise<any>;
+    /** The interview matrix: guide questions × active actors with answer cells. */
+    getBrainActorMatrix(areaId: string): Promise<any>;
+    /** Trigger the platform's answer extraction (one actor, or all active). */
+    extractBrainActorAnswers(input: {
+        areaId: string;
+        actorId?: string;
+    }): Promise<any>;
+    /**
+     * Write one interview-matrix cell directly. The cell is marked
+     * capturedVia "dcli" and the platform's extraction never overwrites it.
+     */
+    setBrainActorAnswer(input: {
+        actorId: string;
+        questionId: string;
+        answer: string;
+        status?: "answered" | "partial" | "unknown";
+    }): Promise<any>;
+    /** Readiness scores: dimensions × active actors with full cells. */
+    getBrainActorScores(areaId: string): Promise<any>;
+    /** Trigger the platform's readiness scoring (one actor, or all active). */
+    scoreBrainActors(input: {
+        areaId: string;
+        actorId?: string;
+    }): Promise<any>;
+    /**
+     * Write one readiness band directly (rationale required). The row is marked
+     * capturedVia "dcli" and the platform's scoring never overwrites it.
+     */
+    setBrainActorScore(input: {
+        actorId: string;
+        dimensionKey: string;
+        band: "red" | "orange" | "green";
+        score?: number;
+        rationale: string;
+        gaps?: string[];
+    }): Promise<any>;
+    /** Scope a source to an actor (actorId null returns it to area level). */
+    scopeBrainSource(sourceId: string, actorId: string | null): 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. */
@@ -429,7 +481,7 @@ export type SharedSkillSummary = {
     httpsUrl: string;
     updatedAt: number;
 };
-export type SharedSkillBundle = Omit<SharedSkillSummary, "fileCount" | "byteSize"> & {
+export type SharedSkillBundle = SharedSkillSummary & {
     files: Array<{
         path: string;
         content: string;

package/dist/client.js

@@ -332,6 +332,52 @@ 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)}`);
+    }
+    /**
+     * 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
+     * can re-run safely.
+     */
+    async createBrainActor(input) {
+        return this.post("/brain/actors", input);
+    }
+    /** The interview matrix: guide questions × active actors with answer cells. */
+    async getBrainActorMatrix(areaId) {
+        return this.get(`/brain/actors/matrix?area=${encodeURIComponent(areaId)}`);
+    }
+    /** Trigger the platform's answer extraction (one actor, or all active). */
+    async extractBrainActorAnswers(input) {
+        return this.post("/brain/actors/extract", input);
+    }
+    /**
+     * Write one interview-matrix cell directly. The cell is marked
+     * capturedVia "dcli" and the platform's extraction never overwrites it.
+     */
+    async setBrainActorAnswer(input) {
+        return this.post("/brain/actors/answers", input);
+    }
+    /** Readiness scores: dimensions × active actors with full cells. */
+    async getBrainActorScores(areaId) {
+        return this.get(`/brain/actors/scores?area=${encodeURIComponent(areaId)}`);
+    }
+    /** Trigger the platform's readiness scoring (one actor, or all active). */
+    async scoreBrainActors(input) {
+        return this.post("/brain/actors/score", input);
+    }
+    /**
+     * Write one readiness band directly (rationale required). The row is marked
+     * capturedVia "dcli" and the platform's scoring never overwrites it.
+     */
+    async setBrainActorScore(input) {
+        return this.post("/brain/actors/scores", input);
+    }
+    /** Scope a source to an actor (actorId null returns it to area level). */
+    async scopeBrainSource(sourceId, actorId) {
+        return this.patch(`/brain/sources/${encodeURIComponent(sourceId)}/actor`, { actorId });
+    }
     /** 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.7.0",
-  "description": "CLI for the Day of Week AgTech platform — read data and submit proposals for review",
+  "version": "1.9.0",
+  "description": "CLI for the Day of Week AgTech platform \u2014 read data and submit proposals for review",
   "license": "MIT",
   "type": "module",
   "bin": {