npm - @dayofweek/dcli - Versions diffs - 1.9.0 → 1.10.0 - Mend

@dayofweek/dcli 1.9.0 → 1.10.0

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,
@@ -409,6 +430,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")

package/dist/bundle/dcli.cjs CHANGED Viewed

@@ -4518,6 +4518,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 +5165,7 @@ var import_promises4 = require("node:readline/promises");
 // package.json
 var package_default = {
   name: "@dayofweek/dcli",
-  version: "1.9.0",
+  version: "1.10.0",
   description: "CLI for the Day of Week AgTech platform \u2014 read data and submit proposals for review",
   license: "MIT",
   type: "module",
@@ -5435,10 +5456,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,
@@ -5517,6 +5553,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();

package/dist/client.d.ts CHANGED Viewed

@@ -251,6 +251,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 CHANGED Viewed

@@ -378,6 +378,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 CHANGED Viewed

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