npm - @dayofweek/dcli - Versions diffs - 1.8.0 → 1.9.1 - Mend

@dayofweek/dcli 1.8.0 → 1.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/bin/dcli.js CHANGED Viewed

@@ -267,10 +267,31 @@ brainSource
     .option("--mime <mimeType>", "MIME type; inferred from extension when omitted")
     .option("--meeting", "Mark this source as a recorded meeting")
     .option("--consent-ack", "Confirm recorded participants were informed and consented")
+    .option("--as-source", "Store an HTML document as a raw source instead of publishing it as a Page")
     .action(async (opts) => {
     if (opts.meeting && !opts.consentAck) {
         throw new Error("--consent-ack is required: you are attesting that recorded participants were informed and consented");
     }
+    // A full HTML document is almost always meant to be a Page (the Pages tab),
+    // which is published as a note via `brain share` — not stored as a raw
+    // source. Uploading it here would land it in Sources, where nobody looks
+    // for a page. Refuse unless the caller explicitly wants a raw source.
+    if (!opts.asSource) {
+        const looksHtmlName = /\.html?$/i.test(opts.file);
+        let looksHtmlContent = false;
+        try {
+            const head = readFileSync(opts.file, "utf8").slice(0, 512);
+            looksHtmlContent = /^\s*(<!doctype html|<html[\s>])/i.test(head);
+        }
+        catch {
+            // Unreadable as text (binary) — not an HTML page.
+        }
+        if (looksHtmlName || looksHtmlContent) {
+            throw new Error("This looks like a Page (a full HTML document). Pages live in the area's Pages tab and are published with:\n" +
+                "  dcli brain share --area <areaId> --title \"…\" --file " + opts.file + "\n" +
+                "Pass --as-source only if you really want the raw HTML stored as a source file.");
+        }
+    }
     output(await getClient().uploadBrainSource({
         areaId: opts.area,
         path: opts.file,
@@ -328,6 +349,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 CHANGED Viewed

@@ -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.1",
   description: "CLI for the Day of Week AgTech platform \u2014 read data and submit proposals for review",
   license: "MIT",
   type: "module",
@@ -5401,10 +5435,25 @@ brainSource.command("get <uri>").description("Read source metadata and derived t
   if (source.areaId !== parsed.areaId) throw new Error("Server returned a mismatched area");
   output(source);
 });
-brainSource.command("upload").description("Upload an original file or meeting recording").requiredOption("--area <areaId>", "Destination area").requiredOption("--file <path>", "File to upload").option("--mime <mimeType>", "MIME type; inferred from extension when omitted").option("--meeting", "Mark this source as a recorded meeting").option("--consent-ack", "Confirm recorded participants were informed and consented").action(async (opts) => {
+brainSource.command("upload").description("Upload an original file or meeting recording").requiredOption("--area <areaId>", "Destination area").requiredOption("--file <path>", "File to upload").option("--mime <mimeType>", "MIME type; inferred from extension when omitted").option("--meeting", "Mark this source as a recorded meeting").option("--consent-ack", "Confirm recorded participants were informed and consented").option("--as-source", "Store an HTML document as a raw source instead of publishing it as a Page").action(async (opts) => {
   if (opts.meeting && !opts.consentAck) {
     throw new Error("--consent-ack is required: you are attesting that recorded participants were informed and consented");
   }
+  if (!opts.asSource) {
+    const looksHtmlName = /\.html?$/i.test(opts.file);
+    let looksHtmlContent = false;
+    try {
+      const head = (0, import_node_fs8.readFileSync)(opts.file, "utf8").slice(0, 512);
+      looksHtmlContent = /^\s*(<!doctype html|<html[\s>])/i.test(head);
+    } catch {
+    }
+    if (looksHtmlName || looksHtmlContent) {
+      throw new Error(
+        `This looks like a Page (a full HTML document). Pages live in the area's Pages tab and are published with:
+  dcli brain share --area <areaId> --title "\u2026" --file ` + opts.file + "\nPass --as-source only if you really want the raw HTML stored as a source file."
+      );
+    }
+  }
   output(await getClient().uploadBrainSource({
     areaId: opts.area,
     path: opts.file,
@@ -5441,6 +5490,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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

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