@factorialco/fcode-cli 2.2.0 → 2.4.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @factorialco/fcode-cli
 $ fcode COMMAND
 running command...
 $ fcode (--version)
-@factorialco/fcode-cli/2.2.0 linux-x64 node-v22.22.3
+@factorialco/fcode-cli/2.4.0 linux-x64 node-v22.22.3
 $ fcode --help [COMMAND]
 USAGE
   $ fcode COMMAND
@@ -998,14 +998,17 @@ EXAMPLES
 
 ## `fcode team:pull`
 
-Fetch team settings (timezone, error handler, inheritance) from cloud into team.json
+Fetch team settings (timezone, error handler, inheritance) and team versions/aliases from cloud into team.json
 
 ```
 USAGE
-  $ fcode team:pull
+  $ fcode team:pull [-f]
+
+FLAGS
+  -f, --force  Force command
 
 DESCRIPTION
-  Fetch team settings (timezone, error handler, inheritance) from cloud into team.json
+  Fetch team settings (timezone, error handler, inheritance) and team versions/aliases from cloud into team.json
 
 EXAMPLES
   $ fcode team:pull
@@ -1013,7 +1016,7 @@ EXAMPLES
 
 ## `fcode team:push`
 
-Update cloud team settings (timezone, error handler, inheritance, webhook auth) from team.json
+Update cloud team settings (timezone, error handler, inheritance, webhook auth) and sync team versions/aliases from team.json
 
 ```
 USAGE
@@ -1023,7 +1026,8 @@ FLAGS
   -f, --force  Force command
 
 DESCRIPTION
-  Update cloud team settings (timezone, error handler, inheritance, webhook auth) from team.json
+  Update cloud team settings (timezone, error handler, inheritance, webhook auth) and sync team versions/aliases from
+  team.json
 
 EXAMPLES
   $ fcode team:push
@@ -1031,14 +1035,14 @@ EXAMPLES
 
 ## `fcode team:status`
 
