@factorialco/fcode-cli 2.1.0 → 2.3.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @factorialco/fcode-cli
 $ fcode COMMAND
 running command...
 $ fcode (--version)
-@factorialco/fcode-cli/2.1.0 linux-x64 node-v22.22.3
+@factorialco/fcode-cli/2.3.0 linux-x64 node-v22.22.3
 $ fcode --help [COMMAND]
 USAGE
   $ fcode COMMAND
@@ -40,6 +40,12 @@ USAGE
 * [`fcode dependencies:status [RESOURCESLUG]`](#fcode-dependenciesstatus-resourceslug)
 * [`fcode help [COMMAND]`](#fcode-help-command)
 * [`fcode http`](#fcode-http)
+* [`fcode i18n:add [RESOURCESLUG]`](#fcode-i18nadd-resourceslug)
+* [`fcode i18n:pull [RESOURCESLUG]`](#fcode-i18npull-resourceslug)
+* [`fcode i18n:push [RESOURCESLUG]`](#fcode-i18npush-resourceslug)
+* [`fcode i18n:remove [RESOURCESLUG]`](#fcode-i18nremove-resourceslug)
+* [`fcode i18n:reset [RESOURCESLUG]`](#fcode-i18nreset-resourceslug)
+* [`fcode i18n:status [RESOURCESLUG]`](#fcode-i18nstatus-resourceslug)
 * [`fcode login`](#fcode-login)
 * [`fcode logout`](#fcode-logout)
 * [`fcode modules:add [RESOURCESLUG]`](#fcode-modulesadd-resourceslug)
@@ -290,6 +296,124 @@ EXAMPLES
   $ fcode http --auth-user admin --auth-password secret
 ```
 
+## `fcode i18n:add [RESOURCESLUG]`
+
+Keeps track of new local locales
+
+```
+USAGE
+  $ fcode i18n:add [RESOURCESLUG]
+
+ARGUMENTS
+  [RESOURCESLUG]  Resource slug
+
+DESCRIPTION
+  Keeps track of new local locales
+
+EXAMPLES
+  $ fcode i18n:add
+
+  $ fcode i18n:add pt-BR
+```
+
+## `fcode i18n:pull [RESOURCESLUG]`
+
+Fetch all locales from cloud and save them locally
+
+```
+USAGE
+  $ fcode i18n:pull [RESOURCESLUG] [-f]
+
+ARGUMENTS
+  [RESOURCESLUG]  Resource slug
+
+FLAGS
+  -f, --force  Force command
+
+DESCRIPTION
+  Fetch all locales from cloud and save them locally
+
+EXAMPLES
+  $ fcode i18n:pull
+```
+
+## `fcode i18n:push [RESOURCESLUG]`
+
+Create or update cloud locales from local ones
+
+```
+USAGE
+  $ fcode i18n:push [RESOURCESLUG] [-f]
+
+ARGUMENTS
+  [RESOURCESLUG]  Resource slug
+
+FLAGS
+  -f, --force  Force command
+
+DESCRIPTION
+  Create or update cloud locales from local ones
+
+EXAMPLES
+  $ fcode i18n:push
+
+  $ fcode i18n:push pt-BR
+```
+
+## `fcode i18n:remove [RESOURCESLUG]`
+
+Remove track of a local locale
+
+```
+USAGE
+  $ fcode i18n:remove [RESOURCESLUG]
+
+ARGUMENTS
+  [RESOURCESLUG]  Resource slug
+
+DESCRIPTION
+  Remove track of a local locale
+
+EXAMPLES
+  $ fcode i18n:remove pt-BR
+```
+
+## `fcode i18n:reset [RESOURCESLUG]`
+
+Reset locales with contents from current remote
+
+```
+USAGE
+  $ fcode i18n:reset [RESOURCESLUG]
+
+ARGUMENTS
+  [RESOURCESLUG]  Resource slug
+
+DESCRIPTION
+  Reset locales with contents from current remote
+
+EXAMPLES
+  $ fcode i18n:reset
+```
+
+## `fcode i18n:status [RESOURCESLUG]`
+
+List all locales status
+
+```
+USAGE
+  $ fcode i18n:status [RESOURCESLUG]
+
+ARGUMENTS
+  [RESOURCESLUG]  Resource slug
+
+DESCRIPTION
+  List all locales status
+
+EXAMPLES
+  $ fcode i18n:status
+```
+
 ## `fcode login`
 
 Login with your Factorial Code credentials (browser OAuth or email/password)
@@ -701,7 +825,8 @@ Run Factorial Code processes locally
 
 ```
 USAGE
-  $ fcode run SLUG [-p <value>] [-v <value>] [-l DEBUG|INFO|WARNING|ERROR] [-j] [-e <value>]
+  $ fcode run SLUG [-p <value>] [-v <value>] [-l DEBUG|INFO|WARNING|ERROR] [-j] [--locale <value>] [-e
+    <value>]
 
 ARGUMENTS
   SLUG  Process slug
@@ -713,6 +838,7 @@ FLAGS
                                <options: DEBUG|INFO|WARNING|ERROR>
   -p, --parameters=<value>     Parameters: stringified JSON or file path
   -v, --version=<value>        Process version
+      --locale=<value>         Locale fcode.i18n resolves against (defaults to the workspace primaryLocale)
 
 DESCRIPTION
   Run Factorial Code processes locally

package/dist/commands/add.js

@@ -4,7 +4,8 @@ const base_command_1 = require("../core/commands/base-command");
 const add_1 = require("./processes/add");
 const add_2 = require("./modules/add");
 const add_3 = require("./variables/add");
-const add_4 = require("./dependencies/add");
+const add_4 = require("./i18n/add");
+const add_5 = require("./dependencies/add");
 const cli_1 = require("../utils/cli");
 class AddCommand extends base_command_1.default {
     async run() {
@@ -15,6 +16,7 @@ class AddCommand extends base_command_1.default {
         await add_2.default.run([]);
         await add_3.default.run([]);
         await add_4.default.run([]);
+        await add_5.default.run([]);
     }
 }
 AddCommand.description = 'Keeps track of new local components';

package/dist/commands/clone.d.ts

@@ -13,6 +13,7 @@ export default class Clone extends Command {
     checkWorkspaceIsEmpty(slug: string): Promise<void>;
     cloneTeam(origin: TeamOrigin, skipSkillsSetup?: boolean): Promise<void>;
     createWorkspaceConfig(origin: TeamOrigin): Promise<void>;
+    createWorkspaceI18n(slug: string): void;
     createWorkspaceDatastore(slug: string): void;
     createWorkspaceStorage(slug: string): void;
     createWorkspaceGitIgnore(slug: string): Promise<void>;

package/dist/commands/clone.js

@@ -7,6 +7,7 @@ const path = require("node:path");
 const global_1 = require("../config/global");
 const workspace_1 = require("../config/workspace");
 const pull_1 = require("./pull");
+const team_access_1 = require("../services/team-access");
 const types_1 = require("../core/types");
 const cli_1 = require("../utils/cli");
 const settings_1 = require("../config/settings");
@@ -50,6 +51,7 @@ class Clone extends core_1.Command {
         await this.mkdirWorkspace(origin.slug);
         await this.createWorkspaceConfig(origin);
         await this.createWorkspaceGitIgnore(origin.slug);
+        this.createWorkspaceI18n(origin.slug);
         this.createWorkspaceDatastore(origin.slug);
         this.createWorkspaceStorage(origin.slug);
         await this.createWorkspaceLocalVariables(origin.slug);
@@ -63,6 +65,10 @@ class Clone extends core_1.Command {
         const config = new workspace_1.default(path.join(process.cwd(), origin.slug));
         await config.init(origin);
     }
+    // Created empty so `i18n:add` has somewhere to look before the first locale is pulled.
+    createWorkspaceI18n(slug) {
+        fs.mkdirpSync(path.join(slug, 'i18n'));
+    }
     createWorkspaceDatastore(slug) {
         fs.outputFileSync(path.join(slug, 'datastore.json'), '{}');
     }
@@ -115,6 +121,7 @@ class Clone extends core_1.Command {
         });
     }
     async catch(error) {
+        process.exitCode = 1;
         const suggestions = error?.suggestions ?? [];
         const hint = suggestions.length > 0 ? ` Try this: ${suggestions.map((suggestion) => `'${suggestion}'`).join('\n')} \n` : '';
         cli_1.default.error(error.message + hint);
@@ -175,8 +182,19 @@ class Clone extends core_1.Command {
         if (skipSkillsSetup === undefined) {
             skipSkillsSetup = (await new global_1.default().getSetting(settings_1.SettingKeys.SKIP_SKILLS_SETUP)) === 'true';
         }
+        // Pre-flight access check so a session without access to the team fails here,
+        // before any workspace directory, config, or skills are created.
+        await team_access_1.default.ensureTeamAccess(url, slug);
         await this.cloneTeam({ url, slug }, skipSkillsSetup);
-        cli_1.default.log(`\n🎉  ${args.team} team workspace cloned successfully!\n`);
+        // Failed pulls don't abort the clone: each sub-pull reports through
+        // BaseCommand.catch, which prints and sets a non-zero exit code.
+        if (process.exitCode) {
+            cli_1.default.log(`\n⚠️  '${args.team}' team workspace cloned with errors — some resources failed to pull.`);
+            cli_1.default.log(`   Fix the errors above, then run 'fcode pull' inside the workspace.\n`);
+        }
+        else {
+            cli_1.default.log(`\n🎉  ${args.team} team workspace cloned successfully!\n`);
+        }
         cli_1.default.log(`$ cd ${slug}\n`);
     }
 }

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

@@ -0,0 +1,9 @@
+import I18nCommand from '../../core/commands/i18n-command';
+export default class I18nAdd extends I18nCommand {
+    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/i18n/add.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const i18n_command_1 = require("../../core/commands/i18n-command");
+const types_1 = require("../../core/types");
+class I18nAdd extends i18n_command_1.default {
+    async run() {
+        await super.addResources();
+    }
+}
+I18nAdd.description = 'Keeps track of new local locales';
+I18nAdd.examples = ['$ fcode i18n:add', '$ fcode i18n:add pt-BR'];
+I18nAdd.args = types_1.ResourceSlugArg;
+exports.default = I18nAdd;

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

@@ -0,0 +1,12 @@
+import I18nCommand from '../../core/commands/i18n-command';
+export default class I18nPull extends I18nCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        resourceSlug: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/i18n/pull.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const i18n_command_1 = require("../../core/commands/i18n-command");
+const types_1 = require("../../core/types");
+class I18nPull extends i18n_command_1.default {
+    async run() {
+        await super.pullResources();
+    }
+}
+I18nPull.description = 'Fetch all locales from cloud and save them locally';
+I18nPull.examples = ['$ fcode i18n:pull'];
+I18nPull.args = types_1.ResourceSlugArg;
+I18nPull.flags = types_1.ForceFlag;
+exports.default = I18nPull;

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

@@ -0,0 +1,12 @@
+import I18nCommand from '../../core/commands/i18n-command';
+export default class I18nPush extends I18nCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        resourceSlug: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/i18n/push.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const i18n_command_1 = require("../../core/commands/i18n-command");
+const types_1 = require("../../core/types");
+class I18nPush extends i18n_command_1.default {
+    async run() {
+        await super.pushResources();
+    }
+}
+I18nPush.description = 'Create or update cloud locales from local ones';
+I18nPush.examples = ['$ fcode i18n:push', '$ fcode i18n:push pt-BR'];
+I18nPush.args = types_1.ResourceSlugArg;
+I18nPush.flags = types_1.ForceFlag;
+exports.default = I18nPush;

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

@@ -0,0 +1,9 @@
+import I18nCommand from '../../core/commands/i18n-command';
+export default class I18nRemove extends I18nCommand {
+    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/i18n/remove.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const color_1 = require("@oclif/color");
+const i18n_command_1 = require("../../core/commands/i18n-command");
+const types_1 = require("../../core/types");
+const cli_1 = require("../../utils/cli");
+class I18nRemove extends i18n_command_1.default {
+    async run() {
+        if (!this.resourceSlug) {
+            cli_1.default.log(color_1.default.red(`You must specify a locale`));
+            return;
+        }
+        await super.removeResource(this.resourceSlug);
+    }
+}
+I18nRemove.description = 'Remove track of a local locale';
+I18nRemove.examples = ['$ fcode i18n:remove pt-BR'];
+I18nRemove.args = types_1.ResourceSlugArg;
+exports.default = I18nRemove;

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

@@ -0,0 +1,9 @@
+import I18nCommand from '../../core/commands/i18n-command';
+export default class I18nReset extends I18nCommand {
+    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/i18n/reset.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const i18n_command_1 = require("../../core/commands/i18n-command");
+const types_1 = require("../../core/types");
+class I18nReset extends i18n_command_1.default {
+    async run() {
+        await super.resetResources();
+    }
+}
+I18nReset.description = 'Reset locales with contents from current remote';
+I18nReset.examples = ['$ fcode i18n:reset'];
+I18nReset.args = types_1.ResourceSlugArg;
+exports.default = I18nReset;

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

@@ -0,0 +1,11 @@
+import I18nCommand from '../../core/commands/i18n-command';
+import { MergedResource } from '../../core/types';
+export default class I18nStatus extends I18nCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        resourceSlug: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    resourcesTableLog(resources: Array<MergedResource>): Promise<void>;
+    run(): Promise<void>;
+}

package/dist/commands/i18n/status.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const i18n_command_1 = require("../../core/commands/i18n-command");
+const types_1 = require("../../core/types");
+const colorize_resource_1 = require("../../utils/colorize-resource");
+const cli_1 = require("../../utils/cli");
+class I18nStatus extends i18n_command_1.default {
+    async resourcesTableLog(resources) {
+        const hasInherited = resources.some((resource) => resource.resolvingTeamSlug);
+        cli_1.cli.table(resources, {
+            locale: {
+                // The identifier, not the slug: an inherited file is tracked as `en.inherited`, and the
+                // workspace it comes from already has its own column.
+                get({ locale, slug, status }) {
+                    return (0, colorize_resource_1.colorizeByStatus)(String(locale ?? slug), status);
+                },
+                header: 'locale',
+            },
+            ...(hasInherited && {
+                inherited: {
+                    get(resource) {
+                        return (0, colorize_resource_1.colorizeByStatus)(resource.resolvingTeamSlug ? `🔗 ${resource.resolvingTeamSlug}` : '', resource.status);
+                    },
+                    header: 'inherited',
+                },
+            }),
+            status: {
+                get({ status }) {
+                    return (0, colorize_resource_1.colorizeByStatus)(status, status);
+                },
+                header: 'status',
+            },
+        }, { sort: 'locale' });
+    }
+    async run() {
+        await this.resourcesLog();
+    }
+}
+I18nStatus.description = 'List all locales status';
+I18nStatus.examples = ['$ fcode i18n:status'];
+I18nStatus.args = types_1.ResourceSlugArg;
+exports.default = I18nStatus;

package/dist/commands/pull.js

@@ -4,8 +4,9 @@ const base_command_1 = require("../core/commands/base-command");
 const pull_1 = require("./modules/pull");
 const pull_2 = require("./processes/pull");
 const pull_3 = require("./variables/pull");
-const pull_4 = require("./dependencies/pull");
-const pull_5 = require("./team/pull");
+const pull_4 = require("./i18n/pull");
+const pull_5 = require("./dependencies/pull");
+const pull_6 = require("./team/pull");
 const types_1 = require("../core/types");
 const gitignore_1 = require("../utils/gitignore");
 class PullCommand extends base_command_1.default {
@@ -19,9 +20,10 @@ class PullCommand extends base_command_1.default {
         await pull_1.default.run(args);
         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
         // error-handler process id to its slug.
-        await pull_5.default.run([]);
+        await pull_6.default.run([]);
         // Keep inherited resources out of git now that all resource metadata is saved.
         await (0, gitignore_1.syncInheritedGitignore)();
     }

package/dist/commands/push.js

@@ -4,8 +4,9 @@ const base_command_1 = require("../core/commands/base-command");
 const push_1 = require("./modules/push");
 const push_2 = require("./processes/push");
 const push_3 = require("./variables/push");
-const push_4 = require("./dependencies/push");
-const push_5 = require("./team/push");
+const push_4 = require("./i18n/push");
+const push_5 = require("./dependencies/push");
+const push_6 = require("./team/push");
 const types_1 = require("../core/types");
 class PushCommand extends base_command_1.default {
     async run() {
@@ -18,9 +19,10 @@ class PushCommand extends base_command_1.default {
         await push_1.default.run(args);
         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
         // its slug to an id.
-        await push_5.default.run(args);
+        await push_6.default.run(args);
     }
 }
 PushCommand.description = 'Update cloud team workspace with local workspace';

package/dist/commands/reset.js

@@ -4,7 +4,8 @@ const core_1 = require("@oclif/core");
 const reset_1 = require("./processes/reset");
 const reset_2 = require("./modules/reset");
 const reset_3 = require("./variables/reset");
-const reset_4 = require("./dependencies/reset");
+const reset_4 = require("./i18n/reset");
+const reset_5 = require("./dependencies/reset");
 class Reset extends core_1.Command {
     async run() {
         await this.parse(Reset);
@@ -12,6 +13,7 @@ class Reset extends core_1.Command {
         await reset_2.default.run([]);
         await reset_3.default.run([]);
         await reset_4.default.run([]);
+        await reset_5.default.run([]);
     }
 }
 Reset.description = 'Reset team workspace with contents from current remote';

package/dist/commands/run.d.ts

@@ -10,6 +10,7 @@ export default class Run extends Command {
         version: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         logLevel: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         jsonLogs: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         variablesFile: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;

package/dist/commands/run.js

@@ -6,7 +6,7 @@ const core_2 = require("@oclif/core");
 const process_runner_1 = require("../services/process-runner");
 class Run extends core_2.Command {
     async run() {
-        const { args: { slug }, flags: { parameters: parametersFlag, version, logLevel, jsonLogs, variablesFile }, } = await this.parse(Run);
+        const { args: { slug }, flags: { parameters: parametersFlag, version, logLevel, jsonLogs, variablesFile, locale }, } = await this.parse(Run);
         let parameters;
         if (parametersFlag) {
             try {
@@ -16,7 +16,7 @@ class Run extends core_2.Command {
                 parameters = await Promise.resolve(`${path.resolve(parametersFlag)}`).then(s => require(s));
             }
         }
-        await (0, process_runner_1.runProcess)({ slug, parameters, version, logLevel, jsonLogs, extraVariablesFile: variablesFile });
+        await (0, process_runner_1.runProcess)({ slug, parameters, version, logLevel, jsonLogs, extraVariablesFile: variablesFile, locale });
     }
 }
 Run.args = {
@@ -48,6 +48,9 @@ Run.flags = {
         description: 'Output process logs as newline-delimited JSON (NDJSON)',
         default: false,
     }),
+    locale: core_1.Flags.string({
+        description: 'Locale fcode.i18n resolves against (defaults to the workspace primaryLocale)',
+    }),
     variablesFile: core_1.Flags.string({
         char: 'e',
         description: 'Path to a .env file whose variables override workspace variables',

package/dist/commands/status.js

@@ -4,8 +4,9 @@ const base_command_1 = require("../core/commands/base-command");
 const status_1 = require("./modules/status");
 const status_2 = require("./processes/status");
 const status_3 = require("./variables/status");
-const status_4 = require("./dependencies/status");
-const status_5 = require("./team/status");
+const status_4 = require("./i18n/status");
+const status_5 = require("./dependencies/status");
+const status_6 = require("./team/status");
 class Status extends base_command_1.default {
     async run() {
         await this.parse(Status);
@@ -15,6 +16,7 @@ class Status extends base_command_1.default {
         await status_3.default.run([]);
         await status_4.default.run([]);
         await status_5.default.run([]);
+        await status_6.default.run([]);
     }
 }
 Status.description = 'Show team workspace status';

package/dist/commands/team/push.js

@@ -38,6 +38,9 @@ class TeamPushCommand extends api_client_command_1.default {
         update.webhookAuth = team.webhookAuth
             ? { headerName: team.webhookAuth.headerName ?? null, variableKey: team.webhookAuth.variableKey }
             : { variableKey: null };
+        // Sent unconditionally for the same reason as webhookAuth: team.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 ?? '';
         await this._fcodeGraphQLClient.pushTeam(update);
         await this.workspaceConfig.setTeamStoredHash(team.contentHash);
         cli_1.default.log(color_1.default.green('✅ team settings pushed'));

package/dist/config/remote.js

@@ -47,7 +47,7 @@ class RemoteConfig {
         return this;
     }
     init() {
-        fs.writeJsonSync(this.configPath, { slug: this.remote, modules: {}, processes: {}, variables: {}, dependencies: {}, team: {} }, { spaces: 2 });
+        fs.writeJsonSync(this.configPath, { slug: this.remote, modules: {}, processes: {}, variables: {}, i18n: {}, dependencies: {}, team: {} }, { spaces: 2 });
     }
     createDir(configPath) {
         if (!fs.pathExistsSync(configPath)) {

package/dist/config/workspace.js

@@ -85,6 +85,12 @@ class WorkspaceConfig extends index_1.default {
         else if (resourceType === 'variables') {
             return team.variables;
         }
+        else if (resourceType === 'i18n') {
+            // Defaulted rather than required: workspaces cloned before locales existed have no `i18n`
+            // key in their sync metadata, and pulling should populate it instead of failing.
+            team.i18n ||= {};
+            return team.i18n;
+        }
         else if (resourceType === 'dependencies') {
             return team.dependencies;
         }
@@ -100,6 +106,10 @@ class WorkspaceConfig extends index_1.default {
         else if (resource instanceof types_1.Variable) {
             return team.variables;
         }
+        else if (resource instanceof types_1.Locale) {
+            team.i18n ||= {};
+            return team.i18n;
+        }
         else if (resource instanceof types_1.ProgrammingLanguageManifest) {
             return team.dependencies;
         }

package/dist/core/commands/api-client-command.d.ts

@@ -3,4 +3,5 @@ import FcodeGraphQLClient from '../../services/fcode-graphql-client';
 export default abstract class ApiClientCommand extends BaseCommand {
     _fcodeGraphQLClient: FcodeGraphQLClient;
     init(): Promise<void>;
+    protected onSessionRefreshed(): Promise<void>;
 }

package/dist/core/commands/api-client-command.js

@@ -26,5 +26,10 @@ class ApiClientCommand extends base_command_1.default {
             throw error;
         }
     }
+    async onSessionRefreshed() {
+        const { url } = await this.workspaceConfig.getTeamOrigin();
+        const { token: { access_token: accessToken }, } = await this.globalConfig.getAuthInfo(url);
+        this._fcodeGraphQLClient.setAccessToken(accessToken);
+    }
 }
 exports.default = ApiClientCommand;

package/dist/core/commands/base-command.d.ts

@@ -5,7 +5,9 @@ export default abstract class BaseCommand extends Command {
     url?: string;
     globalConfig: GlobalConfig;
     workspaceConfig: WorkspaceConfig;
+    private sessionRefreshRetried;
     catch(error: any): Promise<any>;
     init(url?: string): Promise<void>;
+    protected onSessionRefreshed(): Promise<void>;
     protected logActiveTeam(): Promise<void>;
 }