buildx-cli 1.8.28 → 1.8.30

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 (6) hide show
  1. package/README.md +112 -0
  2. package/dist/README.md +112 -0
  3. package/dist/index.cjs +4 -4
  4. package/dist/index.js +4 -4
  5. package/dist/package.json +1 -1
  6. package/package.json +7 -1
package/README.md CHANGED
@@ -59,6 +59,16 @@ yarn start --help
59
59
  npx buildx-cli function:pull --project-id <project-id>
60
60
  ```
61
61
 
62
+ 6. **Pull AI functions:**
63
+ ```bash
64
+ npx buildx-cli ai-function:pull --project-id <project-id>
65
+ ```
66
+
67
+ 7. **Pull templates:**
68
+ ```bash
69
+ npx buildx-cli template:pull --project-id <project-id>
70
+ ```
71
+
62
72
  ## Configuration
63
73
 
64
74
  ### Method 1: Interactive Setup
@@ -102,6 +112,13 @@ When running `config:setup`, CLI auto-detects these values and asks for confirma
102
112
  npx buildx-cli config:setup --endpoint https://api.example.com --api-key your-api-key
103
113
  ```
104
114
 
115
+ Per-command endpoint override:
116
+
117
+ - Many commands support `-u, --api-url <url>`.
118
+ - `--api-url` overrides only the current command request target.
119
+ - Saved config is not changed.
120
+ - API key and auth are still resolved from existing config/env.
121
+
105
122
  ### View Current Configuration
106
123
  ```bash
107
124
  npx buildx-cli config:show
@@ -753,6 +770,101 @@ Key options:
753
770
  npx buildx-cli function:alias:set process-order canary r15 --project-id hello-world
754
771
  ```
755
772
 
773
+ ### AI Function Commands
774
+
775
+ #### `ai-function:pull`
776
+ Pulls AI function rows from `buildx_ai_functions` (fallback compatibility: `buildx_ai_function`).
777
+
778
+ Writes:
779
+ - `buildx/ai-functions/functions.json`
780
+ - `buildx/ai-functions/functions.manifest.json`
781
+
782
+ Key options:
783
+ - `-p, --project-id <id>`
784
+ - `-t, --target-dir <path>`
785
+ - `--data-file <path>` (when no `--target-dir`)
786
+ - `--manifest-file <path>` (when no `--target-dir`)
787
+ - `--filter <pattern...>`
788
+ - `--dry-run`
789
+
790
+ ```bash
791
+ npx buildx-cli ai-function:pull --project-id hello-world
792
+ npx buildx-cli ai-function:pull --project-id hello-world --target-dir ./.sandbox/buildx-cli
793
+ ```
794
+
795
+ #### `ai-function:push`
796
+ Pushes local AI function JSON back to `buildx_ai_functions` (fallback compatibility: `buildx_ai_function`).
797
+
798
+ Reads:
799
+ - `buildx/ai-functions/functions.json`
800
+ - `buildx/ai-functions/functions.manifest.json` (for drift detection)
801
+
802
+ Behavior:
803
+ - checks remote drift against local manifest baseline
804
+ - supports push-by-name and wildcard filter
805
+ - skips missing remote row unless `--allow-create`
806
+
807
+ Key options:
808
+ - `-p, --project-id <id>`
809
+ - `-t, --target-dir <path>`
810
+ - `--data-file <path>` (when no `--target-dir`)
811
+ - `--manifest-file <path>` (when no `--target-dir`)
812
+ - `-n, --name <function-name>`
813
+ - `--filter <pattern...>`
814
+ - `--allow-create`
815
+ - `--dry-run`
816
+ - `-f, --force`
817
+
818
+ ```bash
819
+ npx buildx-cli ai-function:push --project-id hello-world --dry-run
820
+ npx buildx-cli ai-function:push --project-id hello-world --name summarize_order --force
821
+ ```
822
+
823
+ #### `ai-function:diff`
824
+ Diffs local AI functions against remote collection.
825
+
826
+ Output markers:
827
+ - `= same`
828
+ - `~ changed`
829
+ - `+ local-only`
830
+ - `- remote-only`
831
+ - `! remote-drift`
832
+
833
+ ```bash
834
+ npx buildx-cli ai-function:diff --project-id hello-world
835
+ ```
836
+
837
+ ### Template Commands
838
+
839
+ #### `template:pull`
840
+ Pulls templates from `buildx_templates`.
841
+
842
+ Writes:
843
+ - `buildx/templates/templates.json`
844
+ - `buildx/templates/templates.manifest.json`
845
+
846
+ ```bash
847
+ npx buildx-cli template:pull --project-id hello-world
848
+ ```
849
+
850
+ #### `template:push`
851
+ Pushes local templates JSON back to `buildx_templates`.
852
+
853
+ Reads:
854
+ - `buildx/templates/templates.json`
855
+ - `buildx/templates/templates.manifest.json` (for drift detection)
856
+
857
+ ```bash
858
+ npx buildx-cli template:push --project-id hello-world --dry-run
859
+ ```
860
+
861
+ #### `template:diff`
862
+ Diffs local templates against remote `buildx_templates`.
863
+
864
+ ```bash
865
+ npx buildx-cli template:diff --project-id hello-world
866
+ ```
867
+
756
868
  #### `function:invoke <function-name>`
