@factorialco/fcode-cli 3.0.0 → 3.1.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @factorialco/fcode-cli
 $ fcode COMMAND
 running command...
 $ fcode (--version)
-@factorialco/fcode-cli/3.0.0 linux-x64 node-v22.22.3
+@factorialco/fcode-cli/3.1.0 linux-x64 node-v22.22.3
 $ fcode --help [COMMAND]
 USAGE
   $ fcode COMMAND
@@ -1247,7 +1247,7 @@ EXAMPLES
 
 ## `fcode team:clone [TEAMID]`
 
-Clone every App of a development team into one folder — an App folder each, holding the App's development workspace
+Clone a development team into one folder — an App folder each, holding the App's development workspace, plus the team's global workspaces under global-workspaces/
 
 ```
 USAGE
@@ -1260,7 +1260,8 @@ FLAGS
   --skipSkillsSetup  Skip installation of the Factorial Code agent skills
 
 DESCRIPTION
-  Clone every App of a development team into one folder — an App folder each, holding the App's development workspace
+  Clone a development team into one folder — an App folder each, holding the App's development workspace, plus the
+  team's global workspaces under global-workspaces/
 
 EXAMPLES
   $ fcode team:clone
@@ -1270,14 +1271,14 @@ EXAMPLES
 
 ## `fcode team:pull`
 
-Pull every App of the development team folder: clones Apps added since the last run and pulls each App's workspace
+Pull the development team folder: clones Apps and global workspaces added since the last run and pulls every workspace
 
 ```
 USAGE
   $ fcode team:pull
 
 DESCRIPTION
-  Pull every App of the development team folder: clones Apps added since the last run and pulls each App's workspace
+  Pull the development team folder: clones Apps and global workspaces added since the last run and pulls every workspace
 
 EXAMPLES
   $ fcode team:pull
@@ -1285,14 +1286,14 @@ EXAMPLES
 
 ## `fcode team:status`
 
