@contrail/cli 3.6.0-alpha-8-alpha.2a57edb → 3.6.0-alpha-8-alpha.afa500a

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @contrail/cli
 $ contrail COMMAND
 running command...
 $ contrail (--version)
-@contrail/cli/3.6.0-alpha-8-alpha.2a57edb linux-x64 node-v24.21.0
+@contrail/cli/3.6.0-alpha-8-alpha.afa500a linux-x64 node-v24.21.0
 $ contrail --help [COMMAND]
 USAGE
   $ contrail COMMAND
@@ -696,10 +696,10 @@ ARGUMENTS
 FLAGS
   -F, --force                      Force update without validation. Internal use only
   -S, --skipHydrateRelationships   Skip hydrating relationships when updating the entity
-  -d, --dryRun                     If true, does not update the entities but simulates the update
+  -d, --dryRun                     If true, does not create the entity but simulates the creation
   -e, --alwaysConfirmEnv=<option>  [default: true] The Environment variables
                                    <options: true|false>
-  -i, --inputFile=<value>          A file with a JSON array of {id, ...} objects; each object is one entity to update.
+  -i, --inputFile=<value>          File containing properties to update the entity (optional)
   -l, --logLevel=<option>          The Log Level
                                    <options: error|warn|info|debug>
   --apiVersion=<option>            Api-Version header to send; selects the V1 or V2 variant of the endpoint

package/dist/commands/entities/create.js

@@ -290,6 +290,8 @@ class CreateEntity extends basecommand_1.BaseCommand {
     }
 }
 exports.default = CreateEntity;
+// Every row is attempted; a failed row never stops the run. The summary pairs
+// each failed input with its error so the failed rows can be retried as-is.
 function summarizeSettledCreates(inputs, settled) {
     const created = [];
     const failed = [];
@@ -536,7 +538,9 @@ function castValueToPropertyType(value, propertyType) {
             if (Array.isArray(value)) {
                 return value;
             }
-            // the old comma syntax parses as one literal value; warn instead of guessing at a split
+            // Migration hazard: the old comma syntax parses as one string with a
+            // comma in it. Warn with the repeated-key equivalent instead of
+            // guessing at a split.
             if (typeof value === 'string' && value.includes(',')) {
                 console.error(`Value "${value}" for a multi-value property contains a comma and is treated as one literal value. To pass several values, repeat the key: slug=${value
                     .split(',')

package/dist/commands/entities/create.spec.js

@@ -333,6 +333,8 @@ describe('Entity Creation E2E Happy Path', () => {
                 const propertySpecs = (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)([
                     'roles=option',
                 ]);
+                // a single roles value stays scalar at the parse layer and is
+                // normalized to an array where it is consumed
                 const roles = [].concat(propertySpecs.get('roles'));
                 // Test that property level matching works with specified roles
                 expect((0, create_1.doesPropertyLevelMatchRole)(types_1.PropertyLevel.OPTION, roles[0])).toBe(true);

package/dist/commands/entities/update.js

@@ -27,13 +27,13 @@ class UpdateEntity extends basecommand_1.BaseCommand {
         }),
         dryRun: core_1.Flags.boolean({
             char: 'd',
-            description: 'If true, does not update the entities but simulates the update',
+            description: 'If true, does not create the entity but simulates the creation',
             required: false,
             default: false,
         }),
         inputFile: core_1.Flags.string({
             char: 'i',
-            description: 'A file with a JSON array of {id, ...} objects; each object is one entity to update.',
+            description: 'File containing properties to update the entity (optional)',
             required: false,
         }),
         force: core_1.Flags.boolean({
@@ -123,6 +123,8 @@ class UpdateEntity extends basecommand_1.BaseCommand {
     }
 }
 exports.default = UpdateEntity;
+// Every row is attempted; a failed row never stops the run. The summary pairs
+// each failed id with its error so the failed rows can be retried.
 function summarizeSettledUpdates(inputs, settled, skipped) {
     const updated = [];
     const failed = [];

package/dist/helpers/propertySpecifications/propertySpecifications.js

@@ -68,8 +68,7 @@ function parsePropertySpecificationsIntoMap(propertySpecifications) {
             // ids is the one comma-split exception: it is a list of ids by definition
             // and ids never contain commas.
             const idsArray = value.split(',').map((id) => id.trim());
-            const existingIds = propertySpecBySlug.get(slug);
-            propertySpecBySlug.set(slug, Array.isArray(existingIds) ? [...existingIds, ...idsArray] : idsArray);
+            propertySpecBySlug.set(slug, idsArray);
             continue;
         }
         const existing = propertySpecBySlug.get(slug);

package/dist/helpers/propertySpecifications/propertySpecifications.spec.js

@@ -190,11 +190,6 @@ describe('parsePropertySpecificationsIntoMap', () => {
         expect(result.get('ids')).toEqual(['1', '2', '3']);
         expect(result.get('name')).toBe('Test');
     });
-    it('should accumulate repeated ids keys', () => {
-        const specs = ['ids=1,2', 'ids=3'];
-        const result = (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(specs);
-        expect(result.get('ids')).toEqual(['1', '2', '3']);
-    });
     it('should handle ids as single value', () => {
         const specs = ['ids=123'];
         const result = (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(specs);

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.6.0-alpha-8-alpha.2a57edb",
+  "version": "3.6.0-alpha-8-alpha.afa500a",
   "commands": {
     "app:create": {
       "id": "app:create",
@@ -1077,7 +1077,7 @@
           "name": "dryRun",
           "type": "boolean",
           "char": "d",
-          "description": "If true, does not update the entities but simulates the update",
+          "description": "If true, does not create the entity but simulates the creation",
           "required": false,
           "allowNo": false
         },
@@ -1085,7 +1085,7 @@
           "name": "inputFile",
           "type": "option",
           "char": "i",
-          "description": "A file with a JSON array of {id, ...} objects; each object is one entity to update.",
+          "description": "File containing properties to update the entity (optional)",
           "required": false,
           "multiple": false
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/cli",
-  "version": "3.6.0-alpha-8-alpha.2a57edb",
+  "version": "3.6.0-alpha-8-alpha.afa500a",
   "description": "VibeIQ's Contrail Platform CLI.",
   "bin": {
     "contrail-cli": "./bin/run",