@factorialco/fcode-cli 2.4.0 → 3.0.0

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,7 +21,7 @@ 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(args);
         // Keep inherited resources out of git now that all resource metadata is saved.

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/settings/pull.d.ts

@@ -0,0 +1,11 @@
+import ApiClientCommand from '../../core/commands/api-client-command';
+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>;
+    };
+    _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/{team → settings}/push.d.ts

@@ -1,13 +1,13 @@
 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 SettingsPushCommand 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>;
-    /** Makes the cloud's team versions/aliases match team.json; returns failed manifest entries. */
+    /** Makes the cloud's versions/aliases match settings.json; returns failed manifest entries. */
     private syncVersioning;
 }

package/dist/commands/{team → settings}/push.js

@@ -2,87 +2,87 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const color_1 = require("@oclif/color");
 const api_client_command_1 = require("../../core/commands/api-client-command");
-const team_1 = require("../../repositories/team");
+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 TeamPushCommand extends api_client_command_1.default {
+class SettingsPushCommand extends api_client_command_1.default {
     constructor() {
         super(...arguments);
-        this._teamRepository = new team_1.default();
+        this._settingsRepository = new settings_1.default();
     }
     async run() {
-        const { flags: { force }, } = await this.parse(TeamPushCommand);
-        if (!this._teamRepository.exists()) {
+        const { flags: { force }, } = await this.parse(SettingsPushCommand);
+        if (!this._settingsRepository.exists()) {
             return;
         }
-        cli_1.default.log(color_1.default.cyan('\n☁️  pushing team settings...'));
-        const team = await this._teamRepository.find();
-        const storedHash = await this.workspaceConfig.getTeamStoredHash();
-        if (!force && storedHash === team.contentHash) {
-            cli_1.default.log('Team settings already up to date');
+        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 = { parentTeamSlugs: team.parentTeamSlugs };
-        if (team.zoneId !== undefined) {
-            update.zoneId = team.zoneId;
+        const update = { parentTeams: settings.parentTeams };
+        if (settings.zoneId !== undefined) {
+            update.zoneId = settings.zoneId;
         }
-        if (team.errorHandlerConfig) {
-            const processId = await this._teamRepository.resolveSlugToId(team.errorHandlerConfig.processSlug);
-            update.executionErrorHandlerConfig = { processId, tag: team.errorHandlerConfig.tag ?? null };
+        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: team.json is the source of truth, so removing
+        // 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 = team.webhookAuth
-            ? { headerName: team.webhookAuth.headerName ?? null, variableKey: team.webhookAuth.variableKey }
+        update.webhookAuth = settings.webhookAuth
+            ? { headerName: settings.webhookAuth.headerName ?? null, variableKey: settings.webhookAuth.variableKey }
             : { variableKey: null };
-        // Sent unconditionally for the same reason as webhookAuth: team.json is the source of truth,
+        // 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 = team.primaryLocale ?? '';
+        update.primaryLocale = settings.primaryLocale ?? '';
         await this._fcodeGraphQLClient.pushTeam(update);
-        const failedEntities = await this.syncVersioning(team, force);
+        const failedEntities = await this.syncVersioning(settings, force);
         // Re-read the cloud state so server-assigned fields (createdAt) and declined deletions
-        // land back in team.json, then hash exactly what was written.
+        // land back in settings.json, then hash exactly what was written.
         const [versions, aliases] = await Promise.all([
             this._fcodeGraphQLClient.allTeamVersions(),
             this._fcodeGraphQLClient.allTeamVersionAliases(),
         ]);
-        this._teamRepository.applyCloudVersioning(team, versions, aliases);
-        this._teamRepository.save(team);
-        await this.workspaceConfig.setTeamStoredHash(team.contentHash);
-        cli_1.default.log(color_1.default.green('✅ team settings pushed'));
+        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(`team versions pushed with ${failedEntities} failed entities`, { exit: 1 });
+            this.error(`workspace versions pushed with ${failedEntities} failed entities`, { exit: 1 });
         }
     }
-    /** Makes the cloud's team versions/aliases match team.json; returns failed manifest entries. */
-    async syncVersioning(team, force) {
+    /** 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)(team, cloudVersions, cloudAliases);
+        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 team version ${version.tag}...`));
+            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(`Team version ${version.tag} exists in the cloud but not in team.json. Deleting it also deletes ` +
+                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 team version ${version.tag}...`));
+            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) {
@@ -96,8 +96,8 @@ class TeamPushCommand extends api_client_command_1.default {
         return failedEntities;
     }
 }
-TeamPushCommand.description = 'Update cloud team settings (timezone, error handler, inheritance, webhook auth) and sync ' +
-    'team versions/aliases from team.json';
-TeamPushCommand.examples = ['$ fcode team:push'];
-TeamPushCommand.flags = types_1.ForceFlag;
-exports.default = TeamPushCommand;
+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: {

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

@@ -6,28 +6,31 @@ 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 TeamVersionsCreateCommand extends api_client_command_1.default {
+class SettingsVersionsCreateCommand extends api_client_command_1.default {
     async run() {
-        const { args: { tag }, flags: { comment }, } = await this.parse(TeamVersionsCreateCommand);
-        cli_1.default.log(color_1.default.cyan(`\n🏷️  publishing team version ${tag}...`));
+        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 team.json.
+        // 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(`team version ${tag} published with ${failedCount} failed entities`, { exit: 1 });
+            this.error(`workspace version ${tag} published with ${failedCount} failed entities`, { exit: 1 });
         }
     }
 }
-TeamVersionsCreateCommand.description = 'Publish a team version: creates a version with the tag on every owned process and module ' +
+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';
-TeamVersionsCreateCommand.examples = ['$ fcode team:versions:create v1.0.0', '$ fcode team:versions:create v1.0.0 --comment "First stable release"'];
-TeamVersionsCreateCommand.args = {
+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 }),
 };
-TeamVersionsCreateCommand.flags = {
+SettingsVersionsCreateCommand.flags = {
     comment: core_1.Flags.string({ char: 'c', description: 'comment describing the version' }),
 };
-exports.default = TeamVersionsCreateCommand;
+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: {

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

@@ -6,27 +6,27 @@ const api_client_command_1 = require("../../../core/commands/api-client-command"
 const pull_1 = require("../../pull");
 const types_1 = require("../../../core/types");
 const cli_1 = require("../../../utils/cli");
-class TeamVersionsDeleteCommand extends api_client_command_1.default {
+class SettingsVersionsDeleteCommand extends api_client_command_1.default {
     async run() {
-        const { args: { tag }, flags: { force }, } = await this.parse(TeamVersionsDeleteCommand);
+        const { args: { tag }, flags: { force }, } = await this.parse(SettingsVersionsDeleteCommand);
         if (!force) {
-            const confirmed = await cli_1.default.confirm(`Deleting team version ${tag} also deletes every process/module version with that tag, plus the aliases, executions and schedules referencing them. Continue?`);
+            const confirmed = await cli_1.default.confirm(`Deleting workspace version ${tag} also deletes every process/module version with that tag, plus the aliases, executions and schedules referencing them. Continue?`);
             if (!confirmed) {
                 return;
             }
         }
-        cli_1.default.log(color_1.default.cyan(`\n🗑️  deleting team version ${tag}...`));
+        cli_1.default.log(color_1.default.cyan(`\n🗑️  deleting workspace version ${tag}...`));
         await this._fcodeGraphQLClient.deleteTeamVersion(tag);
-        cli_1.default.log(color_1.default.green(`✅ team version ${tag} deleted`));
+        cli_1.default.log(color_1.default.green(`✅ workspace version ${tag} deleted`));
         // Refresh the local workspace so removed versions/<tag>/ folders disappear.
         await pull_1.default.run([]);
     }
 }
-TeamVersionsDeleteCommand.description = 'Delete a team version. CASCADES: every owned process/module version with the tag is deleted, ' +
+SettingsVersionsDeleteCommand.description = 'Delete a workspace version. CASCADES: every owned process/module version with the tag is deleted, ' +
     'together with the aliases, executions and schedules that reference them';
-TeamVersionsDeleteCommand.examples = ['$ fcode team:versions:delete v1.0.0'];
-TeamVersionsDeleteCommand.args = {
+SettingsVersionsDeleteCommand.examples = ['$ fcode settings:versions:delete v1.0.0'];
+SettingsVersionsDeleteCommand.args = {
     tag: core_1.Args.string({ description: 'version tag to delete', required: true }),
 };
-TeamVersionsDeleteCommand.flags = types_1.ForceFlag;
-exports.default = TeamVersionsDeleteCommand;
+SettingsVersionsDeleteCommand.flags = types_1.ForceFlag;
+exports.default = SettingsVersionsDeleteCommand;

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

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