@carthooks/arcubase-cli 0.1.23 → 0.1.24

package/bundle/arcubase-admin.mjs

@@ -18360,6 +18360,33 @@ var helpExamplesIndex = {
       }
     ]
   },
+  "admin.dashboard.update-options": {
+    "command": [
+      "dashboard",
+      "update-options"
+    ],
+    "examples": [
+      {
+        "title": "make a dashboard visible to one Arcubase user",
+        "body": {
+          "changed": [
+            "users"
+          ],
+          "users": [
+            {
+              "type": "user",
+              "id": 2188889901
+            }
+          ]
+        },
+        "notes": [
+          "dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users",
+          "use the currentSpeaker.arcubaseUserId value for the current human speaker",
+          "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"
+        ]
+      }
+    ]
+  },
   "admin.widget.create": {
     "command": [
       "widget",

package/bundle/arcubase.mjs

@@ -18360,6 +18360,33 @@ var helpExamplesIndex = {
       }
     ]
   },
+  "admin.dashboard.update-options": {
+    "command": [
+      "dashboard",
+      "update-options"
+    ],
+    "examples": [
+      {
+        "title": "make a dashboard visible to one Arcubase user",
+        "body": {
+          "changed": [
+            "users"
+          ],
+          "users": [
+            {
+              "type": "user",
+              "id": 2188889901
+            }
+          ]
+        },
+        "notes": [
+          "dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users",
+          "use the currentSpeaker.arcubaseUserId value for the current human speaker",
+          "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"
+        ]
+      }
+    ]
+  },
   "admin.widget.create": {
     "command": [
       "widget",

package/dist/generated/help_examples.generated.d.ts

@@ -262,6 +262,20 @@ export declare const helpExamplesIndex: {
             readonly notes: readonly ["the request body is a top-level array", "do not wrap the array as {\"layout\":[...]}"];
         }];
     };