-Show whether team settings (timezone, error handler, inheritance) differ from the cloud
+Show whether team settings (timezone, error handler, inheritance) or team versions/aliases differ from the cloud
 
 ```
 USAGE
   $ fcode team:status
 
 DESCRIPTION
-  Show whether team settings (timezone, error handler, inheritance) differ from the cloud
+  Show whether team settings (timezone, error handler, inheritance) or team versions/aliases differ from the cloud
 
 EXAMPLES
   $ fcode team:status

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");
@@ -120,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);
@@ -180,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/dependencies/status.d.ts

@@ -1,9 +1,20 @@
+import { table } from '../../utils/cli/styled/table';
 import DependencyCommand from '../../core/commands/dependency-command';
+import { type MergedResource } from '../../core/types';
+export declare const inheritedCount: (resource: MergedResource) => number;
+/**
+ * A manifest is never itself inherited — every workspace owns one per language — so the column
+ * counts the entries its parents contribute rather than naming one workspace the way the other
+ * `status` commands do. Empty when nothing is inherited, so the column is dropped entirely, like
+ * theirs.
+ */
+export declare const inheritedColumn: (resources: Array<MergedResource>) => table.Columns<MergedResource>;
 export default class DependenciesStatus extends DependencyCommand {
     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/dependencies/status.js

@@ -1,8 +1,51 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.inheritedColumn = exports.inheritedCount = void 0;
+const cli_1 = require("../../utils/cli");
 const dependency_command_1 = require("../../core/commands/dependency-command");
 const types_1 = require("../../core/types");
+const colorize_resource_1 = require("../../utils/colorize-resource");
+const inheritedCount = (resource) => resource.inheritedDependencies?.length ?? 0;
+exports.inheritedCount = inheritedCount;
+/**
+ * A manifest is never itself inherited — every workspace owns one per language — so the column
+ * counts the entries its parents contribute rather than naming one workspace the way the other
+ * `status` commands do. Empty when nothing is inherited, so the column is dropped entirely, like
+ * theirs.
+ */
+const inheritedColumn = (resources) => {
+    if (!resources.some((resource) => (0, exports.inheritedCount)(resource) > 0)) {
+        return {};
+    }
+    return {
+        inherited: {
+            get(resource) {
+                const count = (0, exports.inheritedCount)(resource);
+                return (0, colorize_resource_1.colorizeByStatus)(count > 0 ? `🔗 ${count}` : '', resource.status);
+            },
+            header: 'inherited',
+        },
+    };
+};
+exports.inheritedColumn = inheritedColumn;
 class DependenciesStatus extends dependency_command_1.default {
+    async resourcesTableLog(resources) {
+        cli_1.cli.table(resources, {
+            name: {
+                get({ slug, status }) {
+                    return (0, colorize_resource_1.colorizeByStatus)(slug, status);
+                },
+                header: 'name',
+            },
+            ...(0, exports.inheritedColumn)(resources),
+            status: {
+                get({ status }) {
+                    return (0, colorize_resource_1.colorizeByStatus)(status, status);
+                },
+                header: 'status',
+            },
+        }, { sort: 'name' });
+    }
     async run() {
         await this.resourcesLog();
     }

package/dist/commands/pull.js

@@ -23,7 +23,7 @@ class PullCommand extends base_command_1.default {
         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_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/team/pull.d.ts

@@ -3,6 +3,9 @@ import TeamRepository from '../../repositories/team';
 export default class TeamPullCommand extends ApiClientCommand {
     static description: string;
     static examples: string[];
+    static flags: {
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
     _teamRepository: TeamRepository;
     run(): Promise<void>;
 }

package/dist/commands/team/pull.js

@@ -3,6 +3,7 @@ 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 types_1 = require("../../core/types");
 const cli_1 = require("../../utils/cli");
 class TeamPullCommand extends api_client_command_1.default {
     constructor() {
@@ -10,8 +11,19 @@ class TeamPullCommand extends api_client_command_1.default {
         this._teamRepository = new team_1.default();
     }
     async run() {
-        await this.parse(TeamPullCommand);
+        const { flags: { force }, } = await this.parse(TeamPullCommand);
         cli_1.default.log(color_1.default.cyan('\n🗄️  pulling team settings...'));
+        // Local edits (a version tag added, an alias re-pointed) would be silently wiped by the
+        // overwrite below, so an unpushed team.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._teamRepository.exists()) {
+            const local = await this._teamRepository.find();
+            const storedHash = await this.workspaceConfig.getTeamStoredHash();
+            if (storedHash !== undefined && storedHash !== local.contentHash) {
+                cli_1.default.log(color_1.default.yellow('🔺 team.json has unpushed local changes — run fcode team:push first, or fcode team:pull --force to overwrite them'));
+                return;
+            }
+        }
         const [raw, versions, aliases] = await Promise.all([
             this._fcodeGraphQLClient.team(),
             this._fcodeGraphQLClient.allTeamVersions(),
@@ -20,11 +32,10 @@ class TeamPullCommand extends api_client_command_1.default {
         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);
     }
 }
-TeamPullCommand.description = 'Fetch team settings (timezone, error handler, inheritance) from cloud into team.json';
+TeamPullCommand.description = 'Fetch team settings (timezone, error handler, inheritance) and team versions/aliases from cloud into team.json';
 TeamPullCommand.examples = ['$ fcode team:pull'];
+TeamPullCommand.flags = types_1.ForceFlag;
 exports.default = TeamPullCommand;

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

@@ -8,4 +8,6 @@ export default class TeamPushCommand extends ApiClientCommand {
     };
     _teamRepository: TeamRepository;
     run(): Promise<void>;
+    /** Makes the cloud's team versions/aliases match team.json; returns failed manifest entries. */
+    private syncVersioning;
 }

package/dist/commands/team/push.js

@@ -4,6 +4,7 @@ const color_1 = require("@oclif/color");
 const api_client_command_1 = require("../../core/commands/api-client-command");
 const team_1 = require("../../repositories/team");
 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 {
     constructor() {
@@ -22,9 +23,6 @@ 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;
@@ -42,11 +40,64 @@ class TeamPushCommand extends api_client_command_1.default {
         // so removing primaryLocale from it must clear the cloud setting. Empty string is the clear.
         update.primaryLocale = team.primaryLocale ?? '';
         await this._fcodeGraphQLClient.pushTeam(update);
+        const failedEntities = await this.syncVersioning(team, 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.
+        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'));
+        // 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 });
+        }
+    }
+    /** Makes the cloud's team versions/aliases match team.json; returns failed manifest entries. */
+    async syncVersioning(team, force) {
+        const [cloudVersions, cloudAliases] = await Promise.all([
+            this._fcodeGraphQLClient.allTeamVersions(),
+            this._fcodeGraphQLClient.allTeamVersionAliases(),
+        ]);
+        const plan = (0, team_versioning_1.planTeamVersioningSync)(team, 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}...`));
+            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 ` +
+                    '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}...`));
+            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;
     }
 }
-TeamPushCommand.description = 'Update cloud team settings (timezone, error handler, inheritance, webhook auth) from team.json';
+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;

package/dist/commands/team/status.js

