@factorialco/fcode-cli 2.0.0 → 2.2.0

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/aliases/delete.d.ts

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

package/dist/commands/team/aliases/delete.js

@@ -0,0 +1,28 @@
+"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 cli_1 = require("../../../utils/cli");
+class TeamAliasesDeleteCommand extends api_client_command_1.default {
+    async run() {
+        const { args: { name }, } = await this.parse(TeamAliasesDeleteCommand);
+        const aliases = await this._fcodeGraphQLClient.allTeamVersionAliases();
+        const alias = aliases.find((candidate) => candidate.name === name);
+        if (!alias) {
+            cli_1.default.error(`Alias ${name} does not exist`);
+            return;
+        }
+        cli_1.default.log(color_1.default.cyan(`\n🗑️  deleting alias ${name}...`));
+        await this._fcodeGraphQLClient.deleteTeamVersionAlias(alias.id);
+        cli_1.default.log(color_1.default.green(`✅ alias ${name} deleted`));
+        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 = {
+    name: core_1.Args.string({ description: 'alias name to delete', required: true }),
+};
+exports.default = TeamAliasesDeleteCommand;

package/dist/commands/team/aliases/list.d.ts

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

package/dist/commands/team/aliases/list.js

@@ -0,0 +1,23 @@
+"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 cli_1 = require("../../../utils/cli");
+class TeamAliasesListCommand extends api_client_command_1.default {
+    async run() {
+        await this.parse(TeamAliasesListCommand);
+        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]')}`);
+            return;
+        }
+        cli_1.default.log('🔗 Team 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;

package/dist/commands/team/aliases/set.d.ts

@@ -0,0 +1,10 @@
+import ApiClientCommand from '../../../core/commands/api-client-command';
+export default class TeamAliasesSetCommand extends ApiClientCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        tag: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/team/aliases/set.js

@@ -0,0 +1,25 @@
+"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 cli_1 = require("../../../utils/cli");
+class TeamAliasesSetCommand extends api_client_command_1.default {
+    async run() {
+        const { args: { name, tag }, } = await this.parse(TeamAliasesSetCommand);
+        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.
+        await pull_1.default.run([]);
+    }
+}
+TeamAliasesSetCommand.description = 'Create or re-point a team 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 = {
+    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 }),
+};
+exports.default = TeamAliasesSetCommand;

package/dist/commands/team/pull.js

@@ -12,9 +12,16 @@ class TeamPullCommand extends api_client_command_1.default {
     async run() {
         await this.parse(TeamPullCommand);
         cli_1.default.log(color_1.default.cyan('\n🗄️  pulling team settings...'));
-        const raw = await this._fcodeGraphQLClient.team();
+        const [raw, versions, aliases] = await Promise.all([
+            this._fcodeGraphQLClient.team(),
+            this._fcodeGraphQLClient.allTeamVersions(),
+            this._fcodeGraphQLClient.allTeamVersionAliases(),
+        ]);
         const team = await this._teamRepository.fromRaw(raw);
+        this._teamRepository.applyCloudVersioning(team, versions, aliases);
         this._teamRepository.save(team);
+        // The stored hash intentionally excludes versions/aliases (see Team.contentHash), so
+        // pull-only fields never surface as a phantom MODIFIED state.
         await this.workspaceConfig.setTeamStoredHash(team.contentHash);
     }
 }

package/dist/commands/team/push.js

@@ -22,6 +22,9 @@ class TeamPushCommand extends api_client_command_1.default {
             cli_1.default.log('Team settings already up to date');
             return;
         }
