@contrail/cli 3.5.0-alpha-1 → 3.6.0-alpha-2

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @contrail/cli
 $ contrail COMMAND
 running command...
 $ contrail (--version)
-@contrail/cli/3.5.0-alpha-1 darwin-arm64 node-v22.19.0
+@contrail/cli/3.6.0-alpha-2 darwin-arm64 node-v22.19.0
 $ contrail --help [COMMAND]
 USAGE
   $ contrail COMMAND
@@ -682,6 +682,8 @@ DESCRIPTION
 
 EXAMPLES
   $ contrail entities update color 123 -- name=obsidian hex=000000
+
+  $ contrail entities update color 123 -- description= notes='""' data=null # Unset description, empty notes, null data
 ```
 
 ## `contrail file upload FILELOCATION CONTENTTYPE`

package/dist/auth/login.js

@@ -9,6 +9,7 @@ const config_1 = require("../helpers/config/config");
 const logger_1 = tslib_1.__importDefault(require("../logger"));
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_1 = tslib_1.__importDefault(require("fs"));
+const common_1 = require("../common");
 const CONFIGURATION = {
     userPoolId: 'us-east-1_qIaNZdUfm',
     clientId: process.env.CONTRAIL_COGNITO_CLIENT_ID || '7knkt34gfacbgd0ghnuspefdfg',
@@ -37,10 +38,21 @@ async function authUser() {
         };
         (0, sdk_1.setConfig)(sdk_1.Auth.config);
         try {
-            return await refreshCurrentUserOrg();
+            // hacky retry policy
+            return await refreshCurrentUserOrg().catch(async () => {
+                await (0, common_1.delay)(100);
+                return await refreshCurrentUserOrg().catch(async () => {
+                    await (0, common_1.delay)(1000);
+                    return await refreshCurrentUserOrg();
+                });
+            });
         }
         catch (e) {
-            logger_1.default.info('Token expired. Requesting auth credentials...');
+            if (isNetworkConnectionError(e)) {
+                logger_1.default.error("Encountered a network connection issue. Please ensure you're connected to the internet and try again");
+                process.exit(1);
+            }
+            logger_1.default.info(`Failed to refresh token: ${e}. Requesting auth credentials...`);
         }
     }
     return await authenticateWithUsernamePassword(config);
@@ -71,7 +83,8 @@ async function authenticateWithApiKey(config, apiKey, orgSlug) {
     };
     (0, sdk_1.setConfig)(sdk_1.Auth.config);
     await (0, sdk_1.getCurrentUser)();
-    return returnAndStoreConfig(sdk_1.Auth.config);
+    await (0, config_1.storeConfig)(sdk_1.Auth.config);
+    return Object.assign({}, sdk_1.Auth.config);
 }
 async function authenticateWithUsernamePassword(config) {
     const questions = [];
@@ -159,13 +172,14 @@ async function refreshCurrentUserOrg() {
             console.log('fetched new access token from refresh token', newVibeAccessToken);
         }
         catch (e) {
-            throw Error('Could not get refresh token');
+            throw Error(`Could not get refresh token: ${e}`);
         }
+        await (0, config_1.storeConfig)(sdk_1.Auth.config);
     }
     // TODO: To uncomment when telemetry backend is developed.
     // const current_Version = getVersionFromPackageJson();
     // await checkTelemetry(current_Version);
-    return returnAndStoreConfig(sdk_1.Auth.config);
+    return Object.assign({}, sdk_1.Auth.config);
 }
 async function getVibeAccessTokenFromCognitoAccessToken(cognitoAccessToken, apiGateway) {
     const url = `${apiGateway}/auth/cognito/`;
@@ -206,8 +220,7 @@ function getVersionFromPackageJson() {
     return packageJson.version;
 }
 exports.getVersionFromPackageJson = getVersionFromPackageJson;
-async function returnAndStoreConfig(config) {
-    const configCopy = Object.assign({}, config);
-    await (0, config_1.storeConfig)(configCopy);
-    return configCopy;
+function isNetworkConnectionError(e) {
+    const cause = e?.cause;
+    return cause?.code === 'ENOTFOUND' || cause?.code === 'ECONNREFUSED';
 }

package/dist/commands/app/extension/deploy.js

@@ -40,10 +40,12 @@ class DeployExtension extends basecommand_1.BaseCommand {
             await this.validateExtensionDeclaration(appDeclaration, extensionIdentifier);
             const extensionDir = this.getExtensionDirectory(extensionIdentifier);
             // 2. Package and upload extension
-            const createdPackage = await (0, extension_package_deployer_1.createExtensionPackage)(app.id, extensionDir, { debug: this.flags.debug });
+            const createdPackage = await (0, extension_package_deployer_1.createExtensionPackage)(app.id, extensionDir, {
+                debug: this.flags.debug,
+            });
             // 3. Poll until package is ready (timeout after 1 minute)
             const readyPackage = await this.pollUntilPackageIsReady(createdPackage);
-            logger_1.default.info("Extension package is ready...Checking for extension deployment");
+            logger_1.default.info('Extension package is ready...Checking for extension deployment');
             logger_1.default.debug(JSON.stringify(readyPackage, null, 2));
             const deployment = await this.pollUntilDeploymentIsReady(readyPackage.deploymentId);
             logger_1.default.info(`${chalk_1.default.green.bold('SUCCESS')} Extension package is ready.`);

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

@@ -288,7 +288,9 @@ describe('Entity Creation E2E Happy Path', () => {
             it('should throw error for invalid specifications', () => {
                 expect(() => (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(['invalid-spec'])).toThrow('Invalid property specification: invalid-spec');
                 expect(() => (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(['=value'])).toThrow('Invalid property specification: =value');
-                expect(() => (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(['key='])).toThrow('Invalid property specification: key=');
+                const result = (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(['key=']);
+                expect(result.get('key')).toBeUndefined();
+                expect(result.size).toBe(1);
             });
         });
         describe('isValidPropertySpecification', () => {
@@ -297,11 +299,11 @@ describe('Entity Creation E2E Happy Path', () => {
                 expect((0, propertySpecifications_1.isValidPropertySpecification)('id=123')).toBe(true);
                 expect((0, propertySpecifications_1.isValidPropertySpecification)('description=Long description with spaces')).toBe(true);
                 expect((0, propertySpecifications_1.isValidPropertySpecification)('roles=option,family')).toBe(true);
+                expect((0, propertySpecifications_1.isValidPropertySpecification)('key=')).toBe(true);
             });
-            it('should reject invalid property specifications', () => {
+            it('should reject most invalid property specifications', () => {
                 expect((0, propertySpecifications_1.isValidPropertySpecification)('invalid')).toBe(false);
                 expect((0, propertySpecifications_1.isValidPropertySpecification)('=')).toBe(false);
-                expect((0, propertySpecifications_1.isValidPropertySpecification)('key=')).toBe(false);
                 expect((0, propertySpecifications_1.isValidPropertySpecification)('=value')).toBe(false);
                 expect((0, propertySpecifications_1.isValidPropertySpecification)('')).toBe(false);
             });

package/dist/commands/entities/update.js

@@ -10,7 +10,10 @@ const propertySpecifications_1 = require("../../helpers/propertySpecifications/p
 const file_helpers_1 = require("../../helpers/file-helpers");
 class UpdateEntity extends basecommand_1.BaseCommand {
     static description = '(BETA) Update an entity';
-    static examples = ['contrail entities update color 123 -- name=obsidian hex=000000'];
+    static examples = [
+        'contrail entities update color 123 -- name=obsidian hex=000000',
+        'contrail entities update color 123 -- description= notes=\'""\' data=null # Unset description, empty notes, null data',
+    ];
     static flags = {
         ...basecommand_1.BaseCommand.baseFlags,
         skipHydrateRelationships: core_1.Flags.boolean({
@@ -70,20 +73,20 @@ class UpdateEntity extends basecommand_1.BaseCommand {
             acc[key] = value;
             return acc;
         }, {});
+        async function updateEntity(id) {
+            const promise = isDryRun
+                ? mockUpdateById(entityName, id, changes, { skipHydrateRelationships })
+                : updateEntityById(entityName, id, changes, { skipHydrateRelationships });
+            promise
+                .catch(() => {
+                results.idsFailedToUpdate.add(id);
+            })
+                .then(() => {
+                results.idsSuccessfullyUpdated.add(id);
+            });
+            return promise;
+        }
         try {
-            async function updateEntity(id) {
-                const promise = isDryRun
-                    ? mockUpdateById(entityName, id, changes, { skipHydrateRelationships })
-                    : updateEntityById(entityName, id, changes, { skipHydrateRelationships });
-                promise
-                    .catch(() => {
-                    results.idsFailedToUpdate.add(id);
-                })
-                    .then(() => {
-                    results.idsSuccessfullyUpdated.add(id);
-                });
-                return promise;
-            }
             const limit = (0, p_limit_1.default)(5); // Limit concurrency to 5
             const responses = await Promise.all(idsToUpdate.map((id) => limit(() => updateEntity(id))));
             const messagePrefix = isDryRun

package/dist/commands/types/uploadUsageInfo.js

@@ -115,8 +115,20 @@ async function uploadUsageInfoObjects(loadedUsageInfo) {
                     entityName: 'type-property-usage-info',
                     id: found.id,
                     object: {
-                        editable: loadedUI.editable,
-                        used: loadedUI.used,
+                        editable: loadedUI?.editable,
+                        used: loadedUI?.used,
+                        formulaFunction: loadedUI?.formulaFunction,
+                        validationFunction: loadedUI?.validationFunction,
+                        numberFormat: loadedUI?.numberFormat,
+                        defaultValue: loadedUI?.defaultValue,
+                        label: loadedUI?.label,
+                        required: loadedUI?.required,
+                        searchable: loadedUI?.searchable,
+                        isUniqueProperty: loadedUI?.isUniqueProperty,
+                        isUniquePropertyInFamily: loadedUI?.isUniquePropertyInFamily,
+                        copyBehavior: loadedUI?.copyBehavior,
+                        copyDefault: loadedUI?.copyDefault,
+                        propertyLevel: loadedUI?.propertyLevel,
                     },
                 });
             }

package/dist/helpers/app/app-deployer.js

@@ -107,6 +107,7 @@ class AppDeployer {
         if (appDeclaration?.accessGrants) {
             accessGrants = await app_template_parsers_1.AccessGrantsParser.buildAccessGrants(appDeclaration);
         }
+        // eslint-disable-next-line no-prototype-builtins
         if (appDeclaration.hasOwnProperty('dockerImageRef')) {
             throw new Error('Docker apps are no longer supported. Please use a node app.');
         }
@@ -201,7 +202,11 @@ async function createNodePackage(appIdentifier, debug, dryRun) {
         logger_1.default.info('Installing production dependencies done.');
         logger_1.default.info('Building package...');
         try {
-            child_process_1.default.execSync('npx tsc --outDir tmp/dist');
+            // Check for tsconfig.build.json first, fallback to tsconfig.json
+            const buildConfigPath = fs_1.default.existsSync('tsconfig.build.json')
+                ? 'tsconfig.build.json'
+                : 'tsconfig.json';
+            child_process_1.default.execSync(`npx tsc --project ${buildConfigPath} --outDir tmp/dist`);
         }
         catch (e) {
             logger_1.default.error(`${chalk_1.default.red.bold('APP')}      Failed to build package.`);
@@ -228,7 +233,7 @@ async function createNodePackage(appIdentifier, debug, dryRun) {
             return {};
         }
         logger_1.default.info('Uploading package to S3...');
-        let apps = await entitiesClient.get({ entityName: 'app' });
+        const apps = await entitiesClient.get({ entityName: 'app' });
         const thisApp = apps.find((x) => x.identifier === appIdentifier);
         if (!thisApp) {
             throw new Error('App not found');
@@ -238,8 +243,7 @@ async function createNodePackage(appIdentifier, debug, dryRun) {
             object: { appId: thisApp.id },
         });
         // upload an s3 object using a signed url with an https put request
-        const readStream = fs_1.default.readFileSync('tmp.zip');
-        const postBody = Buffer.from(readStream);
+        const postBody = fs_1.default.readFileSync('tmp.zip');
         // await axios.put(uploadUrlObject.signedUrl, postBody.toString());
         await axios_1.default.request({
             method: 'PUT',

package/dist/helpers/app/extension-package-deployer.js

@@ -119,7 +119,7 @@ async function createExtensionPackage(appId, extensionDir, options) {
     await uploadExtensionPackage(appExtensionPackage, tmpDir, options);
     logger_1.default.info(`${chalk_1.default.green.bold('COMPLETE')} Extension packaged and uploaded.`);
     if (options.debug) {
-        logger_1.default.debug("debug mode enabled. Not cleaning up tmp dir.");
+        logger_1.default.debug('debug mode enabled. Not cleaning up tmp dir.');
     }
     else {
         cleanUp(tmpDir);

package/dist/helpers/config/config.js

@@ -41,13 +41,13 @@ exports.initializeVibeIQConfig = initializeVibeIQConfig;
 async function readVibeIQConfig() {
     let fileContent;
     try {
-        fileContent = await (await node_fs_1.promises.readFile(configFileLocation)).toString();
+        fileContent = (await node_fs_1.promises.readFile(configFileLocation)).toString();
     }
     catch {
         logger_1.default.debug(`failed to open config file (${configFileLocation}) for reading.`);
         logger_1.default.debug('trying to initialize config file');
         await initializeVibeIQConfig();
-        fileContent = await (await node_fs_1.promises.readFile(configFileLocation)).toString();
+        fileContent = (await node_fs_1.promises.readFile(configFileLocation)).toString();
     }
     try {
         return JSON.parse(fileContent);
@@ -92,7 +92,7 @@ async function writeConfig(config, configName = null) {
             const fileContent = await readVibeIQConfig();
             configFileName = fileContent.configInUse;
         }
-        await node_fs_1.promises.writeFile((0, node_path_1.join)(configDirectoryLocation, `${configFileName}.json`), JSON.stringify(config, null, 2));
+        atomicFileWriteSync((0, node_path_1.join)(configDirectoryLocation, `${configFileName}.json`), JSON.stringify(config, null, 2));
     }
     catch (error) {
         logger_1.default.error('Could not open config file for writing.');
@@ -100,16 +100,22 @@ async function writeConfig(config, configName = null) {
     }
 }
 exports.writeConfig = writeConfig;
+function atomicFileWriteSync(filePath, data) {
+    const randomId = Math.random().toString(36).substring(2, 15);
+    const tmpFilepath = `${filePath}.tmp-${randomId}`;
+    (0, node_fs_1.writeFileSync)(tmpFilepath, data);
+    (0, node_fs_1.renameSync)(tmpFilepath, filePath);
+}
 async function getConfig() {
     let fileContent;
     try {
-        fileContent = await (await node_fs_1.promises.readFile(configFileLocation)).toString();
+        fileContent = (await node_fs_1.promises.readFile(configFileLocation)).toString();
     }
     catch {
         logger_1.default.debug(`failed to open config file (${configFileLocation}) for reading.`);
         logger_1.default.debug('trying to initialize config file');
         await initializeVibeIQConfig();
-        fileContent = await (await node_fs_1.promises.readFile(configFileLocation)).toString();
+        fileContent = (await node_fs_1.promises.readFile(configFileLocation)).toString();
     }
     try {
         const configFileJSON = JSON.parse(fileContent);
@@ -156,11 +162,11 @@ async function getConfigContent(fileName) {
     const configFilePath = (0, node_path_1.join)(configDirectoryLocation, `${fileName}.json`);
     let fileContent;
     try {
-        fileContent = await (await node_fs_1.promises.readFile(configFilePath)).toString();
+        fileContent = (await node_fs_1.promises.readFile(configFilePath)).toString();
         return JSON.parse(fileContent);
     }
     catch (error) {
-        logger_1.default.error(`Failed to open/parse config file (${fileName}) might be malformed or not found.`);
+        logger_1.default.error(`Failed to open/parse config file (${fileName}) might be malformed or not found. Path: ${configFilePath}, error: ${error}`);
     }
 }
 exports.getConfigContent = getConfigContent;

package/dist/helpers/propertySpecifications/propertySpecifications.d.ts

@@ -10,17 +10,24 @@
  *
  * It is typically used as the argv in a command.
  *
+ * Special handling for empty values and null:
+ * - slug= (empty value) → property is set to undefined (unset)
+ * - slug='""' or slug="''" → property is set to empty string ""
+ * - slug=null → property is set to null
+ * - slug="null" → property is set to the string "null"
+ *
  * Examples:
  *
  * contrail entities get color -- id=123
  * contrail entities update color 123 -- name=obsidian hex=000000
+ * contrail entities update color 123 -- description= notes='""' data=null
  * contrail entities get loader-processes -- createdOn=2025-09-15..2025-09-16
  */
 export type PropertySpecification = {
     slug: string;
-    value: string;
+    value: string | undefined | null;
 };
-export type PropertySpecificationBySlug = Map<string, string | number | string[] | number[]>;
+export type PropertySpecificationBySlug = Map<string, string | number | string[] | number[] | undefined | null>;
 export type PropertySpecificationString = `${string}=${string}`;
 export declare function parsePropertySpecification(spec: PropertySpecificationString): PropertySpecification;
 export declare function parsePropertySpecificationsIntoMap(propertySpecifications: PropertySpecificationString[]): PropertySpecificationBySlug;

package/dist/helpers/propertySpecifications/propertySpecifications.js

@@ -11,15 +11,25 @@
  *
  * It is typically used as the argv in a command.
  *
+ * Special handling for empty values and null:
+ * - slug= (empty value) → property is set to undefined (unset)
+ * - slug='""' or slug="''" → property is set to empty string ""
+ * - slug=null → property is set to null
+ * - slug="null" → property is set to the string "null"
+ *
  * Examples:
  *
  * contrail entities get color -- id=123
  * contrail entities update color 123 -- name=obsidian hex=000000
+ * contrail entities update color 123 -- description= notes='""' data=null
  * contrail entities get loader-processes -- createdOn=2025-09-15..2025-09-16
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isValidPropertySpecification = exports.parsePropertySpecificationsIntoMap = exports.parsePropertySpecification = void 0;
 const dateRanges_1 = require("./dateRanges");
+// Special tokens for empty strings
+const DOUBLE_QUOTED_EMPTY = '""';
+const SINGLE_QUOTED_EMPTY = "''"; // eslint-disable-line quotes
 function parsePropertySpecification(spec) {
     const equalsIndex = spec.indexOf('=');
     if (equalsIndex === -1) {
@@ -27,10 +37,28 @@ function parsePropertySpecification(spec) {
     }
     const slug = spec.substring(0, equalsIndex);
     const value = spec.substring(equalsIndex + 1);
-    if (!slug || !value) {
+    if (!slug) {
         throw new Error(`Invalid property specification: ${spec}`);
     }
-    return { slug, value };
+    // Handle special cases for empty strings and null:
+    // - x= means undefined (unset the property)
+    // - x='""' or x="''" means empty string ""
+    // - x=null means null value
+    // - x="null" means the string "null"
+    let finalValue;
+    if (value === '') {
+        finalValue = undefined;
+    }
+    else if (value === DOUBLE_QUOTED_EMPTY || value === SINGLE_QUOTED_EMPTY) {
+        finalValue = '';
+    }
+    else if (value === 'null') {
+        finalValue = null;
+    }
+    else {
+        finalValue = value;
+    }
+    return { slug, value: finalValue };
 }
 exports.parsePropertySpecification = parsePropertySpecification;
 function parsePropertySpecificationsIntoMap(propertySpecifications) {
@@ -43,8 +71,8 @@ function parsePropertySpecificationsIntoMap(propertySpecifications) {
             continue;
         }
         const { slug, value } = parsePropertySpecification(spec);
-        if (slug === 'roles') {
-            // Special handling for roles, which can be an array
+        if (slug === 'roles' && value !== undefined) {
+            // Special handling for roles, which can be an array (only if value is not undefined)
             const rolesArray = value.split(',').map((role) => role.trim());
             propertySpecBySlug.set(slug, rolesArray);
             continue;
@@ -60,8 +88,8 @@ function isValidPropertySpecification(maybeSpec) {
             (0, dateRanges_1.parseDateRangeSpecification)(maybeSpec);
             return true;
         }
-        const { slug, value } = parsePropertySpecification(maybeSpec);
-        return !!slug && !!value;
+        const { slug } = parsePropertySpecification(maybeSpec);
+        return !!slug;
     }
     catch (e) {
         return false;

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

@@ -39,13 +39,66 @@ describe('parsePropertySpecification', () => {
         const result = (0, propertySpecifications_1.parsePropertySpecification)(spec);
         expect(result).toEqual({
             slug: 'formula',
-            value: 'x=y+z', // Now correctly keeps everything after first equals
+            value: 'x=y+z',
         });
     });
     it('should parse property specification with empty value', () => {
         const spec = 'description=';
-        // Current implementation throws error for empty values
-        expect(() => (0, propertySpecifications_1.parsePropertySpecification)(spec)).toThrow('Invalid property specification: description=');
+        const result = (0, propertySpecifications_1.parsePropertySpecification)(spec);
+        expect(result).toEqual({
+            slug: 'description',
+            value: undefined,
+        });
+    });
+    it('should distinguish between empty value and empty string', () => {
+        const emptySpec = 'description=';
+        const emptyStringSpec = 'description=""';
+        const emptyResult = (0, propertySpecifications_1.parsePropertySpecification)(emptySpec);
+        const emptyStringResult = (0, propertySpecifications_1.parsePropertySpecification)(emptyStringSpec);
+        expect(emptyResult).toEqual({
+            slug: 'description',
+            value: undefined,
+        });
+        expect(emptyStringResult).toEqual({
+            slug: 'description',
+            value: '',
+        });
+    });
+    it('should handle both double and single quoted empty strings', () => {
+        const doubleQuotedSpec = 'field=""';
+        const singleQuotedSpec = "field=''"; // eslint-disable-line quotes
+        const doubleQuotedResult = (0, propertySpecifications_1.parsePropertySpecification)(doubleQuotedSpec);
+        const singleQuotedResult = (0, propertySpecifications_1.parsePropertySpecification)(singleQuotedSpec);
+        expect(doubleQuotedResult).toEqual({
+            slug: 'field',
+            value: '',
+        });
+        expect(singleQuotedResult).toEqual({
+            slug: 'field',
+            value: '',
+        });
+    });
+    it('should parse property specification with null value', () => {
+        const spec = 'description=null';
+        const result = (0, propertySpecifications_1.parsePropertySpecification)(spec);
+        expect(result).toEqual({
+            slug: 'description',
+            value: null,
+        });
+    });
+    it('should distinguish between null and the string "null"', () => {
+        const nullSpec = 'field=null';
+        const stringNullSpec = 'field="null"';
+        const nullResult = (0, propertySpecifications_1.parsePropertySpecification)(nullSpec);
+        const stringNullResult = (0, propertySpecifications_1.parsePropertySpecification)(stringNullSpec);
+        expect(nullResult).toEqual({
+            slug: 'field',
+            value: null,
+        });
+        expect(stringNullResult).toEqual({
+            slug: 'field',
+            value: '"null"',
+        });
     });
     it('should throw error for spec without equals sign', () => {
         const spec = 'invalidspec';
@@ -118,9 +171,26 @@ describe('parsePropertySpecificationsIntoMap', () => {
         expect(result.size).toBe(1);
     });
     it('should handle property specifications with empty values', () => {
-        const specs = ['name=john', 'description=', 'notes='];
-        // Current implementation throws error for empty values
-        expect(() => (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(specs)).toThrow('Invalid property specification: description=');
+        const specs = ['name=john', 'description=', 'notes=""'];
+        const result = (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(specs);
+        expect(result.get('name')).toBe('john');
+        expect(result.get('description')).toBeUndefined();
+        expect(result.get('notes')).toBe('');
+        expect(result.size).toBe(3);
+    });
+    it('should handle property specifications with null values', () => {
+        const specs = [
+            'name=john',
+            'description=null',
+            'notes="null"',
+            'empty=',
+        ];
+        const result = (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(specs);
+        expect(result.get('name')).toBe('john');
+        expect(result.get('description')).toBeNull();
+        expect(result.get('notes')).toBe('"null"');
+        expect(result.get('empty')).toBeUndefined();
+        expect(result.size).toBe(4);
     });
     it('should throw error for invalid property specifications', () => {
         const specs = [
@@ -141,9 +211,9 @@ describe('isValidPropertySpecification', () => {
         expect((0, propertySpecifications_1.isValidPropertySpecification)('property-name=value')).toBe(true);
     });
     it('should return true for property specifications with empty values', () => {
-        // Current implementation rejects empty values
-        expect((0, propertySpecifications_1.isValidPropertySpecification)('description=')).toBe(false);
-        expect((0, propertySpecifications_1.isValidPropertySpecification)('notes=')).toBe(false);
+        // Now implementation should accept empty values
+        expect((0, propertySpecifications_1.isValidPropertySpecification)('description=')).toBe(true);
+        expect((0, propertySpecifications_1.isValidPropertySpecification)('notes=')).toBe(true);
     });
     it('should return false for invalid property specifications', () => {
         expect((0, propertySpecifications_1.isValidPropertySpecification)('invalid')).toBe(false);
@@ -195,6 +265,35 @@ describe('integration tests', () => {
         expect(map.get('id')).toBe('123');
         expect(map.size).toBe(2);
     });
+    it('should handle command line parsing issue with empty strings', () => {
+        // When user types: contrail entities update color 123 -- description="" notes=''
+        // The shell may convert this to: ['description=', 'notes='] or ['description=""', 'notes=\'\'']
+        // depending on the shell and escaping
+        // Test case 1: Shell strips quotes (common case)
+        const shellStrippedSpecs = ['description=', 'notes='];
+        const shellStrippedMap = (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(shellStrippedSpecs);
+        expect(shellStrippedMap.get('description')).toBeUndefined(); // Empty = undefined
+        expect(shellStrippedMap.get('notes')).toBeUndefined(); // Empty = undefined
+        // Test case 2: Shell preserves quotes (desired case for empty strings)
+        const quotedSpecs = ['description=""'];
+        const quotedMap = (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(quotedSpecs);
+        expect(quotedMap.get('description')).toBe(''); // Quoted empty = empty string
+        // Test case 3: Mixed usage with null
+        const mixedSpecs = [
+            'name=test',
+            'description=',
+            'notes=""',
+            'data=null',
+            'status="null"',
+        ];
+        const mixedMap = (0, propertySpecifications_1.parsePropertySpecificationsIntoMap)(mixedSpecs);
+        expect(mixedMap.get('name')).toBe('test');
+        expect(mixedMap.get('description')).toBeUndefined(); // Unset
+        expect(mixedMap.get('notes')).toBe(''); // Empty string
+        expect(mixedMap.get('data')).toBeNull(); // null value
+        expect(mixedMap.get('status')).toBe('"null"'); // String "null"
+        expect(mixedMap.size).toBe(5);
+    });
 });
 describe('edge cases and limitations', () => {
     it('should handle multiple equals signs correctly', () => {
@@ -263,4 +362,20 @@ describe('edge cases and limitations', () => {
             value: 'value',
         });
     });
+    it('should document all special value types', () => {
+        // This test documents all the special value types and their parsing behavior
+        const specs = [
+            { input: 'a=value', expected: 'value', description: 'regular string' },
+            { input: 'b=', expected: undefined, description: 'undefined (unset)' },
+            { input: 'c=""', expected: '', description: 'empty string' },
+            { input: 'd=null', expected: null, description: 'null value' },
+            { input: 'e="null"', expected: '"null"', description: 'string "null"' },
+            { input: 'f=123', expected: '123', description: 'numeric string' },
+            { input: 'g=true', expected: 'true', description: 'boolean string' },
+        ];
+        for (const { input, expected } of specs) {
+            const result = (0, propertySpecifications_1.parsePropertySpecification)(input);
+            expect(result.value).toBe(expected);
+        }
+    });
 });

package/dist/helpers/types/type-uploader.js

@@ -188,6 +188,7 @@ async function uploadReducedTypeProperties(type, currentPropertyTypes, newProper
                         validationFunction: newPropertyType.validationFunction,
                         numberFormat: newPropertyType.numberFormat,
                         sequenceSeedValue: newPropertyType.sequenceSeedValue,
+                        copyBehavior: newPropertyType?.copyBehavior,
                     }),
                     headers: {
                         Accept: 'application/json',
@@ -199,6 +200,11 @@ async function uploadReducedTypeProperties(type, currentPropertyTypes, newProper
             // !newPropertyType.inherited &&
             // !typePropertiesEqual(found, newPropertyType, optionSetIdBySlug)
             ) {
+                // Skip platform-managed entities
+                if (newPropertyType.core) {
+                    logger_1.default.debug(`Skipping platform-managed property: ${newPropertyType.slug}`);
+                    continue;
+                }
                 const proposedTP = {
                     isArchived: newPropertyType.isArchived ?? null,
                     propertyType: newPropertyType.propertyType ?? null,
@@ -223,6 +229,7 @@ async function uploadReducedTypeProperties(type, currentPropertyTypes, newProper
                     validationFunction: newPropertyType.validationFunction ?? null,
                     numberFormat: newPropertyType.numberFormat ?? null,
                     sequenceSeedValue: newPropertyType.sequenceSeedValue ?? null,
+                    copyBehavior: newPropertyType.copyBehavior ?? null,
                 };
                 // logger.debug(
                 //   `found type property option set: ${newPropertyType.typePropertyOptionSetSlug}, ${proposedTP.typePropertyOptionSetId}, `,

package/dist/interfaces.d.ts

@@ -360,6 +360,7 @@ export interface ReducedTypeProperty {
     validationFunction?: string;
     numberFormat?: any;
     sequenceSeedValue?: number;
+    copyBehavior?: string;
 }
 export interface ReducedOptionSet {
     name: string;

package/dist/templates/typescript/README.md

@@ -1,5 +1,7 @@
 ### Running your app
+
 Run `npm run start` at the root directory of your app (where the `package.json` file is located).
 
 ### Publishing your app
-Run `contrail app publish` to publish a new version of the app.
+
+Run `contrail app publish` to publish a new version of the app.

package/dist/templates/typescript/assets/sample.json

@@ -1,3 +1,3 @@
 {
   "foo": "bar"
-}
+}

package/dist/templates/typescript/eslintrc.json

@@ -25,10 +25,7 @@
     "no-multiple-empty-lines": ["error", { "max": 1, "maxEOF": 0 }],
     "no-trailing-spaces": "error",
     "no-mixed-spaces-and-tabs": ["error", "smart-tabs"],
-    "@typescript-eslint/no-empty-function": [
-      "error",
-      { "allow": ["arrowFunctions"] }
-    ],
+    "@typescript-eslint/no-empty-function": ["error", { "allow": ["arrowFunctions"] }],
     "@typescript-eslint/no-explicit-any": "off",
     "@typescript-eslint/no-var-requires": "warn",
     "no-unused-vars": "off",

package/dist/templates/typescript/tsconfig.json

@@ -4,15 +4,7 @@
     "emitDecoratorMetadata": true,
     "esModuleInterop": true,
     "experimentalDecorators": true,
-    "lib": [
-      "es5",
-      "ES2015",
-      "ES2016",
-      "ES2017",
-      "ES2020",
-      "dom",
-      "esnext.asynciterable"
-    ],
+    "lib": ["es5", "ES2015", "ES2016", "ES2017", "ES2020", "dom", "esnext.asynciterable"],
     "module": "CommonJS",
     // "moduleResolution": "node",
     "noImplicitAny": false,
@@ -22,16 +14,8 @@
     "strict": false,
     "strictPropertyInitialization": false,
     "target": "ES2020",
-    "types": [
-      "node", "jest"
-    ]
+    "types": ["node", "jest"]
   },
-  "exclude": [
-    "node_modules",
-    "**/__tests__/*"
-  ],
-  "include": [
-    "src",
-    "package.json"
-  ]
-}
+  "exclude": ["node_modules", "**/__tests__/*"],
+  "include": ["src", "package.json"]
+}

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.5.0-alpha-1",
+  "version": "3.6.0-alpha-2",
   "commands": {
     "app:create": {
       "id": "app:create",
@@ -963,7 +963,8 @@
       "pluginType": "core",
       "aliases": [],
       "examples": [
-        "contrail entities update color 123 -- name=obsidian hex=000000"
+        "contrail entities update color 123 -- name=obsidian hex=000000",
+        "contrail entities update color 123 -- description= notes='\"\"' data=null # Unset description, empty notes, null data"
       ],
       "flags": {
         "logLevel": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/cli",
-  "version": "3.5.0-alpha-1",
+  "version": "3.6.0-alpha-2",
   "description": "VibeIQ's Contrail Platform CLI.",
   "bin": {
     "contrail-cli": "./bin/run",
@@ -23,7 +23,7 @@
   ],
   "dependencies": {
     "@contrail/entity-types": "^1.4.0-alpha",
-    "@contrail/org-config-migration": "^1.1.4",
+    "@contrail/org-config-migration": "^1.1.6",
     "@contrail/sdk": "^1.6.0-alpha",
     "@contrail/types": "^3.0.48",
     "@contrail/util": "^1.1.15",