@@ -18,7 +18,13 @@ class TeamStatusCommand extends api_client_command_1.default {
         }
         const local = await this._teamRepository.find();
         const storedHash = await this.workspaceConfig.getTeamStoredHash();
-        const remote = await this._teamRepository.fromRaw(await this._fcodeGraphQLClient.team());
+        const [raw, versions, aliases] = await Promise.all([
+            this._fcodeGraphQLClient.team(),
+            this._fcodeGraphQLClient.allTeamVersions(),
+            this._fcodeGraphQLClient.allTeamVersionAliases(),
+        ]);
+        const remote = await this._teamRepository.fromRaw(raw);
+        this._teamRepository.applyCloudVersioning(remote, versions, aliases);
         const localChanged = storedHash !== local.contentHash;
         const remoteChanged = storedHash !== remote.contentHash;
         if (localChanged && remoteChanged) {
@@ -35,6 +41,6 @@ class TeamStatusCommand extends api_client_command_1.default {
         }
     }
 }
-TeamStatusCommand.description = 'Show whether team settings (timezone, error handler, inheritance) differ from the cloud';
+TeamStatusCommand.description = 'Show whether team settings (timezone, error handler, inheritance) or team versions/aliases differ from the cloud';
 TeamStatusCommand.examples = ['$ fcode team:status'];
 exports.default = TeamStatusCommand;

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

@@ -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/team/versions/create.js