757
869
  Invokes function with optional `revision` or `alias`.
758
870
 
package/dist/README.md CHANGED
@@ -59,6 +59,16 @@ yarn start --help
59
59
  npx buildx-cli function:pull --project-id <project-id>
60
60
  ```
61
61
 
62
+ 6. **Pull AI functions:**
63
+ ```bash
64
+ npx buildx-cli ai-function:pull --project-id <project-id>
65
+ ```
66
+
67
+ 7. **Pull templates:**
68
+ ```bash
69
+ npx buildx-cli template:pull --project-id <project-id>
70
+ ```
71
+
62
72
  ## Configuration
63
73
 
64
74
  ### Method 1: Interactive Setup
@@ -102,6 +112,13 @@ When running `config:setup`, CLI auto-detects these values and asks for confirma
102
112
  npx buildx-cli config:setup --endpoint https://api.example.com --api-key your-api-key
103
113
  ```
104
114
 
115
+ Per-command endpoint override:
116
+
117
+ - Many commands support `-u, --api-url <url>`.
118
+ - `--api-url` overrides only the current command request target.
119
+ - Saved config is not changed.
120
+ - API key and auth are still resolved from existing config/env.
121
+
105
122
  ### View Current Configuration
106
123
  ```bash
107
124
  npx buildx-cli config:show
@@ -753,6 +770,101 @@ Key options:
753
770
  npx buildx-cli function:alias:set process-order canary r15 --project-id hello-world
754
771
  ```
755
772
 
773
+ ### AI Function Commands
774
+
775
+ #### `ai-function:pull`
776
+ Pulls AI function rows from `buildx_ai_functions` (fallback compatibility: `buildx_ai_function`).
777
+
778
+ Writes:
779
+ - `buildx/ai-functions/functions.json`
780
+ - `buildx/ai-functions/functions.manifest.json`
781
+
782
+ Key options:
783
+ - `-p, --project-id <id>`
784
+ - `-t, --target-dir <path>`
785
+ - `--data-file <path>` (when no `--target-dir`)
786
+ - `--manifest-file <path>` (when no `--target-dir`)
787
+ - `--filter <pattern...>`
788
+ - `--dry-run`
789
+
790
+ ```bash
791
+ npx buildx-cli ai-function:pull --project-id hello-world
792
+ npx buildx-cli ai-function:pull --project-id hello-world --target-dir ./.sandbox/buildx-cli
793
+ ```
794
+
795
+ #### `ai-function:push`
796
+ Pushes local AI function JSON back to `buildx_ai_functions` (fallback compatibility: `buildx_ai_function`).
797
+
798
+ Reads:
799
+ - `buildx/ai-functions/functions.json`
800
+ - `buildx/ai-functions/functions.manifest.json` (for drift detection)
801
+
802
+ Behavior:
803
+ - checks remote drift against local manifest baseline
804
+ - supports push-by-name and wildcard filter
805
+ - skips missing remote row unless `--allow-create`
806
+
807
+ Key options:
808
+ - `-p, --project-id <id>`
809
+ - `-t, --target-dir <path>`
810
+ - `--data-file <path>` (when no `--target-dir`)
811
+ - `--manifest-file <path>` (when no `--target-dir`)
812
+ - `-n, --name <function-name>`
813
+ - `--filter <pattern...>`
814
+ - `--allow-create`
815
+ - `--dry-run`
816
+ - `-f, --force`
817
+
818
+ ```bash
819
+ npx buildx-cli ai-function:push --project-id hello-world --dry-run
820
+ npx buildx-cli ai-function:push --project-id hello-world --name summarize_order --force
821
+ ```
822
+
823
+ #### `ai-function:diff`
824
+ Diffs local AI functions against remote collection.
825
+
826
+ Output markers:
827
+ - `= same`
828
+ - `~ changed`
829
+ - `+ local-only`
830
+ - `- remote-only`
831
+ - `! remote-drift`
832
+
833
+ ```bash
834
+ npx buildx-cli ai-function:diff --project-id hello-world
835
+ ```
836
+
837
+ ### Template Commands
838
+
839
+ #### `template:pull`
840
+ Pulls templates from `buildx_templates`.
841
+
842
+ Writes:
843
+ - `buildx/templates/templates.json`
844
+ - `buildx/templates/templates.manifest.json`
845
+
846
+ ```bash
847
+ npx buildx-cli template:pull --project-id hello-world
848
+ ```
849
+
850
+ #### `template:push`
851
+ Pushes local templates JSON back to `buildx_templates`.
852
+
853
+ Reads:
854
+ - `buildx/templates/templates.json`
855
+ - `buildx/templates/templates.manifest.json` (for drift detection)
856
+
857
+ ```bash
858
+ npx buildx-cli template:push --project-id hello-world --dry-run
859
+ ```
860
+
861
+ #### `template:diff`
862
+ Diffs local templates against remote `buildx_templates`.
863
+
864
+ ```bash
865
+ npx buildx-cli template:diff --project-id hello-world
866
+ ```
867
+
756
868
  #### `function:invoke <function-name>`
757
869
  Invokes function with optional `revision` or `alias`.
758
870