@factorialco/fcode-cli 2.3.0 → 3.0.0

package/dist/commands/i18n/diff.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("../../core/types");
+const i18n_command_1 = require("../../core/commands/i18n-command");
+class I18nDiff extends i18n_command_1.default {
+    async run() {
+        if (await this.resourcesDiff()) {
+            this.exit(1);
+        }
+    }
+}
+I18nDiff.description = 'Show a unified diff between local locales and the cloud. Exits 1 when they differ';
+I18nDiff.examples = ['$ fcode i18n:diff', '$ fcode i18n:diff en'];
+I18nDiff.args = types_1.ResourceSlugArg;
+exports.default = I18nDiff;

package/dist/commands/i18n/status.d.ts

@@ -6,6 +6,9 @@ export default class I18nStatus extends I18nCommand {
     static args: {
         resourceSlug: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
+    static flags: {
+        showInherited: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
     resourcesTableLog(resources: Array<MergedResource>): Promise<void>;
     run(): Promise<void>;
 }

package/dist/commands/i18n/status.js

@@ -39,4 +39,5 @@ class I18nStatus extends i18n_command_1.default {
 I18nStatus.description = 'List all locales status';
 I18nStatus.examples = ['$ fcode i18n:status'];
 I18nStatus.args = types_1.ResourceSlugArg;
+I18nStatus.flags = types_1.ShowInheritedFlag;
 exports.default = I18nStatus;

package/dist/commands/modules/diff.d.ts

@@ -0,0 +1,9 @@
+import ModulesCommand from '../../core/commands/modules-command';
+export default class ModulesDiff extends ModulesCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        resourceSlug: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/modules/diff.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("../../core/types");
+const modules_command_1 = require("../../core/commands/modules-command");
+class ModulesDiff extends modules_command_1.default {
+    async run() {
+        if (await this.resourcesDiff()) {
+            this.exit(1);
+        }
+    }
+}
+ModulesDiff.description = 'Show a unified diff between local modules and the cloud. Exits 1 when they differ';
+ModulesDiff.examples = ['$ fcode modules:diff', '$ fcode modules:diff my-module'];
+ModulesDiff.args = types_1.ResourceSlugArg;
+exports.default = ModulesDiff;

package/dist/commands/modules/status.d.ts

@@ -6,6 +6,9 @@ export default class ModulesStatus extends ModulesCommand {
     static args: {
         resourceSlug: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
+    static flags: {
+        showInherited: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
     resourcesTableLog(resources: Array<MergedResource>): Promise<void>;
     run(): Promise<void>;
 }

package/dist/commands/modules/status.js

@@ -37,4 +37,5 @@ class ModulesStatus extends modules_command_1.default {
 ModulesStatus.description = 'List all modules status';
 ModulesStatus.examples = ['$ fcode modules:status'];
 ModulesStatus.args = types_1.ResourceSlugArg;
+ModulesStatus.flags = types_1.ShowInheritedFlag;
 exports.default = ModulesStatus;

package/dist/commands/processes/diff.d.ts

@@ -0,0 +1,9 @@
+import ProcessesCommand from '../../core/commands/processes-command';
+export default class ProcessesDiff extends ProcessesCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        resourceSlug: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/processes/diff.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("../../core/types");
+const processes_command_1 = require("../../core/commands/processes-command");
+class ProcessesDiff extends processes_command_1.default {
+    async run() {
+        if (await this.resourcesDiff()) {
+            this.exit(1);
+        }
+    }
+}
+ProcessesDiff.description = 'Show a unified diff between local processes and the cloud. Exits 1 when they differ';
+ProcessesDiff.examples = ['$ fcode processes:diff', '$ fcode processes:diff hello-world'];
+ProcessesDiff.args = types_1.ResourceSlugArg;
+exports.default = ProcessesDiff;

package/dist/commands/processes/status.d.ts

@@ -6,6 +6,9 @@ export default class ProcessesStatus extends ProcessesCommand {
     static args: {
         resourceSlug: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
+    static flags: {
+        showInherited: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
     resourcesTableLog(resources: Array<MergedResource>): Promise<void>;
     run(): Promise<void>;
 }

package/dist/commands/processes/status.js

@@ -55,4 +55,5 @@ class ProcessesStatus extends processes_command_1.default {
 ProcessesStatus.description = 'List all processes status';
 ProcessesStatus.examples = ['$ fcode processes:status'];
 ProcessesStatus.args = types_1.ResourceSlugArg;
+ProcessesStatus.flags = types_1.ShowInheritedFlag;
 exports.default = ProcessesStatus;

package/dist/commands/pull.js

@@ -6,7 +6,7 @@ const pull_2 = require("./processes/pull");
 const pull_3 = require("./variables/pull");
 const pull_4 = require("./i18n/pull");
 const pull_5 = require("./dependencies/pull");
-const pull_6 = require("./team/pull");
+const pull_6 = require("./settings/pull");
 const types_1 = require("../core/types");
 const gitignore_1 = require("../utils/gitignore");
 class PullCommand extends base_command_1.default {
@@ -21,9 +21,9 @@ class PullCommand extends base_command_1.default {
         await pull_3.default.run(args);
         await pull_4.default.run(args);
         await pull_5.default.run(args);
-        // Team settings are pulled last so process metadata is available to resolve the
+        // Workspace settings are pulled last so process metadata is available to resolve the
         // error-handler process id to its slug.
-        await pull_6.default.run([]);
+        await pull_6.default.run(args);
         // Keep inherited resources out of git now that all resource metadata is saved.
         await (0, gitignore_1.syncInheritedGitignore)();
     }

package/dist/commands/push.js

@@ -6,7 +6,7 @@ const push_2 = require("./processes/push");
 const push_3 = require("./variables/push");
 const push_4 = require("./i18n/push");
 const push_5 = require("./dependencies/push");
-const push_6 = require("./team/push");
+const push_6 = require("./settings/push");
 const types_1 = require("../core/types");
 class PushCommand extends base_command_1.default {
     async run() {
@@ -20,7 +20,7 @@ class PushCommand extends base_command_1.default {
         await push_3.default.run(args);
         await push_4.default.run(args);
         await push_5.default.run(args);
-        // Team settings are pushed last so the error-handler process exists to resolve
+        // Workspace settings are pushed last so the error-handler process exists to resolve
         // its slug to an id.
         await push_6.default.run(args);
     }

package/dist/commands/{team → settings}/aliases/delete.d.ts

@@ -1,5 +1,5 @@
 import ApiClientCommand from '../../../core/commands/api-client-command';
-export default class TeamAliasesDeleteCommand extends ApiClientCommand {
+export default class SettingsAliasesDeleteCommand extends ApiClientCommand {
     static description: string;
     static examples: string[];
     static args: {

package/dist/commands/{team → settings}/aliases/delete.js

@@ -5,9 +5,9 @@ const color_1 = require("@oclif/color");
 const api_client_command_1 = require("../../../core/commands/api-client-command");
 const pull_1 = require("../pull");
 const cli_1 = require("../../../utils/cli");
-class TeamAliasesDeleteCommand extends api_client_command_1.default {
+class SettingsAliasesDeleteCommand extends api_client_command_1.default {
     async run() {
-        const { args: { name }, } = await this.parse(TeamAliasesDeleteCommand);
+        const { args: { name }, } = await this.parse(SettingsAliasesDeleteCommand);
         const aliases = await this._fcodeGraphQLClient.allTeamVersionAliases();
         const alias = aliases.find((candidate) => candidate.name === name);
         if (!alias) {
@@ -20,9 +20,9 @@ class TeamAliasesDeleteCommand extends api_client_command_1.default {
         await pull_1.default.run([]);
     }
 }
-TeamAliasesDeleteCommand.description = 'Delete a team version alias and the per-entity aliases carrying its name on every owned process and module';
-TeamAliasesDeleteCommand.examples = ['$ fcode team:aliases:delete production'];
-TeamAliasesDeleteCommand.args = {
+SettingsAliasesDeleteCommand.description = 'Delete a workspace version alias and the per-entity aliases carrying its name on every owned process and module';
+SettingsAliasesDeleteCommand.examples = ['$ fcode settings:aliases:delete production'];
+SettingsAliasesDeleteCommand.args = {
     name: core_1.Args.string({ description: 'alias name to delete', required: true }),
 };
-exports.default = TeamAliasesDeleteCommand;
+exports.default = SettingsAliasesDeleteCommand;

package/dist/commands/{team → settings}/aliases/list.d.ts

@@ -1,5 +1,5 @@
 import ApiClientCommand from '../../../core/commands/api-client-command';
-export default class TeamAliasesListCommand extends ApiClientCommand {
+export default class SettingsAliasesListCommand extends ApiClientCommand {
     static description: string;
     static examples: string[];
     run(): Promise<void>;

package/dist/commands/{team → settings}/aliases/list.js

@@ -3,21 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const color_1 = require("@oclif/color");
 const api_client_command_1 = require("../../../core/commands/api-client-command");
 const cli_1 = require("../../../utils/cli");
-class TeamAliasesListCommand extends api_client_command_1.default {
+class SettingsAliasesListCommand extends api_client_command_1.default {
     async run() {
-        await this.parse(TeamAliasesListCommand);
+        await this.parse(SettingsAliasesListCommand);
         const aliases = await this._fcodeGraphQLClient.allTeamVersionAliases();
         if (aliases.length === 0) {
-            cli_1.default.log('📋 No team version aliases yet.');
-            cli_1.default.log(`Create one with ${color_1.default.cyan('fcode team:aliases:set [name] [tag]')}`);
+            cli_1.default.log('📋 No workspace version aliases yet.');
+            cli_1.default.log(`Create one with ${color_1.default.cyan('fcode settings:aliases:set [name] [tag]')}`);
             return;
         }
-        cli_1.default.log('🔗 Team version aliases:\n');
+        cli_1.default.log('🔗 Workspace version aliases:\n');
         for (const alias of aliases) {
             cli_1.default.log(`  ${color_1.default.cyan(alias.name)} → ${alias.tag}`);
         }
     }
 }
-TeamAliasesListCommand.description = 'List the team version aliases of the active team workspace';
-TeamAliasesListCommand.examples = ['$ fcode team:aliases:list'];
-exports.default = TeamAliasesListCommand;
+SettingsAliasesListCommand.description = 'List the workspace version aliases of the active workspace';
+SettingsAliasesListCommand.examples = ['$ fcode settings:aliases:list'];
+exports.default = SettingsAliasesListCommand;

package/dist/commands/{team → settings}/aliases/set.d.ts

@@ -1,5 +1,5 @@
 import ApiClientCommand from '../../../core/commands/api-client-command';
-export default class TeamAliasesSetCommand extends ApiClientCommand {
+export default class SettingsAliasesSetCommand extends ApiClientCommand {
     static description: string;
     static examples: string[];
     static args: {

package/dist/commands/{team → settings}/aliases/set.js

@@ -5,21 +5,21 @@ const color_1 = require("@oclif/color");
 const api_client_command_1 = require("../../../core/commands/api-client-command");
 const pull_1 = require("../pull");
 const cli_1 = require("../../../utils/cli");
-class TeamAliasesSetCommand extends api_client_command_1.default {
+class SettingsAliasesSetCommand extends api_client_command_1.default {
     async run() {
-        const { args: { name, tag }, } = await this.parse(TeamAliasesSetCommand);
+        const { args: { name, tag }, } = await this.parse(SettingsAliasesSetCommand);
         cli_1.default.log(color_1.default.cyan(`\n🔗 pointing alias ${name} at ${tag}...`));
         await this._fcodeGraphQLClient.createTeamVersionAlias(name, tag);
         cli_1.default.log(color_1.default.green(`✅ alias ${name} → ${tag}`));
-        // Aliases have no folder representation; refreshing team.json is enough.
+        // Aliases have no folder representation; refreshing settings.json is enough.
         await pull_1.default.run([]);
     }
 }
-TeamAliasesSetCommand.description = 'Create or re-point a team version alias, upserting the per-entity alias on every owned ' +
+SettingsAliasesSetCommand.description = 'Create or re-point a workspace version alias, upserting the per-entity alias on every owned ' +
     'process and module that has the target tag published';
-TeamAliasesSetCommand.examples = ['$ fcode team:aliases:set production v1.0.0'];
-TeamAliasesSetCommand.args = {
+SettingsAliasesSetCommand.examples = ['$ fcode settings:aliases:set production v1.0.0'];
+SettingsAliasesSetCommand.args = {
     name: core_1.Args.string({ description: 'alias name (e.g. production)', required: true }),
-    tag: core_1.Args.string({ description: 'team version tag the alias points at', required: true }),
+    tag: core_1.Args.string({ description: 'workspace version tag the alias points at', required: true }),
 };
-exports.default = TeamAliasesSetCommand;
+exports.default = SettingsAliasesSetCommand;

package/dist/commands/settings/diff.d.ts

@@ -0,0 +1,8 @@
+import ApiClientCommand from '../../core/commands/api-client-command';
+import SettingsRepository from '../../repositories/settings';
+export default class SettingsDiffCommand extends ApiClientCommand {
+    static description: string;
+    static examples: string[];
+    _settingsRepository: SettingsRepository;
+    run(): Promise<void>;
+}

package/dist/commands/settings/diff.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const color_1 = require("@oclif/color");
+const api_client_command_1 = require("../../core/commands/api-client-command");
+const settings_1 = require("../../repositories/settings");
+const cli_1 = require("../../utils/cli");
+const diff_1 = require("../../utils/diff");
+const resource_differ_1 = require("../../services/resource-differ");
+class SettingsDiffCommand extends api_client_command_1.default {
+    constructor() {
+        super(...arguments);
+        this._settingsRepository = new settings_1.default();
+    }
+    async run() {
+        await this.parse(SettingsDiffCommand);
+        cli_1.default.log(color_1.default.cyan('\nsettings diff'));
+        const [raw, versions, aliases] = await Promise.all([
+            this._fcodeGraphQLClient.team(),
+            this._fcodeGraphQLClient.allTeamVersions(),
+            this._fcodeGraphQLClient.allTeamVersionAliases(),
+        ]);
+        const remote = await this._settingsRepository.fromRaw(raw);
+        this._settingsRepository.applyCloudVersioning(remote, versions, aliases);
+        const local = this._settingsRepository.exists() ? await this._settingsRepository.find() : undefined;
+        // Gated on the content hash rather than on the rendered bytes: a version's server-assigned
+        // createdAt is in settings.json but not in the hash, and it must not read as a local change.
+        if (local && local.contentHash === remote.contentHash) {
+            cli_1.default.log(color_1.default.green('✅ workspace settings up to date'));
+            return;
+        }
+        const file = (0, resource_differ_1.settingsDiffFile)(this._settingsRepository.toFile(remote), local && this._settingsRepository.toFile(local));
+        cli_1.default.log('');
+        cli_1.default.log((0, diff_1.colorizeDiff)((0, diff_1.renderUnifiedDiff)(file)));
+        this.exit(1);
+    }
+}
+SettingsDiffCommand.description = 'Show a unified diff between local workspace settings (settings.json) and the cloud. Exits 1 when they differ';
+SettingsDiffCommand.examples = ['$ fcode settings:diff'];
+exports.default = SettingsDiffCommand;

package/dist/commands/{team/push.d.ts → settings/pull.d.ts}

@@ -1,11 +1,11 @@
 import ApiClientCommand from '../../core/commands/api-client-command';
-import TeamRepository from '../../repositories/team';
-export default class TeamPushCommand extends ApiClientCommand {
+import SettingsRepository from '../../repositories/settings';
+export default class SettingsPullCommand extends ApiClientCommand {
     static description: string;
     static examples: string[];
     static flags: {
         force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
-    _teamRepository: TeamRepository;
+    _settingsRepository: SettingsRepository;
     run(): Promise<void>;
 }

package/dist/commands/settings/pull.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const color_1 = require("@oclif/color");
+const api_client_command_1 = require("../../core/commands/api-client-command");
+const settings_1 = require("../../repositories/settings");
+const types_1 = require("../../core/types");
+const cli_1 = require("../../utils/cli");
+class SettingsPullCommand extends api_client_command_1.default {
+    constructor() {
+        super(...arguments);
+        this._settingsRepository = new settings_1.default();
+    }
+    async run() {
+        const { flags: { force }, } = await this.parse(SettingsPullCommand);
+        cli_1.default.log(color_1.default.cyan('\n🗄️  pulling workspace settings...'));
+        // Local edits (a version tag added, an alias re-pointed) would be silently wiped by the
+        // overwrite below, so an unpushed settings.json blocks the pull. No stored hash means there is
+        // no baseline to have diverged from (fresh workspace), so the pull proceeds.
+        if (!force && this._settingsRepository.exists()) {
+            const local = await this._settingsRepository.find();
+            const storedHash = await this.workspaceConfig.getSettingsStoredHash();
+            if (storedHash !== undefined && storedHash !== local.contentHash) {
+                cli_1.default.log(color_1.default.yellow('🔺 settings.json has unpushed local changes — run fcode settings:push first, or fcode settings:pull --force to overwrite them'));
+                return;
+            }
+        }
+        const [raw, versions, aliases] = await Promise.all([
+            this._fcodeGraphQLClient.team(),
+            this._fcodeGraphQLClient.allTeamVersions(),
+            this._fcodeGraphQLClient.allTeamVersionAliases(),
+        ]);
+        const settings = await this._settingsRepository.fromRaw(raw);
+        this._settingsRepository.applyCloudVersioning(settings, versions, aliases);
+        this._settingsRepository.save(settings);
+        await this.workspaceConfig.setSettingsStoredHash(settings.contentHash);
+    }
+}
+SettingsPullCommand.description = 'Fetch workspace settings (timezone, error handler, inheritance) and workspace versions/aliases from cloud into settings.json';
+SettingsPullCommand.examples = ['$ fcode settings:pull'];
+SettingsPullCommand.flags = types_1.ForceFlag;
+exports.default = SettingsPullCommand;

package/dist/commands/settings/push.d.ts

@@ -0,0 +1,13 @@
+import ApiClientCommand from '../../core/commands/api-client-command';
+import SettingsRepository from '../../repositories/settings';
+export default class SettingsPushCommand extends ApiClientCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    _settingsRepository: SettingsRepository;
+    run(): Promise<void>;
+    /** Makes the cloud's versions/aliases match settings.json; returns failed manifest entries. */
+    private syncVersioning;
+}

package/dist/commands/settings/push.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const color_1 = require("@oclif/color");
+const api_client_command_1 = require("../../core/commands/api-client-command");
+const settings_1 = require("../../repositories/settings");
+const types_1 = require("../../core/types");
+const team_versioning_1 = require("../../services/team-versioning");
+const cli_1 = require("../../utils/cli");
+class SettingsPushCommand extends api_client_command_1.default {
+    constructor() {
+        super(...arguments);
+        this._settingsRepository = new settings_1.default();
+    }
+    async run() {
+        const { flags: { force }, } = await this.parse(SettingsPushCommand);
+        if (!this._settingsRepository.exists()) {
+            return;
+        }
+        cli_1.default.log(color_1.default.cyan('\n☁️  pushing workspace settings...'));
+        const settings = await this._settingsRepository.find();
+        const storedHash = await this.workspaceConfig.getSettingsStoredHash();
+        if (!force && storedHash === settings.contentHash) {
+            cli_1.default.log('Workspace settings already up to date');
+            return;
+        }
+        const update = { parentTeams: settings.parentTeams };
+        if (settings.zoneId !== undefined) {
+            update.zoneId = settings.zoneId;
+        }
+        if (settings.errorHandlerConfig) {
+            const processId = await this._settingsRepository.resolveSlugToId(settings.errorHandlerConfig.processSlug);
+            update.executionErrorHandlerConfig = { processId, tag: settings.errorHandlerConfig.tag ?? null };
+        }
+        // Sent unconditionally, null arm included: settings.json is the source of truth, so removing
+        // webhookAuth from it must clear the cloud configuration rather than leave it dangling.
+        update.webhookAuth = settings.webhookAuth
+            ? { headerName: settings.webhookAuth.headerName ?? null, variableKey: settings.webhookAuth.variableKey }
+            : { variableKey: null };
+        // Sent unconditionally for the same reason as webhookAuth: settings.json is the source of truth,
+        // so removing primaryLocale from it must clear the cloud setting. Empty string is the clear.
+        update.primaryLocale = settings.primaryLocale ?? '';
+        await this._fcodeGraphQLClient.pushTeam(update);
+        const failedEntities = await this.syncVersioning(settings, force);
+        // Re-read the cloud state so server-assigned fields (createdAt) and declined deletions
+        // land back in settings.json, then hash exactly what was written.
+        const [versions, aliases] = await Promise.all([
+            this._fcodeGraphQLClient.allTeamVersions(),
+            this._fcodeGraphQLClient.allTeamVersionAliases(),
+        ]);
+        this._settingsRepository.applyCloudVersioning(settings, versions, aliases);
+        this._settingsRepository.save(settings);
+        await this.workspaceConfig.setSettingsStoredHash(settings.contentHash);
+        cli_1.default.log(color_1.default.green('✅ workspace settings pushed'));
+        // Release pipelines must be able to detect an incomplete version. Re-running the
+        // command converges: it publishes only what is still missing.
+        if (failedEntities > 0) {
+            this.error(`workspace versions pushed with ${failedEntities} failed entities`, { exit: 1 });
+        }
+    }
+    /** Makes the cloud's versions/aliases match settings.json; returns failed manifest entries. */
+    async syncVersioning(settings, force) {
+        const [cloudVersions, cloudAliases] = await Promise.all([
+            this._fcodeGraphQLClient.allTeamVersions(),
+            this._fcodeGraphQLClient.allTeamVersionAliases(),
+        ]);
+        const plan = (0, team_versioning_1.planTeamVersioningSync)(settings, cloudVersions, cloudAliases);
+        if ((0, team_versioning_1.teamVersioningSyncPlanIsEmpty)(plan)) {
+            return 0;
+        }
+        let failedEntities = 0;
+        for (const version of plan.createVersions) {
+            cli_1.default.log(color_1.default.cyan(`🏷️  publishing workspace version ${version.tag}...`));
+            const teamVersion = await this._fcodeGraphQLClient.createTeamVersion(version.tag, version.comment);
+            failedEntities += (0, team_versioning_1.logTeamVersionManifest)(teamVersion);
+        }
+        for (const version of plan.deleteVersions) {
+            if (!force) {
+                const confirmed = await cli_1.default.confirm(`Workspace version ${version.tag} exists in the cloud but not in settings.json. Deleting it also deletes ` +
+                    'every process/module version with that tag, plus the aliases, executions and schedules ' +
+                    'referencing them. Delete it?');
+                if (!confirmed) {
+                    continue;
+                }
+            }
+            cli_1.default.log(color_1.default.cyan(`🗑️  deleting workspace version ${version.tag}...`));
+            await this._fcodeGraphQLClient.deleteTeamVersion(version.tag);
+        }
+        for (const alias of plan.setAliases) {
+            cli_1.default.log(color_1.default.cyan(`🔗 pointing alias ${alias.name} at ${alias.tag}...`));
+            await this._fcodeGraphQLClient.createTeamVersionAlias(alias.name, alias.tag);
+        }
+        for (const alias of plan.deleteAliases) {
+            cli_1.default.log(color_1.default.cyan(`🗑️  deleting alias ${alias.name}...`));
+            await this._fcodeGraphQLClient.deleteTeamVersionAlias(alias.id);
+        }
+        return failedEntities;
+    }
+}
+SettingsPushCommand.description = 'Update cloud workspace settings (timezone, error handler, inheritance, webhook auth) and sync ' +
+    'workspace versions/aliases from settings.json';
+SettingsPushCommand.examples = ['$ fcode settings:push'];
+SettingsPushCommand.flags = types_1.ForceFlag;
+exports.default = SettingsPushCommand;

package/dist/commands/settings/status.d.ts

@@ -0,0 +1,8 @@
+import ApiClientCommand from '../../core/commands/api-client-command';
+import SettingsRepository from '../../repositories/settings';
+export default class SettingsStatusCommand extends ApiClientCommand {
+    static description: string;
+    static examples: string[];
+    _settingsRepository: SettingsRepository;
+    run(): Promise<void>;
+}

package/dist/commands/settings/status.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const color_1 = require("@oclif/color");
+const api_client_command_1 = require("../../core/commands/api-client-command");
+const settings_1 = require("../../repositories/settings");
+const cli_1 = require("../../utils/cli");
+class SettingsStatusCommand extends api_client_command_1.default {
+    constructor() {
+        super(...arguments);
+        this._settingsRepository = new settings_1.default();
+    }
+    async run() {
+        await this.parse(SettingsStatusCommand);
+        cli_1.default.log(color_1.default.cyan('\nsettings status'));
+        if (!this._settingsRepository.exists()) {
+            cli_1.default.log('No settings.json found');
+            return;
+        }
+        const local = await this._settingsRepository.find();
+        const storedHash = await this.workspaceConfig.getSettingsStoredHash();
+        const [raw, versions, aliases] = await Promise.all([
+            this._fcodeGraphQLClient.team(),
+            this._fcodeGraphQLClient.allTeamVersions(),
+            this._fcodeGraphQLClient.allTeamVersionAliases(),
+        ]);
+        const remote = await this._settingsRepository.fromRaw(raw);
+        this._settingsRepository.applyCloudVersioning(remote, versions, aliases);
+        const localChanged = storedHash !== local.contentHash;
+        const remoteChanged = storedHash !== remote.contentHash;
+        if (localChanged && remoteChanged) {
+            cli_1.default.log(color_1.default.red('🔥 workspace settings conflict (changed both locally and in the cloud)'));
+        }
+        else if (localChanged) {
+            cli_1.default.log(color_1.default.yellow('🔺 workspace settings modified locally (run fcode settings:push)'));
+        }
+        else if (remoteChanged) {
+            cli_1.default.log(color_1.default.yellow('🔻 workspace settings out of date (run fcode settings:pull)'));
+        }
+        else {
+            cli_1.default.log(color_1.default.green('✅ workspace settings up to date'));
+        }
+    }
+}
+SettingsStatusCommand.description = 'Show whether workspace settings (timezone, error handler, inheritance) or workspace versions/aliases differ from the cloud';
+SettingsStatusCommand.examples = ['$ fcode settings:status'];
+exports.default = SettingsStatusCommand;

package/dist/commands/{team → settings}/versions/create.d.ts

@@ -1,5 +1,5 @@
 import ApiClientCommand from '../../../core/commands/api-client-command';
-export default class TeamVersionsCreateCommand extends ApiClientCommand {
+export default class SettingsVersionsCreateCommand extends ApiClientCommand {
     static description: string;
     static examples: string[];
     static args: {
@@ -9,5 +9,4 @@ export default class TeamVersionsCreateCommand extends ApiClientCommand {
         comment: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
-    private logManifest;
 }

package/dist/commands/settings/versions/create.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const color_1 = require("@oclif/color");
+const api_client_command_1 = require("../../../core/commands/api-client-command");
+const pull_1 = require("../../pull");
+const team_versioning_1 = require("../../../services/team-versioning");
+const cli_1 = require("../../../utils/cli");
+class SettingsVersionsCreateCommand extends api_client_command_1.default {
+    async run() {
+        const { args: { tag }, flags: { comment }, } = await this.parse(SettingsVersionsCreateCommand);
+        cli_1.default.log(color_1.default.cyan(`\n🏷️  publishing workspace version ${tag}...`));
+        const teamVersion = await this._fcodeGraphQLClient.createTeamVersion(tag, comment);
+        const failedCount = (0, team_versioning_1.logTeamVersionManifest)(teamVersion);
+        // Refresh the local workspace: per-entity versions/<tag>/ folders and settings.json.
+        await pull_1.default.run([]);
+        // Release pipelines must be able to detect an incomplete version. Re-running the
+        // command converges: it publishes only what is still missing.
+        if (failedCount > 0) {
+            this.error(`workspace version ${tag} published with ${failedCount} failed entities`, { exit: 1 });
+        }
+    }
+}
+SettingsVersionsCreateCommand.description = 'Publish a workspace version: creates a version with the tag on every owned process and module ' +
+    '(existing tags are skipped) and pins bare module imports in the published snapshots';
+SettingsVersionsCreateCommand.examples = [
+    '$ fcode settings:versions:create v1.0.0',
+    '$ fcode settings:versions:create v1.0.0 --comment "First stable release"',
+];
+SettingsVersionsCreateCommand.args = {
+    tag: core_1.Args.string({ description: 'version tag to publish (e.g. v1.0.0)', required: true }),
+};
+SettingsVersionsCreateCommand.flags = {
+    comment: core_1.Flags.string({ char: 'c', description: 'comment describing the version' }),
+};
+exports.default = SettingsVersionsCreateCommand;

package/dist/commands/{team → settings}/versions/delete.d.ts

@@ -1,5 +1,5 @@
 import ApiClientCommand from '../../../core/commands/api-client-command';
-export default class TeamVersionsDeleteCommand extends ApiClientCommand {
+export default class SettingsVersionsDeleteCommand extends ApiClientCommand {
     static description: string;
     static examples: string[];
     static args: {