feat(files): add workflow-backed HTML dashboards

Author: TheodoreSpeaks

apps/docs/content/docs/cli/files.mdx

@@ -38,6 +38,7 @@ sim files create [options]
 
 | Option | Required | Description |
 | --- | --- | --- |
+| `--workflow-ids <json\|@file>` | No | Deployed workflows in this workspace that the HTML document may call. (JSON, or @path / @- to read a file or stdin). |
 | `--name <value>` | Yes | File name, including its extension. Path separators and dot segments are rejected. |
 | `--content-type <value>` | No | MIME type. When omitted, it is inferred from the file extension. |
 | `--folder <value>` | No | Folder path as shown in the app; the leading / is optional. |
@@ -502,6 +503,40 @@ sim files read <fileId> [options]
 
 </CommandTable>
 
+## Get file workflow result
+
+```bash
+sim files workflows get <fileId> <workflowId>
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `fileId` | Yes | HTML file identifier. |
+| `workflowId` | Yes | Workflow ID configured in the file metadata. |
+
+</CommandTable>
+
+## Run file workflow
+
+```bash
+sim files workflows create <fileId> <workflowId>
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `fileId` | Yes | HTML file identifier. |
+| `workflowId` | Yes | Workflow ID configured in the file metadata. |
+
+</CommandTable>
+
 ## Rename a file
 
 ```bash
@@ -619,6 +654,32 @@ sim files set-content <fileId> [options]
 
 </CommandTable>
 
+## Update file metadata
+
+```bash
+sim files metadata update <fileId> [options]
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `fileId` | Yes | HTML file identifier. |
+
+</CommandTable>
+
+**Options**
+
+<CommandTable>
+
+| Option | Required | Description |
+| --- | --- | --- |
+| `--workflow-ids <json\|@file>` | Yes | Replace the workflows this HTML file may call. Send an empty array to remove all dependencies. Sharing exposes these calls to the file audience. (JSON, or @path / @- to read a file or stdin). |
+
+</CommandTable>
+
 ## Upload a file to the workspace
 
 ```bash

apps/docs/content/docs/cli/reference.mdx

@@ -761,6 +761,7 @@ sim files create [options]
 
 | Option | Required | Description |
 | --- | --- | --- |
+| `--workflow-ids <json\|@file>` | No | Deployed workflows in this workspace that the HTML document may call. (JSON, or @path / @- to read a file or stdin). |
 | `--name <value>` | Yes | File name, including its extension. Path separators and dot segments are rejected. |
 | `--content-type <value>` | No | MIME type. When omitted, it is inferred from the file extension. |
 | `--folder <value>` | No | Folder path as shown in the app; the leading / is optional. |
@@ -1261,6 +1262,44 @@ sim files read <fileId> [options]
 
 </CommandTable>
 
+### sim files workflows get
+
+Get File Workflow Result
+
+```bash
+sim files workflows get <fileId> <workflowId>
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `fileId` | Yes | HTML file identifier. |
+| `workflowId` | Yes | Workflow ID configured in the file metadata. |
+
+</CommandTable>
+
+### sim files workflows create
+
+Run File Workflow
+
+```bash
+sim files workflows create <fileId> <workflowId>
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `fileId` | Yes | HTML file identifier. |
+| `workflowId` | Yes | Workflow ID configured in the file metadata. |
+
+</CommandTable>
+
 ### sim files rename
 
 Rename a file
@@ -1388,6 +1427,34 @@ sim files set-content <fileId> [options]
 
 </CommandTable>
 
+### sim files metadata update
+
+Update File Metadata
+
+```bash
+sim files metadata update <fileId> [options]
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `fileId` | Yes | HTML file identifier. |
+
+</CommandTable>
+
+**Options**
+
+<CommandTable>
+
+| Option | Required | Description |
+| --- | --- | --- |
+| `--workflow-ids <json\|@file>` | Yes | Replace the workflows this HTML file may call. Send an empty array to remove all dependencies. Sharing exposes these calls to the file audience. (JSON, or @path / @- to read a file or stdin). |
+
+</CommandTable>
+
 ### sim files upload
 
 Upload a file to the workspace