+        // team.json's `versions`/`aliases` fields are pull-only and intentionally left out of the
+        // update payload: team versions and aliases are only written through the explicit
+        // team:versions/team:aliases commands.
         const update = { parentTeamSlugs: team.parentTeamSlugs };
         if (team.zoneId !== undefined) {
             update.zoneId = team.zoneId;
@@ -35,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/commands/team/versions/create.d.ts

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

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

@@ -0,0 +1,42 @@
+"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 cli_1 = require("../../../utils/cli");
+class TeamVersionsCreateCommand 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 teamVersion = await this._fcodeGraphQLClient.createTeamVersion(tag, comment);
+        const failedCount = this.logManifest(teamVersion);
+        // Refresh the local workspace: per-entity versions/<tag>/ folders and team.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 });
+        }
+    }
+    logManifest(teamVersion) {
+        const created = teamVersion.manifest.filter(({ outcome }) => outcome === 'CREATED');
+        const skipped = teamVersion.manifest.filter(({ outcome }) => outcome === 'SKIPPED_EXISTS');
+        const failed = teamVersion.manifest.filter(({ outcome }) => outcome === 'FAILED');
+        cli_1.default.log(color_1.default.green(`✅ ${created.length} created`) + `, ${skipped.length} skipped (tag already exists)` + (failed.length > 0 ? `, ${color_1.default.red(`${failed.length} failed`)}` : ''));
+        for (const entry of failed) {
+            cli_1.default.error(`${entry.resourceType.toLowerCase()} ${entry.slug} — ${entry.error ?? 'unknown error'}`);
+        }
+        return failed.length;
+    }
+}
+TeamVersionsCreateCommand.description = 'Publish a team 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 = {
+    tag: core_1.Args.string({ description: 'version tag to publish (e.g. v1.0.0)', required: true }),
+};
+TeamVersionsCreateCommand.flags = {
+    comment: core_1.Flags.string({ char: 'c', description: 'comment describing the version' }),
+};
+exports.default = TeamVersionsCreateCommand;

package/dist/commands/team/versions/delete.d.ts

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

package/dist/commands/team/versions/delete.js

