buildx-cli 1.8.29 → 1.8.31

package/README.md

@@ -59,6 +59,16 @@ yarn start --help
    npx buildx-cli function:pull --project-id <project-id>
    ```
 
+6. **Pull AI functions:**
+   ```bash
+   npx buildx-cli ai-function:pull --project-id <project-id>
+   ```
+
+7. **Pull templates:**
+   ```bash
+   npx buildx-cli template:pull --project-id <project-id>
+   ```
+
 ## Configuration
 
 ### Method 1: Interactive Setup
@@ -532,10 +542,22 @@ Field annotations (JSDoc in `types.ts`) are supported:
 - `@bx.required` or `@bx.required false`
 - `@bx.ref <collection_id_or_enum_key>`
 - `@bx.choices value1:Label 1|value2:Label 2` (for `Choices`/`MultipleChoices`)
+- `@bx.type <SchemaType>` (force schema field type, useful for unions)
+- `@bx.default <json>`
+- `@bx.format <json_or_string>`
+- `@bx.validate <json_or_string>`
+- `@bx.props <json-object>` (merge custom keys into `propertiesScheme`)
 
 System-managed fields:
 - `createdAt`, `updatedAt`, `createdBy`, `updatedBy` in `types.ts` are ignored by convert output and never synced back
 
+Embedded object fidelity:
+- inline object/list members are restored as structured `children` (not collapsed to `item: Text`).
+- nested relation refs are normalized to collection IDs (for example `Partial<Workflows>` -> `workflows`).
+- when merging with base `collections.json`, nested child metadata is preserved by child name when possible.
+- dynamic object/list fallback stays as `BxObject` / `BxList` at type layer and `Object` / `List` in collection schema layer.
+- temporary compatibility: `string[]` / `BxText[]` converts to `MultipleChoices` instead of generic `List`.
+
 Example:
 ```ts
 export type Employees = {
@@ -760,6 +782,101 @@ Key options:
 npx buildx-cli function:alias:set process-order canary r15 --project-id hello-world
 ```
 
+### AI Function Commands
+
+#### `ai-function:pull`
+Pulls AI function rows from `buildx_ai_functions` (fallback compatibility: `buildx_ai_function`).
+
+Writes:
+- `buildx/ai-functions/functions.json`
+- `buildx/ai-functions/functions.manifest.json`
+
+Key options:
+- `-p, --project-id <id>`
+- `-t, --target-dir <path>`
+- `--data-file <path>` (when no `--target-dir`)
+- `--manifest-file <path>` (when no `--target-dir`)
+- `--filter <pattern...>`
+- `--dry-run`
+
+```bash
+npx buildx-cli ai-function:pull --project-id hello-world
+npx buildx-cli ai-function:pull --project-id hello-world --target-dir ./.sandbox/buildx-cli
+```
+
+#### `ai-function:push`
+Pushes local AI function JSON back to `buildx_ai_functions` (fallback compatibility: `buildx_ai_function`).
+
+Reads:
+- `buildx/ai-functions/functions.json`
+- `buildx/ai-functions/functions.manifest.json` (for drift detection)
+
+Behavior:
+- checks remote drift against local manifest baseline
+- supports push-by-name and wildcard filter
+- skips missing remote row unless `--allow-create`
+
+Key options:
+- `-p, --project-id <id>`
+- `-t, --target-dir <path>`
+- `--data-file <path>` (when no `--target-dir`)
+- `--manifest-file <path>` (when no `--target-dir`)
+- `-n, --name <function-name>`
+- `--filter <pattern...>`
+- `--allow-create`
+- `--dry-run`
+- `-f, --force`
+
+```bash
+npx buildx-cli ai-function:push --project-id hello-world --dry-run
+npx buildx-cli ai-function:push --project-id hello-world --name summarize_order --force
+```
+
+#### `ai-function:diff`
+Diffs local AI functions against remote collection.
+
+Output markers:
+- `= same`
+- `~ changed`
+- `+ local-only`
+- `- remote-only`
+- `! remote-drift`
+
+```bash
+npx buildx-cli ai-function:diff --project-id hello-world
+```
+
+### Template Commands
+
+#### `template:pull`
+Pulls templates from `buildx_templates`.
+
+Writes:
+- `buildx/templates/templates.json`
+- `buildx/templates/templates.manifest.json`
+
+```bash
+npx buildx-cli template:pull --project-id hello-world
+```
+
+#### `template:push`
+Pushes local templates JSON back to `buildx_templates`.
+
+Reads:
+- `buildx/templates/templates.json`
+- `buildx/templates/templates.manifest.json` (for drift detection)
+
+```bash
+npx buildx-cli template:push --project-id hello-world --dry-run
+```
+
+#### `template:diff`
+Diffs local templates against remote `buildx_templates`.
+
+```bash
+npx buildx-cli template:diff --project-id hello-world
+```
+
 #### `function:invoke <function-name>`
 Invokes function with optional `revision` or `alias`.
 

package/dist/README.md

@@ -59,6 +59,16 @@ yarn start --help
    npx buildx-cli function:pull --project-id <project-id>
    ```
 
+6. **Pull AI functions:**
+   ```bash
+   npx buildx-cli ai-function:pull --project-id <project-id>
+   ```
+
+7. **Pull templates:**
+   ```bash
+   npx buildx-cli template:pull --project-id <project-id>
+   ```
+
 ## Configuration
 
 ### Method 1: Interactive Setup
@@ -532,10 +542,22 @@ Field annotations (JSDoc in `types.ts`) are supported:
 - `@bx.required` or `@bx.required false`
 - `@bx.ref <collection_id_or_enum_key>`
 - `@bx.choices value1:Label 1|value2:Label 2` (for `Choices`/`MultipleChoices`)
+- `@bx.type <SchemaType>` (force schema field type, useful for unions)
+- `@bx.default <json>`
+- `@bx.format <json_or_string>`
+- `@bx.validate <json_or_string>`
+- `@bx.props <json-object>` (merge custom keys into `propertiesScheme`)
 
 System-managed fields:
 - `createdAt`, `updatedAt`, `createdBy`, `updatedBy` in `types.ts` are ignored by convert output and never synced back
 
+Embedded object fidelity:
+- inline object/list members are restored as structured `children` (not collapsed to `item: Text`).
+- nested relation refs are normalized to collection IDs (for example `Partial<Workflows>` -> `workflows`).
+- when merging with base `collections.json`, nested child metadata is preserved by child name when possible.
+- dynamic object/list fallback stays as `BxObject` / `BxList` at type layer and `Object` / `List` in collection schema layer.
+- temporary compatibility: `string[]` / `BxText[]` converts to `MultipleChoices` instead of generic `List`.
+
 Example:
 ```ts
 export type Employees = {
@@ -760,6 +782,101 @@ Key options:
 npx buildx-cli function:alias:set process-order canary r15 --project-id hello-world
 ```
 
+### AI Function Commands
+
+#### `ai-function:pull`
+Pulls AI function rows from `buildx_ai_functions` (fallback compatibility: `buildx_ai_function`).
+
+Writes:
+- `buildx/ai-functions/functions.json`
+- `buildx/ai-functions/functions.manifest.json`
+
+Key options:
+- `-p, --project-id <id>`
+- `-t, --target-dir <path>`
+- `--data-file <path>` (when no `--target-dir`)
+- `--manifest-file <path>` (when no `--target-dir`)
+- `--filter <pattern...>`
+- `--dry-run`
+
+```bash
+npx buildx-cli ai-function:pull --project-id hello-world
+npx buildx-cli ai-function:pull --project-id hello-world --target-dir ./.sandbox/buildx-cli
+```
+
+#### `ai-function:push`
+Pushes local AI function JSON back to `buildx_ai_functions` (fallback compatibility: `buildx_ai_function`).
+
+Reads:
+- `buildx/ai-functions/functions.json`
+- `buildx/ai-functions/functions.manifest.json` (for drift detection)
+
+Behavior:
+- checks remote drift against local manifest baseline
+- supports push-by-name and wildcard filter
+- skips missing remote row unless `--allow-create`
+
+Key options:
+- `-p, --project-id <id>`
+- `-t, --target-dir <path>`
+- `--data-file <path>` (when no `--target-dir`)
+- `--manifest-file <path>` (when no `--target-dir`)
+- `-n, --name <function-name>`
+- `--filter <pattern...>`
+- `--allow-create`
+- `--dry-run`
+- `-f, --force`
+
+```bash
+npx buildx-cli ai-function:push --project-id hello-world --dry-run
+npx buildx-cli ai-function:push --project-id hello-world --name summarize_order --force
+```
+
+#### `ai-function:diff`
+Diffs local AI functions against remote collection.
+
+Output markers:
+- `= same`
+- `~ changed`
+- `+ local-only`
+- `- remote-only`
+- `! remote-drift`
+
+```bash
+npx buildx-cli ai-function:diff --project-id hello-world
+```
+
+### Template Commands
+
+#### `template:pull`
+Pulls templates from `buildx_templates`.
+
+Writes:
+- `buildx/templates/templates.json`
+- `buildx/templates/templates.manifest.json`
+
+```bash
+npx buildx-cli template:pull --project-id hello-world
+```
+
+#### `template:push`
+Pushes local templates JSON back to `buildx_templates`.
+
+Reads:
+- `buildx/templates/templates.json`
+- `buildx/templates/templates.manifest.json` (for drift detection)
+
+```bash
+npx buildx-cli template:push --project-id hello-world --dry-run
+```
+
+#### `template:diff`
+Diffs local templates against remote `buildx_templates`.
+
+```bash
+npx buildx-cli template:diff --project-id hello-world
+```
+
 #### `function:invoke <function-name>`
 Invokes function with optional `revision` or `alias`.