+    readonly "admin.dashboard.update-options": {
+        readonly command: readonly ["dashboard", "update-options"];
+        readonly examples: readonly [{
+            readonly title: "make a dashboard visible to one Arcubase user";
+            readonly body: {
+                readonly changed: readonly ["users"];
+                readonly users: readonly [{
+                    readonly type: "user";
+                    readonly id: 2188889901;
+                }];
+            };
+            readonly notes: readonly ["dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users", "use the currentSpeaker.arcubaseUserId value for the current human speaker", "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"];
+        }];
+    };
     readonly "admin.widget.create": {
         readonly command: readonly ["widget", "create"];
         readonly examples: readonly [{

package/dist/generated/help_examples.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help_examples.generated.d.ts","sourceRoot":"","sources":["../../src/generated/help_examples.generated.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2mBgF,CAAA"}
+{"version":3,"file":"help_examples.generated.d.ts","sourceRoot":"","sources":["../../src/generated/help_examples.generated.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsoBgF,CAAA"}

package/dist/generated/help_examples.generated.js

@@ -363,6 +363,33 @@ export const helpExamplesIndex = {
             }
         ]
     },
+    "admin.dashboard.update-options": {
+        "command": [
+            "dashboard",
+            "update-options"
+        ],
+        "examples": [
+            {
+                "title": "make a dashboard visible to one Arcubase user",
+                "body": {
+                    "changed": [
+                        "users"
+                    ],
+                    "users": [
+                        {
+                            "type": "user",
+                            "id": 2188889901
+                        }
+                    ]
+                },
+                "notes": [
+                    "dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users",
+                    "use the currentSpeaker.arcubaseUserId value for the current human speaker",
+                    "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"
+                ]
+            }
+        ]
+    },
     "admin.widget.create": {
         "command": [
             "widget",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carthooks/arcubase-cli",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Arcubase runtime CLI for admin and user command execution",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,8 +9,8 @@
     ".": "./dist/index.js"
   },
   "bin": {
-    "arcubase-admin": "./dist/bin/arcubase-admin.js",
-    "arcubase": "./dist/bin/arcubase.js"
+    "arcubase-admin": "dist/bin/arcubase-admin.js",
+    "arcubase": "dist/bin/arcubase.js"
   },
   "files": [
     "dist",

package/sdk-dist/docs/runtime-reference/dashboard.md

@@ -11,6 +11,14 @@ User dashboard discovery:
 
 Use `arcubase-admin dashboard list`, `arcubase-admin dashboard create`, `arcubase-admin dashboard get-options`, `arcubase-admin dashboard update-options`, `arcubase-admin dashboard update-layout`, and `arcubase-admin dashboard rename` to manage dashboards as an admin.
 
+Dashboard visibility:
+
+- A dashboard is user-visible only when its options include a matching user scope.
+- After `dashboard create`, call `dashboard update-options` with `{"changed":["users"],"users":[{"type":"user","id":<arcubaseUserId>}]}`
+  for the current or target Arcubase user.
+- For the current BotWorks human speaker, use `currentSpeaker.arcubaseUserId`; do not call organization lookup only to resolve yourself.
+- Before claiming a normal user can see a dashboard, run user-side `arcubase app get --app-id <app_id>` and require `dashboards[]` to include that dashboard.
+
 Dashboard title updates use body `{"name":"..."}`.
 
 Dashboard layout updates use a top-level JSON array of layout positions, not an object wrapper. Example:

package/sdk-dist/docs/runtime-reference/help-examples/admin/dashboard/update-options.json

@@ -0,0 +1,23 @@
+{
+  "scope": "admin",
+  "command": ["dashboard", "update-options"],
+  "examples": [
+    {
+      "title": "make a dashboard visible to one Arcubase user",
+      "body": {
+        "changed": ["users"],
+        "users": [
+          {
+            "type": "user",
+            "id": 2188889901
+          }
+        ]
+      },
+      "notes": [
+        "dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users",
+        "use the currentSpeaker.arcubaseUserId value for the current human speaker",
+        "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"
+      ]
+    }
+  ]
+}

package/sdk-dist/generated/help_examples.generated.ts

@@ -370,6 +370,33 @@ export const helpExamplesIndex = {
       }
     ]
   },
+  "admin.dashboard.update-options": {
+    "command": [
+      "dashboard",
+      "update-options"
+    ],
+    "examples": [
+      {
+        "title": "make a dashboard visible to one Arcubase user",
+        "body": {
+          "changed": [
+            "users"
+          ],
+          "users": [
+            {
+              "type": "user",
+              "id": 2188889901
+            }
+          ]
+        },
+        "notes": [
+          "dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users",
+          "use the currentSpeaker.arcubaseUserId value for the current human speaker",
+          "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"
+        ]
+      }
+    ]
+  },
   "admin.widget.create": {
     "command": [
       "widget",

package/src/generated/help_examples.generated.ts

@@ -370,6 +370,33 @@ export const helpExamplesIndex = {
       }
     ]
   },
+  "admin.dashboard.update-options": {
+    "command": [
+      "dashboard",
+      "update-options"
+    ],
+    "examples": [
+      {
+        "title": "make a dashboard visible to one Arcubase user",
+        "body": {
+          "changed": [
+            "users"
+          ],
+          "users": [
+            {
+              "type": "user",
+              "id": 2188889901
+            }
+          ]
+        },
+        "notes": [
+          "dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users",
+          "use the currentSpeaker.arcubaseUserId value for the current human speaker",
+          "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"
+        ]
+      }
+    ]
+  },
   "admin.widget.create": {
     "command": [
       "widget",

package/src/tests/help.test.ts

@@ -220,6 +220,17 @@ test('admin dashboard update-layout help-examples show top-level layout array',
   assert.match(out.text, /do not wrap the array/)
 })
 
+test('admin dashboard update-options help-examples show user visibility scope', async () => {
+  const out = await executeCLI('admin', ['dashboard', 'update-options', '--help-examples'], env as any, async () => new Response('{}'))
+  assert.equal(out.kind, 'help')
+  assert.match(out.text, /arcubase-admin dashboard update-options --help-examples/)
+  assert.match(out.text, /"changed":\["users"\]/)
+  assert.match(out.text, /"users":\[\{"type":"user","id":2188889901\}\]/)
+  assert.match(out.text, /currentSpeaker\.arcubaseUserId/)
+  assert.match(out.text, /verify from the user side with arcubase app get/)
+  assert.doesNotMatch(out.text, /"type":"member"/)
+})
+
 test('admin widget preview-data help-examples show chart query body without widget id', async () => {
   const out = await executeCLI('admin', ['widget', 'preview-data', '--help-examples'], env as any, async () => new Response('{}'))
   assert.equal(out.kind, 'help')