@@ -0,0 +1,32 @@
+"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 types_1 = require("../../../core/types");
+const cli_1 = require("../../../utils/cli");
+class TeamVersionsDeleteCommand extends api_client_command_1.default {
+    async run() {
+        const { args: { tag }, flags: { force }, } = await this.parse(TeamVersionsDeleteCommand);
+        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?`);
+            if (!confirmed) {
+                return;
+            }
+        }
+        cli_1.default.log(color_1.default.cyan(`\n🗑️  deleting team version ${tag}...`));
+        await this._fcodeGraphQLClient.deleteTeamVersion(tag);
+        cli_1.default.log(color_1.default.green(`✅ team 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, ' +
+    'together with the aliases, executions and schedules that reference them';
+TeamVersionsDeleteCommand.examples = ['$ fcode team:versions:delete v1.0.0'];
+TeamVersionsDeleteCommand.args = {
+    tag: core_1.Args.string({ description: 'version tag to delete', required: true }),
+};
+TeamVersionsDeleteCommand.flags = types_1.ForceFlag;
+exports.default = TeamVersionsDeleteCommand;

package/dist/commands/team/versions/list.d.ts

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

package/dist/commands/team/versions/list.js

@@ -0,0 +1,25 @@
+"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 cli_1 = require("../../../utils/cli");
+class TeamVersionsListCommand extends api_client_command_1.default {
+    async run() {
+        await this.parse(TeamVersionsListCommand);
+        const versions = await this._fcodeGraphQLClient.allTeamVersions();
+        if (versions.length === 0) {
+            cli_1.default.log('📋 No team versions published yet.');
+            cli_1.default.log(`Publish one with ${color_1.default.cyan('fcode team:versions:create [tag]')}`);
+            return;
+        }
+        cli_1.default.log('🏷️  Team versions:\n');
+        for (const version of versions) {
+            const comment = version.comment ? ` — ${version.comment}` : '';
+            const author = version.createdBy?.name ? ` by ${version.createdBy.name}` : '';
+            cli_1.default.log(`  ${color_1.default.cyan(version.tag)}${comment} (${version.createdAt}${author})`);
+        }
+    }
+}
+TeamVersionsListCommand.description = 'List the team versions published on the active team workspace';
+TeamVersionsListCommand.examples = ['$ fcode team:versions:list'];
+exports.default = TeamVersionsListCommand;

package/dist/commands/variables/status.js

@@ -11,6 +11,7 @@ class VariablesStatus extends variables_command_1.default {
     async resourcesTableLog(resources) {
         const globalConfig = new global_1.default();
         const localVariablesFileName = await globalConfig.getSetting(settings_1.SettingKeys.LOCAL_VARIABLES_FILE_NAME);
+        const hasInherited = resources.some((resource) => resource.resolvingTeamSlug);
         cli_1.cli.table(resources, {
             key: {
                 get({ key, status }) {
@@ -18,6 +19,16 @@ class VariablesStatus extends variables_command_1.default {
                 },
                 header: 'key',
             },
+            ...(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);

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

@@ -8,6 +8,7 @@ export declare enum SettingKeys {
     IGNORE_PROCESS_VERSIONS = "ignoreProcessVersions",
     IGNORE_WORKSPACE_NOT_EMPTY = "ignoreWorkspaceNotEmpty",
     IGNORE_FCODE_RUN_PROCESSES = "ignoreFcodeRunProcesses",
+    INHERITED_VARIABLES_FILE_NAME = "inheritedVariablesFileName",
     LOCAL_VARIABLES_FILE_NAME = "localVariablesFileName",
     SKIP_SKILLS_SETUP = "skipSkillsSetup",
     VARIABLES_FILE_NAME = "variablesFileName"

package/dist/config/settings.js

@@ -8,6 +8,7 @@ var SettingKeys;
     SettingKeys["IGNORE_PROCESS_VERSIONS"] = "ignoreProcessVersions";
     SettingKeys["IGNORE_WORKSPACE_NOT_EMPTY"] = "ignoreWorkspaceNotEmpty";
     SettingKeys["IGNORE_FCODE_RUN_PROCESSES"] = "ignoreFcodeRunProcesses";
+    SettingKeys["INHERITED_VARIABLES_FILE_NAME"] = "inheritedVariablesFileName";
     SettingKeys["LOCAL_VARIABLES_FILE_NAME"] = "localVariablesFileName";
     SettingKeys["SKIP_SKILLS_SETUP"] = "skipSkillsSetup";
     SettingKeys["VARIABLES_FILE_NAME"] = "variablesFileName";
@@ -48,6 +49,11 @@ exports.SETTINGS_DEFINITIONS = [
         default: 'variables.local.env',
         description: 'Local variables file name',
     },
+    {
+        key: SettingKeys.INHERITED_VARIABLES_FILE_NAME,
+        default: 'variables.inherited.env',
+        description: 'File holding the variables inherited from parent workspaces (read-only, gitignored)',
+    },
 ];
 function getSettingDefault(key) {
     return exports.SETTINGS_DEFINITIONS.find((def) => def.key === key)?.default;

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/i18n-command.d.ts

@@ -0,0 +1,5 @@
+import { Locale } from '../types';
+import ResourceCommand from './resource-command';
+export default abstract class I18nCommand extends ResourceCommand<Locale> {
+    init(): Promise<void>;
+}

package/dist/core/commands/i18n-command.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const locale_1 = require("../../repositories/locale");
+const resource_merger_1 = require("../resource-merger");
+const resource_pusher_1 = require("../resource-pusher");
+const resource_command_1 = require("./resource-command");
+class I18nCommand extends resource_command_1.default {
+    async init() {
+        await super.init();
+        this._resourceRepository = new locale_1.default();
+        this._resourceMerger = new resource_merger_1.default(this._resourceRepository);
+        this._resourcePusher = new resource_pusher_1.default(this._resourceRepository, this._fcodeGraphQLClient);
+        this._resourceQuery = () => this._fcodeGraphQLClient.allLocales.bind(this._fcodeGraphQLClient)();
+    }
+}
+exports.default = I18nCommand;

package/dist/core/errors.d.ts

@@ -30,6 +30,12 @@ export declare class LocalVariableNotFound extends ResourceNotFound {
 export declare class CloudVariableNotFound extends ResourceNotFound {
     constructor(error: Error | string, variableId: string);
 }
+export declare class LocalLocaleNotFound extends ResourceNotFound {
+    constructor(error: Error | string, locale: string);
+}
+export declare class CloudLocaleNotFound extends ResourceNotFound {
+    constructor(error: Error | string, locale: string);
+}
 export declare class LocalProgrammingLanguageManifestNotFound extends ResourceNotFound {
     constructor(error: Error | string, programmingLanguageManifestId: string);
 }

package/dist/core/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorExecutingProcess = exports.ProcessDependenciesNotInstalled = exports.DependenciesNotInstalled = exports.NotFcodeWorkspace = exports.NotAuthenticated = exports.CloudProgrammingLanguageManifestNotFound = exports.LocalProgrammingLanguageManifestNotFound = exports.CloudVariableNotFound = exports.LocalVariableNotFound = exports.CloudScriptLibraryNotFound = exports.LocalScriptLibraryNotFound = exports.CloudProcessNotFound = exports.LocalProcessNotFound = exports.ResourceNotFound = exports.CLIError = void 0;
+exports.ErrorExecutingProcess = exports.ProcessDependenciesNotInstalled = exports.DependenciesNotInstalled = exports.NotFcodeWorkspace = exports.NotAuthenticated = exports.CloudProgrammingLanguageManifestNotFound = exports.LocalProgrammingLanguageManifestNotFound = exports.CloudLocaleNotFound = exports.LocalLocaleNotFound = exports.CloudVariableNotFound = exports.LocalVariableNotFound = exports.CloudScriptLibraryNotFound = exports.LocalScriptLibraryNotFound = exports.CloudProcessNotFound = exports.LocalProcessNotFound = exports.ResourceNotFound = exports.CLIError = void 0;
 const global_1 = require("../config/global");
 class CLIError extends Error {
     constructor(message, options) {
@@ -74,6 +74,24 @@ class CloudVariableNotFound extends ResourceNotFound {
     }
 }
 exports.CloudVariableNotFound = CloudVariableNotFound;
+class LocalLocaleNotFound extends ResourceNotFound {
+    constructor(error, locale) {
+        super(error, 'Locale', locale, {
+            code: 'ERR_LOCAL_LOCALE_NOT_FOUND',
+            suggestions: [],
+        });
+    }
+}
+exports.LocalLocaleNotFound = LocalLocaleNotFound;
+class CloudLocaleNotFound extends ResourceNotFound {
+    constructor(error, locale) {
+        super(error, 'Locale', locale, {
+            code: 'ERR_CLOUD_LOCALE_NOT_FOUND',
+            suggestions: [],
+        });
+    }
+}
+exports.CloudLocaleNotFound = CloudLocaleNotFound;
 class LocalProgrammingLanguageManifestNotFound extends ResourceNotFound {
     constructor(error, programmingLanguageManifestId) {
         super(error, 'ProgrammingLanguageManifest', programmingLanguageManifestId, {

package/dist/core/executors/execution-task.js

@@ -4,6 +4,7 @@ const node_child_process_1 = require("node:child_process");
 const fs = require("node:fs");
 const os = require("node:os");
 const path = require("node:path");
+const locale_resolver_1 = require("../../services/locale-resolver");
 const errors_1 = require("../errors");
 const cli_1 = require("../../utils/cli");
 const dependencies_1 = require("../utils/dependencies");
@@ -114,6 +115,9 @@ class ExecutionTask {
             },
             variables: this.getVariablesObject(),
             request: this._options.request ?? 'No request, you are using the CLI',
+            // Layered here rather than in the generated runtime: the cloud ships one already-merged
+            // flat map, and a local run has to resolve fcode.i18n against the same shape.
+            i18n: (0, locale_resolver_1.resolveLocalTranslations)(this._options.locale),
         };
     }
     async prepare() {

package/dist/core/executors/javascript-execution-task.js

@@ -111,7 +111,12 @@ const main = typeof _hooksModule['${fn}'] === 'function'
       };`}
 
       global.fcode = {
-        import: (moduleName, version) => {
+        // A version is either a bare string or an options object ({ version: 'v1' }), the
+        // form every other versioned helper takes — the cloud reads both, so a local run must too.
+        import: (moduleName, tagOrOptions) => {
+          const version = typeof tagOrOptions === 'string'
+            ? tagOrOptions
+            : (tagOrOptions && typeof tagOrOptions === 'object' ? tagOrOptions.version : undefined);
           let modulePath = require('path').join('${process.cwd()}', 'modules', moduleName);
           if(version) {
             modulePath = require('path').join(modulePath, 'versions', version)
@@ -588,6 +593,26 @@ const main = typeof _hooksModule['${fn}'] === 'function'
             }
           };
         })(),
+        // The third argument is the version options the cloud honours. A workspace directory holds
+        // no published snapshots, so a pinned call resolves against the files on disk — the same
+        // per-file fallback the cloud applies to a locale that was never published at that tag.
+        // Own properties only and no array arguments, exactly like the cloud executors.
+        i18n: Object.assign((key, args, _options) => {
+          const translations = ${JSON.stringify(metadata.i18n.translations, null, 2)};
+          const template = Object.hasOwn(translations, key) ? translations[key] : undefined;
+          if (template === undefined) {
+            return key;
+          }
+          if (!args || typeof args !== 'object' || Array.isArray(args)) {
+            return template;
+          }
+          // Single pass, so a substituted value containing %{...} is never rescanned.
+          return template.replace(/%\{([^}]*)\}/g, (match, name) => {
+            const trimmed = name.trim();
+            const value = Object.hasOwn(args, trimmed) ? args[trimmed] : undefined;
+            return value === undefined || value === null ? match : String(value);
+          });
+        }, { locale: ${JSON.stringify(metadata.i18n.locale ?? null)} }),
         sendMail: async ({ to, subject, text, html } = {}) => {
           // No manager locally: log the email contents instead of sending, so
           // devs can see exactly what would be delivered when run in the cloud.

package/dist/core/resource-pusher.js

@@ -82,6 +82,16 @@ class ResourcePusher {
                 const createdVariable = await this._fcodeGraphQLClient.pushVariable(variable);
                 return this._repository.save(createdVariable);
             }
+            if (this._repository._repositoryName === 'i18n') {
+                const locale = resource;
+                // The recorded id is only a hint: pushing an identifier a parent workspace owns has to
+                // create an override here, so the update path is taken only for a locale this workspace
+                // already owns.
+                const pushed = locale.id && !locale.resolvingTeamSlug
+                    ? await this._fcodeGraphQLClient.updateLocale(locale)
+                    : await this._fcodeGraphQLClient.pushLocale(locale);
+                return this._repository.save(pushed);
+            }
             if (this._repository._repositoryName === 'dependencies') {
                 const updatedProgrammingLanguageManifests = await this._fcodeGraphQLClient.pushProgrammingLanguageManifest(resource);
                 return this._repository.save(updatedProgrammingLanguageManifests);
@@ -114,6 +124,11 @@ class ResourcePusher {
             if (this._repository._repositoryName === 'variables') {
                 await this._fcodeGraphQLClient.removeVariable(resource.id);
             }
+            if (this._repository._repositoryName === 'i18n') {
+                // By identifier, not slug: an inherited locale is tracked under a qualified slug, and only
+                // this workspace's own locales — where the two coincide — ever reach a remote delete.
+                await this._fcodeGraphQLClient.removeLocale(resource.locale);
+            }
             this._repository.removeMetadata(resource.slug);
         }
         catch (error) {