-Show what differs from the cloud in every App workspace of the development team folder
+Show what differs from the cloud in every workspace of the development team folder
 
 ```
 USAGE
   $ fcode team:status
 
 DESCRIPTION
-  Show what differs from the cloud in every App workspace of the development team folder
+  Show what differs from the cloud in every workspace of the development team folder
 
 EXAMPLES
   $ fcode team:status

package/dist/commands/team/clone.js

@@ -26,9 +26,9 @@ class TeamCloneCommand extends core_1.Command {
         if (!team) {
             return;
         }
-        const apps = await client.listTeamApps(team.id);
-        if (apps.length === 0) {
-            cli_1.default.log(`ℹ️  '${team.name}' has no Apps yet.`);
+        const remote = await (0, dev_team_service_1.fetchTeamRemote)(client, team.id);
+        if (remote.apps.length === 0 && remote.globalWorkspaces.length === 0) {
+            cli_1.default.log(`ℹ️  '${team.name}' has no Apps or global workspaces yet.`);
             return;
         }
         const rootDir = path.resolve((0, slugify_1.slugifyOr)(team.name, team.id));
@@ -39,26 +39,25 @@ class TeamCloneCommand extends core_1.Command {
                 suggestions: [`cd ${path.basename(rootDir)}`, 'fcode team:pull'],
             });
         }
-        cli_1.default.log(color_1.default.cyan(`\n🏢 cloning ${apps.length} App(s) of '${team.name}'...`));
+        cli_1.default.log(color_1.default.cyan(`\n🏢 cloning ${remote.apps.length} App(s) and ${remote.globalWorkspaces.length} global workspace(s) of '${team.name}'...`));
         const metadata = {
             developmentTeam: { id: team.id, name: team.name },
             cloudUrl,
             apps: {},
+            globalWorkspaces: {},
         };
         // Written before anything is cloned, so a run interrupted halfway still leaves a folder
         // `fcode team:pull` recognises and can finish.
         const config = new dev_team_1.default(rootDir);
         config.write(metadata);
-        // Skills next: each App links to them as it lands, so an install that fails leaves every
-        // App cloned and only the links missing.
+        // Skills next: each workspace links to them as it lands, so an install that fails leaves
+        // everything cloned and only the links missing.
         if (!(await this.skipSkills(flags.skipSkillsSetup))) {
             await (0, skills_installer_1.installSkillsAt)(rootDir);
         }
-        const plan = (0, dev_team_service_1.planAppSync)(metadata, apps);
-        const outcomes = await (0, dev_team_service_1.syncApps)(rootDir, metadata, plan);
+        const result = await (0, dev_team_service_1.syncTeam)(rootDir, metadata, remote);
         config.write(metadata);
-        const failed = (0, dev_team_service_1.reportOutcomes)(outcomes, plan.removed);
-        if (failed) {
+        if ((0, dev_team_service_1.reportOutcomes)(result)) {
             process.exitCode = 1;
             cli_1.default.log(`\n⚠️  '${team.name}' cloned with errors — rerun 'fcode team:pull' inside the folder to retry.\n`);
         }
@@ -74,7 +73,7 @@ class TeamCloneCommand extends core_1.Command {
         return (await new global_1.default().getSetting(settings_1.SettingKeys.SKIP_SKILLS_SETUP)) === 'true';
     }
 }
-TeamCloneCommand.description = "Clone every App of a development team into one folder — an App folder each, holding the App's development workspace";
+TeamCloneCommand.description = "Clone a development team into one folder — an App folder each, holding the App's development workspace, plus the team's global workspaces under global-workspaces/";
 TeamCloneCommand.examples = ['$ fcode team:clone', '$ fcode team:clone 0f9c1a2b-3d4e-5f60-8a1b-2c3d4e5f6071'];
 TeamCloneCommand.args = {
     teamId: core_1.Args.string({

package/dist/commands/team/pull.js

@@ -20,17 +20,16 @@ class TeamPullCommand extends core_1.Command {
         const metadata = config.read();
         const { developmentTeam } = metadata;
         cli_1.default.log(color_1.default.cyan(`\n🏢 pulling '${developmentTeam.name}'...`));
-        const apps = await new dashboard_client_1.default(metadata.cloudUrl).listTeamApps(developmentTeam.id);
-        const plan = (0, dev_team_service_1.planAppSync)(metadata, apps);
-        const outcomes = await (0, dev_team_service_1.syncApps)(rootDir, metadata, plan);
-        // Written even when an App failed, so the ones that did land are recorded and a rerun
+        const remote = await (0, dev_team_service_1.fetchTeamRemote)(new dashboard_client_1.default(metadata.cloudUrl), developmentTeam.id);
+        const result = await (0, dev_team_service_1.syncTeam)(rootDir, metadata, remote);
+        // Written even when a workspace failed, so the ones that did land are recorded and a rerun
         // only retries what is still missing.
         config.write(metadata);
-        if ((0, dev_team_service_1.reportOutcomes)(outcomes, plan.removed)) {
+        if ((0, dev_team_service_1.reportOutcomes)(result)) {
             process.exitCode = 1;
         }
     }
 }
-TeamPullCommand.description = "Pull every App of the development team folder: clones Apps added since the last run and pulls each App's workspace";
+TeamPullCommand.description = 'Pull the development team folder: clones Apps and global workspaces added since the last run and pulls every workspace';
 TeamPullCommand.examples = ['$ fcode team:pull'];
 exports.default = TeamPullCommand;

package/dist/commands/team/status.js

@@ -19,13 +19,17 @@ class TeamStatusCommand extends core_1.Command {
         await this.parse(TeamStatusCommand);
         const rootDir = process.cwd();
         const metadata = new dev_team_1.default(rootDir).read();
+        const checkouts = [
+            ...Object.values(metadata.globalWorkspaces).map(({ name, slug }) => ({ name, folder: (0, dev_team_1.globalWorkspaceFolder)(slug) })),
+            ...Object.values(metadata.apps).map(({ name, folder }) => ({ name, folder: path.join(folder, dev_team_1.APP_WORKSPACE_DIR) })),
+        ];
         const failed = [];
-        for (const app of Object.values(metadata.apps)) {
-            cli_1.default.log(color_1.default.cyan(`\n━━ ${app.name} (${app.folder}) ━━`));
-            const workspaceDir = path.join(rootDir, app.folder, dev_team_1.APP_WORKSPACE_DIR);
+        for (const { name, folder } of checkouts) {
+            cli_1.default.log(color_1.default.cyan(`\n━━ ${name} (${folder}) ━━`));
+            const workspaceDir = path.join(rootDir, folder);
             if (!fs.pathExistsSync(workspaceDir)) {
                 cli_1.default.log(color_1.default.yellow('⚠️  not cloned yet — run fcode team:pull'));
-                failed.push(app.folder);
+                failed.push(folder);
                 continue;
             }
             try {
@@ -33,15 +37,15 @@ class TeamStatusCommand extends core_1.Command {
             }
             catch (error) {
                 cli_1.default.log(color_1.default.red(`❌ ${error.message}`));
-                failed.push(app.folder);
+                failed.push(folder);
             }
         }
         if (failed.length > 0) {
             process.exitCode = 1;
-            cli_1.default.log(color_1.default.red(`\n${failed.length} App(s) could not be checked: ${failed.join(', ')}`));
+            cli_1.default.log(color_1.default.red(`\n${failed.length} workspace(s) could not be checked: ${failed.join(', ')}`));
         }
     }
 }
-TeamStatusCommand.description = "Show what differs from the cloud in every App workspace of the development team folder";
+TeamStatusCommand.description = 'Show what differs from the cloud in every workspace of the development team folder';
 TeamStatusCommand.examples = ['$ fcode team:status'];
 exports.default = TeamStatusCommand;

package/dist/config/dev-team.d.ts

@@ -5,6 +5,12 @@ import { CLIError } from '../core/errors';
  * it at another workspace with `fcode remote:add` (dev → prod) must not make its name a lie.
  */
 export declare const APP_WORKSPACE_DIR = "app";
+/**
+ * The global workspaces the team owns sit together under this folder, one checkout per workspace
+ * named after its slug. A global workspace is one platform team with a fixed slug, so — unlike an
+ * App — there is no name to derive a folder from and nothing to re-point the checkout at.
+ */
+export declare const GLOBAL_WORKSPACES_DIR = "global-workspaces";
 export interface DevTeamApp {
     name: string;
     description: string | null;
@@ -13,6 +19,12 @@ export interface DevTeamApp {
     /** Workspace the checkout was cloned from. The directory itself is always `APP_WORKSPACE_DIR`. */
     devWorkspaceSlug: string;
 }
+export interface DevTeamGlobalWorkspace {
+    name: string;
+    description: string;
+    /** Platform team slug; also the checkout's folder name under `GLOBAL_WORKSPACES_DIR`. */
+    slug: string;
+}
 export interface DevTeamMetadata {
     developmentTeam: {
         id: string;
@@ -21,7 +33,11 @@ export interface DevTeamMetadata {
     cloudUrl: string;
     /** Keyed by App id, so a renamed App keeps its folder. */
     apps: Record<string, DevTeamApp>;
+    /** Keyed by global workspace id. */
+    globalWorkspaces: Record<string, DevTeamGlobalWorkspace>;
 }
+/** Where a global workspace is checked out, relative to the team root. */
+export declare function globalWorkspaceFolder(slug: string): string;
 export declare class NotDevTeamFolder extends CLIError {
     constructor();
 }

package/dist/config/dev-team.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.APP_SETTINGS_FILENAME = exports.NotDevTeamFolder = exports.APP_WORKSPACE_DIR = void 0;
+exports.APP_SETTINGS_FILENAME = exports.NotDevTeamFolder = exports.GLOBAL_WORKSPACES_DIR = exports.APP_WORKSPACE_DIR = void 0;
+exports.globalWorkspaceFolder = globalWorkspaceFolder;
 exports.writeAppSettings = writeAppSettings;
 const fs = require("fs-extra");
 const path = require("node:path");
@@ -10,8 +11,8 @@ const errors_1 = require("../core/errors");
  * and what `team:pull` / `team:status` recognise the folder by.
  *
  * Not to be confused with a workspace's `settings.json` (the file that used to be called
- * `team.json`): this one describes the *development team* — the humans and the Apps they own —
- * and lives one level above the workspaces, inside `.fcode/`.
+ * `team.json`): this one describes the *development team* — the humans, the Apps they own and the
+ * global workspaces they maintain — and lives one level above the workspaces, inside `.fcode/`.
  */
 const DEV_TEAM_CONFIG_PATH = path.join('.fcode', 'team.json');
 /**
@@ -20,6 +21,16 @@ const DEV_TEAM_CONFIG_PATH = path.join('.fcode', 'team.json');
  * it at another workspace with `fcode remote:add` (dev → prod) must not make its name a lie.
  */
 exports.APP_WORKSPACE_DIR = 'app';
+/**
+ * The global workspaces the team owns sit together under this folder, one checkout per workspace
+ * named after its slug. A global workspace is one platform team with a fixed slug, so — unlike an
+ * App — there is no name to derive a folder from and nothing to re-point the checkout at.
+ */
+exports.GLOBAL_WORKSPACES_DIR = 'global-workspaces';
+/** Where a global workspace is checked out, relative to the team root. */
+function globalWorkspaceFolder(slug) {
+    return path.join(exports.GLOBAL_WORKSPACES_DIR, slug);
+}
 class NotDevTeamFolder extends errors_1.CLIError {
     constructor() {
         super('⚠️  Current directory is not a Factorial Code development team folder.', {
@@ -44,7 +55,10 @@ class DevTeamConfig {
         if (!this.exists()) {
             throw new NotDevTeamFolder();
         }
-        return fs.readJsonSync(this.configPath);
+        const metadata = fs.readJsonSync(this.configPath);
+        // A team folder cloned before global workspaces were part of it has no entry; the next
+        // team:pull then clones them the way it clones Apps added since the last run.
+        return { ...metadata, globalWorkspaces: metadata.globalWorkspaces ?? {} };
     }
     write(metadata) {
         fs.outputJsonSync(this.configPath, metadata, { spaces: 2 });

package/dist/services/dashboard-client.d.ts

@@ -8,6 +8,16 @@ export interface DevelopmentTeamApp {
     name: string;
     description: string | null;
 }
+/**
+ * A base workspace the team owns (`base-app` and the like), as opposed to an App's `dev-` workspace.
+ * The slug is the platform team slug itself: fixed, filesystem-safe, and unique.
+ */
+export interface DevelopmentTeamGlobalWorkspace {
+    id: string;
+    name: string;
+    slug: string;
+    description: string;
+}
 /**
  * `https://code.factorialhr.com/platform` → `https://code.factorialhr.com/dashboard/api/v1`.
  * The dashboard is served under `/dashboard` on the same origin as the platform; environments
