@dayofweek/dcli 1.8.0 → 1.9.0

package/dist/bin/dcli.js

@@ -328,6 +328,87 @@ brainActors
         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

@@ -4484,6 +4484,40 @@ var DayOfWeekClient = class {
   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");
@@ -5110,7 +5144,7 @@ var import_promises4 = require("node:readline/promises");
 // package.json
 var package_default = {
   name: "@dayofweek/dcli",
-  version: "1.8.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",
@@ -5441,6 +5475,48 @@ brainActors.command("add").description("Add an actor to an area (idempotent on n
     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

@@ -213,6 +213,44 @@ export declare class DayOfWeekClient {
         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. */

package/dist/client.js

@@ -344,6 +344,40 @@ export class DayOfWeekClient {
     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,6 +1,6 @@
 {
   "name": "@dayofweek/dcli",
-  "version": "1.8.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",