@@ -4,13 +4,14 @@ 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 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);
+        const failedCount = (0, team_versioning_1.logTeamVersionManifest)(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
@@ -19,16 +20,6 @@ class TeamVersionsCreateCommand extends api_client_command_1.default {
             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';

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>;
 }

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

@@ -4,16 +4,42 @@ const core_1 = require("@oclif/core");
 const global_1 = require("../../config/global");
 const workspace_1 = require("../../config/workspace");
 const color_1 = require("@oclif/color");
+const auth_service_1 = require("../../services/auth-service");
 const errors_1 = require("../errors");
 const cli_1 = require("../../utils/cli");
 const url_utils_1 = require("../../utils/url-utils");
 class BaseCommand extends core_1.Command {
+    constructor() {
+        super(...arguments);
+        this.sessionRefreshRetried = false;
+    }
     async catch(error) {
         // do any extra work with error
         if (error && error.response && error.response.status === 401) {
+            process.exitCode = 1;
             cli_1.default.error(`User authentication is invalid for current team.`);
             return;
         }
+        if (error && error.response && error.response.status === 403) {
+            let origin;
+            try {
+                origin = await this.workspaceConfig.getTeamOrigin();
+            }
+            catch {
+                // No workspace context; report without the slug.
+            }
+            // A 403 with a valid session usually means the token's team groups went
+            // stale — they are snapshotted at issuance (FCT-61231). Re-mint the token
+            // and retry the command once; a second denial falls through to the error.
+            if (!this.sessionRefreshRetried && origin && (await auth_service_1.default.refreshSession(origin.url))) {
+                this.sessionRefreshRetried = true;
+                await this.onSessionRefreshed();
+                return this.run().catch((retryError) => this.catch(retryError));
+            }
+            process.exitCode = 1;
+            cli_1.default.error((0, errors_1.teamAccessDeniedMessage)(origin?.slug));
+            return;
+        }
         if (error instanceof errors_1.NotAuthenticated) {
             let errorMessage = 'No session active. Logging you in';
             const loginArgs = [];
@@ -40,9 +66,11 @@ class BaseCommand extends core_1.Command {
             return this.run();
         }
         if (error instanceof errors_1.CLIError) {
+            process.exitCode = 1;
             cli_1.default.error(error);
             return;
         }
+        process.exitCode = 1;
         cli_1.default.error(error.message);
     }
     async init(url) {
@@ -53,6 +81,9 @@ class BaseCommand extends core_1.Command {
         const { authUrl } = await this.globalConfig.getAuthInfo(workspaceUrl);
         await this.config.runHook('auth', { argv: [workspaceUrl, authUrl], id: 'init' });
     }
+    // Called after a 403-triggered session refresh, before the retry: rewire
+    // anything that captured the old access token. API commands override this.
+    async onSessionRefreshed() { }
     async logActiveTeam() {
         const { slug, url } = await this.workspaceConfig.getTeamOrigin();
         cli_1.default.log(color_1.default.magenta(`💻 Working on Factorial Code team '${slug}${url !== global_1.FCODE_CLOUD_URL ? ` (${url})` : ''}'.`));

package/dist/core/dependencies/env-dependencies-command.js

@@ -25,7 +25,10 @@ class EnvDependenciesCommand extends api_client_command_1.default {
             fs.rmSync(this.envPath, { recursive: true });
         }
         const manifest = await this.getManifest();
-        const installationPath = this.installationPath(manifest.dependencies);
+        // The effective set — own dependencies over inherited ones — because that is what the platform
+        // installs, and the directory is named after the hash of what is installed.
+        const dependencies = manifest.effectiveDependencies;
+        const installationPath = this.installationPath(dependencies);
         if (fs.existsSync(installationPath)) {
             if (force) {
                 fs.rmSync(installationPath, { recursive: true });
@@ -38,12 +41,12 @@ class EnvDependenciesCommand extends api_client_command_1.default {
         await this.createEnv();
         cli_1.default.log(`Installing Factorial Code ${(0, types_1.programmingLanguageDisplayName)(this.programmingLanguage)} dependencies... (This process might take some time ⌛️)`);
         cli_1.default.log('====================================');
-        await this.installDependencies(installationPath, manifest.dependencies);
+        await this.installDependencies(installationPath, dependencies);
         cli_1.default.log('====================================');
         cli_1.default.log(color_1.default.green(`Factorial Code ${(0, types_1.programmingLanguageDisplayName)(this.programmingLanguage)} dependencies successfully installed in ${installationPath} 🤩\n\n`));
     }
     async check() {
-        const installationPath = this.installationPath((await this.getManifest()).dependencies);
+        const installationPath = this.installationPath((await this.getManifest()).effectiveDependencies);
         if (!fs.existsSync(installationPath)) {
             cli_1.default.log(color_1.default.yellow(`⚠️  ${(0, types_1.programmingLanguageDisplayName)(this.programmingLanguage)} dependencies need to be installed.`));
         }

package/dist/core/errors.d.ts

@@ -47,6 +47,10 @@ export declare class NotAuthenticated extends CLIError {
     constructor(url: string);
     getUrl(): string;
 }
+export declare function teamAccessDeniedMessage(slug?: string): string;
+export declare class TeamAccessDenied extends CLIError {
+    constructor(slug?: string);
+}
 export declare class NotFcodeWorkspace extends CLIError {
     constructor();
 }

package/dist/core/errors.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.ErrorExecutingProcess = exports.ProcessDependenciesNotInstalled = exports.DependenciesNotInstalled = exports.NotFcodeWorkspace = exports.TeamAccessDenied = 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;
+exports.teamAccessDeniedMessage = teamAccessDeniedMessage;
 const global_1 = require("../config/global");
 class CLIError extends Error {
     constructor(message, options) {
@@ -120,6 +121,20 @@ class NotAuthenticated extends CLIError {
     }
 }
 exports.NotAuthenticated = NotAuthenticated;
+function teamAccessDeniedMessage(slug) {
+    const team = slug ? ` '${slug}'` : '';
+    return (`You don't have access to team${team} with your current session.` +
+        ` If you were granted access recently, run 'fcode logout' and 'fcode login' and retry.`);
+}
+class TeamAccessDenied extends CLIError {
+    constructor(slug) {
+        super(teamAccessDeniedMessage(slug), {
+            code: 'ERR_TEAM_ACCESS_DENIED',
+            exit: 1,
+        });
+    }
+}
+exports.TeamAccessDenied = TeamAccessDenied;
 class NotFcodeWorkspace extends CLIError {
     constructor() {
         super('⚠️  Current directory is not a Factorial Code workspace.', {

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

@@ -593,13 +593,22 @@ 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.
+        // 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. A locale option resolves against that locale's own files,
+        // falling back key by key to the merged translations, exactly like the cloud executors.
         // Own properties only and no array arguments, exactly like the cloud executors.
-        i18n: Object.assign((key, args, _options) => {
+        i18n: Object.assign((key, args, options) => {
           const translations = ${JSON.stringify(metadata.i18n.translations, null, 2)};
-          const template = Object.hasOwn(translations, key) ? translations[key] : undefined;
+          const byLocale = ${JSON.stringify(metadata.i18n.byLocale, null, 2)};
+          const requested = options && typeof options === 'object' && options.locale !== undefined && options.locale !== null
+            ? String(options.locale)
+            : undefined;
+          const localeMap = requested !== undefined && Object.hasOwn(byLocale, requested) ? byLocale[requested] : undefined;
+          let template = localeMap && Object.hasOwn(localeMap, key) ? localeMap[key] : undefined;
+          if (template === undefined) {
+            template = Object.hasOwn(translations, key) ? translations[key] : undefined;
+          }
           if (template === undefined) {
             return key;
           }