@@ -24,6 +34,8 @@ export default class DashboardClient {
     listDevelopmentTeams(): Promise<DevelopmentTeam[]>;
     /** The Apps owned by a development team, narrowed by the API to the ones the session can see. */
     listTeamApps(teamId: string): Promise<DevelopmentTeamApp[]>;
+    /** The global workspaces owned by a development team. */
+    listTeamGlobalWorkspaces(teamId: string): Promise<DevelopmentTeamGlobalWorkspace[]>;
     private getAllPages;
     private get;
     private headers;

package/dist/services/dashboard-client.js

@@ -45,6 +45,15 @@ class DashboardClient {
         });
         return items.map(({ id, name, description }) => ({ id, name, description }));
     }
+    /** The global workspaces owned by a development team. */
+    async listTeamGlobalWorkspaces(teamId) {
+        const items = await this.getAllPages('/global-workspaces', {
+            owner_development_team_id: teamId,
+            sort_by: 'slug',
+            sort_dir: 'asc',
+        });
+        return items.map(({ id, name, slug, description }) => ({ id, name, slug, description }));
+    }
     async getAllPages(path, query = {}) {
         const items = [];
         let offset = 0;

package/dist/services/dev-team-service.d.ts

@@ -1,18 +1,26 @@
-import DashboardClient, { DevelopmentTeam, DevelopmentTeamApp } from './dashboard-client';
-import { DevTeamApp, DevTeamMetadata } from '../config/dev-team';
-/** What a team folder has to do to match the team as the dashboard currently describes it. */
-export interface AppSyncPlan {
+import DashboardClient, { DevelopmentTeam, DevelopmentTeamApp, DevelopmentTeamGlobalWorkspace } from './dashboard-client';
+import { DevTeamMetadata } from '../config/dev-team';
+/** What the dashboard currently says the team holds. */
+export interface DevTeamRemote {
+    apps: DevelopmentTeamApp[];
+    globalWorkspaces: DevelopmentTeamGlobalWorkspace[];
+}
+export declare function fetchTeamRemote(client: DashboardClient, teamId: string): Promise<DevTeamRemote>;
+/** What a team folder has to do to make one kind of entry match the dashboard. */
+export interface SyncPlan<Remote, Recorded> {
     /** In the team, with no folder yet — cloned. */
-    toClone: DevelopmentTeamApp[];
+    toClone: Remote[];
     /** In the team and already cloned — refreshed and pulled. */
-    toRefresh: DevelopmentTeamApp[];
+    toRefresh: Remote[];
     /** Recorded locally but no longer in the team — reported, never deleted. */
     removed: Array<{
         id: string;
-        app: DevTeamApp;
+        recorded: Recorded;
     }>;
 }
-export declare function planAppSync(metadata: DevTeamMetadata, apps: DevelopmentTeamApp[]): AppSyncPlan;
+export declare function planSync<Remote extends {
+    id: string;
+}, Recorded>(recorded: Record<string, Recorded>, remote: Remote[]): SyncPlan<Remote, Recorded>;
 /**
  * The folder an App gets inside the team root. Names are free text and two Apps may well slugify
  * the same, so the first claimant keeps the plain slug and the next ones are suffixed. Only ever
@@ -20,20 +28,26 @@ export declare function planAppSync(metadata: DevTeamMetadata, apps: Development
  * a renamed App keeps the folder it was cloned into.
  */
 export declare function assignFolder(app: DevelopmentTeamApp, metadata: DevTeamMetadata): string;
-export interface AppSyncOutcome {
+export interface TeamSyncOutcome {
     name: string;
     folder: string;
     action: 'cloned' | 'pulled';
     error?: Error;
 }
+export interface TeamSyncResult {
+    outcomes: TeamSyncOutcome[];
+    /** Folders recorded locally whose App or global workspace has left the team. */
+    removedFolders: string[];
+}
 /**
- * Applies the plan, one App at a time, recording the metadata of each App that lands. A failing
- * App is reported and the run carries on: with a dozen Apps, one bad workspace must not cost the
- * other eleven.
+ * Brings the team folder in line with the dashboard — global workspaces first, since the Apps
+ * inherit from them, then the Apps — one workspace at a time, recording the metadata of each one
+ * that lands. A failing workspace is reported and the run carries on: with a dozen Apps, one bad
+ * workspace must not cost the other eleven.
  */
-export declare function syncApps(rootDir: string, metadata: DevTeamMetadata, plan: AppSyncPlan): Promise<AppSyncOutcome[]>;
-/** Prints the per-App result and reports whether anything failed. */
-export declare function reportOutcomes(outcomes: AppSyncOutcome[], removed: AppSyncPlan['removed']): boolean;
+export declare function syncTeam(rootDir: string, metadata: DevTeamMetadata, remote: DevTeamRemote): Promise<TeamSyncResult>;
+/** Prints the per-workspace result and reports whether anything failed. */
+export declare function reportOutcomes({ outcomes, removedFolders }: TeamSyncResult): boolean;
 /**
  * The team to operate on: the one named, the only one the session belongs to, or — when there are
  * several — none, after listing them so the user can pass an id.

package/dist/services/dev-team-service.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.planAppSync = planAppSync;
+exports.fetchTeamRemote = fetchTeamRemote;
+exports.planSync = planSync;
 exports.assignFolder = assignFolder;
-exports.syncApps = syncApps;
+exports.syncTeam = syncTeam;
 exports.reportOutcomes = reportOutcomes;
 exports.resolveTeam = resolveTeam;
 const fs = require("fs-extra");
@@ -15,14 +16,18 @@ const dev_slug_1 = require("../utils/dev-slug");
 const workspace_cloner_1 = require("./workspace-cloner");
 const slugify_1 = require("../utils/slugify");
 const cli_1 = require("../utils/cli");
-function planAppSync(metadata, apps) {
-    const remoteIds = new Set(apps.map(({ id }) => id));
+async function fetchTeamRemote(client, teamId) {
+    const [apps, globalWorkspaces] = await Promise.all([client.listTeamApps(teamId), client.listTeamGlobalWorkspaces(teamId)]);
+    return { apps, globalWorkspaces };
+}
+function planSync(recorded, remote) {
+    const remoteIds = new Set(remote.map(({ id }) => id));
     return {
-        toClone: apps.filter(({ id }) => metadata.apps[id] === undefined),
-        toRefresh: apps.filter(({ id }) => metadata.apps[id] !== undefined),
-        removed: Object.entries(metadata.apps)
+        toClone: remote.filter(({ id }) => recorded[id] === undefined),
+        toRefresh: remote.filter(({ id }) => recorded[id] !== undefined),
+        removed: Object.entries(recorded)
             .filter(([id]) => !remoteIds.has(id))
-            .map(([id, app]) => ({ id, app })),
+            .map(([id, entry]) => ({ id, recorded: entry })),
     };
 }
 /**
@@ -44,9 +49,12 @@ function linkSkills(rootDir, appDir, workspaceDir) {
     (0, skills_installer_1.linkSkillsInto)(appDir, rootDir);
     (0, skills_installer_1.linkSkillsInto)(workspaceDir, rootDir);
 }
-/** A committed .gitignore, since each App folder is meant to become its own repository. */
-function writeAppGitIgnore(appDir) {
-    const gitIgnorePath = path.join(appDir, '.gitignore');
+/**
+ * A committed .gitignore keeping the skill links out of the repository: one in each App folder,
+ * since each is meant to become its own repository, and one over the global workspaces.
+ */
+function writeSkillsGitIgnore(dir) {
+    const gitIgnorePath = path.join(dir, '.gitignore');
     if (fs.pathExistsSync(gitIgnorePath)) {
         return;
     }
@@ -65,7 +73,7 @@ async function cloneApp(rootDir, app, folder, metadata) {
     await (0, workspace_cloner_1.scaffoldWorkspace)(workspaceDir, { url: metadata.cloudUrl, slug });
     metadata.apps[app.id] = { name: app.name, description: app.description, folder, devWorkspaceSlug: slug };
     (0, dev_team_1.writeAppSettings)(appDir, { id: app.id, name: app.name, description: app.description });
-    writeAppGitIgnore(appDir);
+    writeSkillsGitIgnore(appDir);
     linkSkills(rootDir, appDir, workspaceDir);
     await (0, workspace_cloner_1.runInWorkspace)(workspaceDir, () => pull_1.default.run([]));
 }
@@ -81,17 +89,30 @@ async function refreshApp(rootDir, cloudUrl, app, recorded) {
     // Name and description live in the dashboard; the local copy is a mirror refreshed on every
     // pull. There is deliberately no team:push — pushing happens inside a workspace.
     (0, dev_team_1.writeAppSettings)(appDir, { id: app.id, name: app.name, description: app.description });
-    writeAppGitIgnore(appDir);
+    writeSkillsGitIgnore(appDir);
     recorded.name = app.name;
     recorded.description = app.description;
     linkSkills(rootDir, appDir, workspaceDir);
     await (0, workspace_cloner_1.runInWorkspace)(workspaceDir, () => pull_1.default.run([]));
 }
 /**
- * Applies the plan, one App at a time, recording the metadata of each App that lands. A failing
- * App is reported and the run carries on: with a dozen Apps, one bad workspace must not cost the
- * other eleven.
+ * Clones or refreshes one global workspace. Its slug is the platform team slug — fixed, unique and
+ * filesystem-safe — so the checkout goes straight to `global-workspaces/{slug}` with no folder to
+ * assign and no App-level settings to mirror. Recorded before the pull for the same reason as an
+ * App: a half-cloned checkout must read as cloned on the retry.
  */
+async function syncGlobalWorkspace(rootDir, workspace, metadata) {
+    const folder = (0, dev_team_1.globalWorkspaceFolder)(workspace.slug);
+    const workspaceDir = path.join(rootDir, folder);
+    cli_1.default.log(color_1.default.cyan(`\n🌐 ${workspace.name} → ${folder}`));
+    if (!fs.pathExistsSync(path.join(workspaceDir, '.fcode'))) {
+        await (0, workspace_cloner_1.scaffoldWorkspace)(workspaceDir, { url: metadata.cloudUrl, slug: workspace.slug });
+    }
+    metadata.globalWorkspaces[workspace.id] = { name: workspace.name, description: workspace.description, slug: workspace.slug };
+    writeSkillsGitIgnore(path.join(rootDir, dev_team_1.GLOBAL_WORKSPACES_DIR));
+    (0, skills_installer_1.linkSkillsInto)(workspaceDir, rootDir);
+    await (0, workspace_cloner_1.runInWorkspace)(workspaceDir, () => pull_1.default.run([]));
+}
 async function syncApps(rootDir, metadata, plan) {
     const outcomes = [];
     for (const app of plan.toClone) {
@@ -116,8 +137,46 @@ async function syncApps(rootDir, metadata, plan) {
     }
     return outcomes;
 }
-/** Prints the per-App result and reports whether anything failed. */
-function reportOutcomes(outcomes, removed) {
+async function syncGlobalWorkspaces(rootDir, metadata, plan) {
+    const outcomes = [];
+    for (const [action, workspaces] of [
+        ['cloned', plan.toClone],
+        ['pulled', plan.toRefresh],
+    ]) {
+        for (const workspace of workspaces) {
+            const folder = (0, dev_team_1.globalWorkspaceFolder)(workspace.slug);
+            try {
+                await syncGlobalWorkspace(rootDir, workspace, metadata);
+                outcomes.push({ name: workspace.name, folder, action });
+            }
+            catch (error) {
+                outcomes.push({ name: workspace.name, folder, action, error: error });
+            }
+        }
+    }
+    return outcomes;
+}
+/**
+ * Brings the team folder in line with the dashboard — global workspaces first, since the Apps
+ * inherit from them, then the Apps — one workspace at a time, recording the metadata of each one
+ * that lands. A failing workspace is reported and the run carries on: with a dozen Apps, one bad
+ * workspace must not cost the other eleven.
+ */
+async function syncTeam(rootDir, metadata, remote) {
+    const globalWorkspacePlan = planSync(metadata.globalWorkspaces, remote.globalWorkspaces);
+    const appPlan = planSync(metadata.apps, remote.apps);
+    const outcomes = [
+        ...(await syncGlobalWorkspaces(rootDir, metadata, globalWorkspacePlan)),
+        ...(await syncApps(rootDir, metadata, appPlan)),
+    ];
+    const removedFolders = [
+        ...globalWorkspacePlan.removed.map(({ recorded }) => (0, dev_team_1.globalWorkspaceFolder)(recorded.slug)),
+        ...appPlan.removed.map(({ recorded }) => recorded.folder),
+    ];
+    return { outcomes, removedFolders };
+}
+/** Prints the per-workspace result and reports whether anything failed. */
+function reportOutcomes({ outcomes, removedFolders }) {
     cli_1.default.log('');
     for (const outcome of outcomes) {
         if (outcome.error) {
@@ -127,8 +186,8 @@ function reportOutcomes(outcomes, removed) {
             cli_1.default.log(color_1.default.green(`✅ ${outcome.folder} (${outcome.action})`));
         }
     }
-    for (const { app } of removed) {
-        cli_1.default.log(color_1.default.yellow(`⚠️  ${app.folder} is no longer in the team — the folder was kept, remove it yourself`));
+    for (const folder of removedFolders) {
+        cli_1.default.log(color_1.default.yellow(`⚠️  ${folder} is no longer in the team — the folder was kept, remove it yourself`));
     }
     return outcomes.some(({ error }) => error !== undefined);
 }

package/oclif.manifest.json

@@ -1956,7 +1956,7 @@
           "required": false
         }
       },
-      "description": "Clone every App of a development team into one folder — an App folder each, holding the App's development workspace",
+      "description": "Clone a development team into one folder — an App folder each, holding the App's development workspace, plus the team's global workspaces under global-workspaces/",
       "examples": [
         "$ fcode team:clone",
         "$ fcode team:clone 0f9c1a2b-3d4e-5f60-8a1b-2c3d4e5f6071"
@@ -1988,7 +1988,7 @@
     "team:pull": {
       "aliases": [],
       "args": {},
-      "description": "Pull every App of the development team folder: clones Apps added since the last run and pulls each App's workspace",
+      "description": "Pull the development team folder: clones Apps and global workspaces added since the last run and pulls every workspace",
       "examples": [
         "$ fcode team:pull"
       ],
@@ -2012,7 +2012,7 @@
     "team:status": {
       "aliases": [],
       "args": {},
-      "description": "Show what differs from the cloud in every App workspace of the development team folder",
+      "description": "Show what differs from the cloud in every workspace of the development team folder",
       "examples": [
         "$ fcode team:status"
       ],
@@ -2483,5 +2483,5 @@
       ]
     }
   },
-  "version": "3.0.0"
+  "version": "3.1.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@factorialco/fcode-cli",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "packageManager": "pnpm@11.7.0",
   "description": "Factorial Code Command Line Interface",
   "homepage": "https://code.factorialhr.com/docs/cli/",