@factorialco/fcode-cli 1.3.0 → 1.5.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @factorialco/fcode-cli
 $ fcode COMMAND
 running command...
 $ fcode (--version)
-@factorialco/fcode-cli/1.3.0 linux-x64 node-v22.22.3
+@factorialco/fcode-cli/1.5.0 linux-x64 node-v22.22.3
 $ fcode --help [COMMAND]
 USAGE
   $ fcode COMMAND
@@ -100,14 +100,12 @@ Clone team workspace from cloud
 
 ```
 USAGE
-  $ fcode clone [TEAM] [--skipSkillsSetup] [--autoSkillsSetup]
+  $ fcode clone [TEAM] [--skipSkillsSetup]
 
 ARGUMENTS
   [TEAM]  Team name
 
 FLAGS
-  --autoSkillsSetup  Install the Factorial Code agent skills non-interactively (defaults, project scope) instead of
-                     prompting
   --skipSkillsSetup  Skip installation of the Factorial Code agent skills
 
 DESCRIPTION

package/dist/commands/clone.d.ts

@@ -8,18 +8,18 @@ export default class Clone extends Command {
     static examples: string[];
     static flags: {
         skipSkillsSetup: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        autoSkillsSetup: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     checkWorkspaceAlreadyCloned(slug: string): Promise<void>;
     checkWorkspaceIsEmpty(slug: string): Promise<void>;
-    cloneTeam(origin: TeamOrigin, skipSkillsSetup?: boolean, autoSkillsSetup?: boolean): Promise<void>;
+    cloneTeam(origin: TeamOrigin, skipSkillsSetup?: boolean): Promise<void>;
     createWorkspaceConfig(origin: TeamOrigin): Promise<void>;
     createWorkspaceDatastore(slug: string): void;
     createWorkspaceStorage(slug: string): void;
     createWorkspaceGitIgnore(slug: string): Promise<void>;
     createWorkspaceLocalVariables(slug: string): Promise<void>;
     private skillsInstallHint;
-    setupSkills(autoSkillsSetup?: boolean): Promise<void>;
+    setupSkills(): Promise<void>;
+    private installSkills;
     catch(error: any): Promise<void>;
     init(): Promise<void>;
     mkdirWorkspace(slug: string): Promise<void>;

package/dist/commands/clone.js

@@ -10,7 +10,12 @@ const pull_1 = require("./pull");
 const types_1 = require("../core/types");
 const cli_1 = require("../utils/cli");
 const settings_1 = require("../config/settings");
-const SKILLS_REPO = 'factorialco/factorial-code-skills';
+// Skill sources installed on clone. `release-sdk` in factorial-api-sdks is a
+// maintainer-only skill, so we pick `factorial-api-sdks` explicitly there.
+const SKILLS_SOURCES = [
+    { repo: 'factorialco/factorial-code-skills', skills: '*' },
+    { repo: 'factorialco/factorial-api-sdks', skills: 'factorial-api-sdks' },
+];
 class Clone extends core_1.Command {
     async checkWorkspaceAlreadyCloned(slug) {
         try {
@@ -41,7 +46,7 @@ class Clone extends core_1.Command {
             });
         }
     }
-    async cloneTeam(origin, skipSkillsSetup = false, autoSkillsSetup = false) {
+    async cloneTeam(origin, skipSkillsSetup = false) {
         await this.mkdirWorkspace(origin.slug);
         await this.createWorkspaceConfig(origin);
         await this.createWorkspaceGitIgnore(origin.slug);
@@ -51,7 +56,7 @@ class Clone extends core_1.Command {
         process.chdir(origin.slug);
         await pull_1.default.run([]);
         if (!skipSkillsSetup) {
-            await this.setupSkills(autoSkillsSetup);
+            await this.setupSkills();
         }
     }
     async createWorkspaceConfig(origin) {
@@ -75,32 +80,35 @@ class Clone extends core_1.Command {
         const localVariablesFileName = await globalConfig.getSetting(settings_1.SettingKeys.LOCAL_VARIABLES_FILE_NAME);
         fs.outputFileSync(path.join(slug, localVariablesFileName), '');
     }
-    skillsInstallHint() {
+    skillsInstallHint(repo, skills) {
         cli_1.default.log('💡 Install the Factorial Code agent skills later with:');
-        cli_1.default.log(`   npx skills add ${SKILLS_REPO} -s '*'`);
+        cli_1.default.log(`   npx skills add ${repo} -s '${skills}' -y`);
     }
-    async setupSkills(autoSkillsSetup = false) {
+    async setupSkills() {
         cli_1.default.log('');
-        // `npx --yes skills add <repo> -s '*'` — preselect all skills; the skills CLI
-        // then handles scope (project/global) and assistant selection interactively.
-        // With autoSkillsSetup, add the skills CLI's `-y` flag so it installs
-        // non-interactively using its defaults, project-scoped (no `-g`), without prompting.
-        const skillsArgs = ['--yes', 'skills', 'add', SKILLS_REPO, '-s', '*'];
-        if (autoSkillsSetup) {
-            skillsArgs.push('-y');
+        // The skills CLI only installs to agents it detects; a fresh workspace has no
+        // agent directories, so create .claude/ first so Claude Code is always targeted.
+        fs.ensureDirSync('.claude');
+        for (const source of SKILLS_SOURCES) {
+            await this.installSkills(source.repo, source.skills);
         }
+    }
+    async installSkills(repo, skills) {
+        // `npx --yes skills add <repo> -s <skills> -y` — non-interactive install with
+        // the skills CLI defaults: project scope (no -g), symlinked (no --copy).
+        const skillsArgs = ['--yes', 'skills', 'add', repo, '-s', skills, '-y'];
         await new Promise((resolve) => {
             const child = (0, node_child_process_1.spawn)('npx', skillsArgs, { stdio: 'inherit' });
             child.on('error', () => {
                 // npx not available (or failed to launch) — don't fail the clone, just tell the user how to do it.
                 cli_1.default.log("\n⚠️  Couldn't run npx automatically (is Node.js / npx installed?).");
-                this.skillsInstallHint();
+                this.skillsInstallHint(repo, skills);
                 resolve();
             });
             child.on('close', (code) => {
                 if (code !== 0) {
                     cli_1.default.log("\n⚠️  Skill installation didn't complete.");
-                    this.skillsInstallHint();
+                    this.skillsInstallHint(repo, skills);
                 }
                 resolve();
             });
@@ -167,11 +175,7 @@ class Clone extends core_1.Command {
         if (skipSkillsSetup === undefined) {
             skipSkillsSetup = (await new global_1.default().getSetting(settings_1.SettingKeys.SKIP_SKILLS_SETUP)) === 'true';
         }
-        let autoSkillsSetup = flags.autoSkillsSetup;
-        if (autoSkillsSetup === undefined) {
-            autoSkillsSetup = (await new global_1.default().getSetting(settings_1.SettingKeys.AUTO_SKILLS_SETUP)) === 'true';
-        }
-        await this.cloneTeam({ url, slug }, skipSkillsSetup, autoSkillsSetup);
+        await this.cloneTeam({ url, slug }, skipSkillsSetup);
         cli_1.default.log(`\n🎉  ${args.team} team workspace cloned successfully!\n`);
         cli_1.default.log(`$ cd ${slug}\n`);
     }
@@ -183,8 +187,5 @@ Clone.flags = {
     skipSkillsSetup: core_1.Flags.boolean({
         description: 'Skip installation of the Factorial Code agent skills',
     }),
-    autoSkillsSetup: core_1.Flags.boolean({
-        description: 'Install the Factorial Code agent skills non-interactively (defaults, project scope) instead of prompting',
-    }),
 };
 exports.default = Clone;

package/dist/config/settings.d.ts

@@ -4,7 +4,6 @@ export interface SettingDefinition {
     description?: string;
 }
 export declare enum SettingKeys {
-    AUTO_SKILLS_SETUP = "autoSkillsSetup",
     DISABLE_UPDATE_NOTIFIER = "disableUpdateNotifier",
     IGNORE_PROCESS_VERSIONS = "ignoreProcessVersions",
     IGNORE_WORKSPACE_NOT_EMPTY = "ignoreWorkspaceNotEmpty",

package/dist/config/settings.js

@@ -4,7 +4,6 @@ exports.SETTINGS_DEFINITIONS = exports.SettingKeys = void 0;
 exports.getSettingDefault = getSettingDefault;
 var SettingKeys;
 (function (SettingKeys) {
-    SettingKeys["AUTO_SKILLS_SETUP"] = "autoSkillsSetup";
     SettingKeys["DISABLE_UPDATE_NOTIFIER"] = "disableUpdateNotifier";
     SettingKeys["IGNORE_PROCESS_VERSIONS"] = "ignoreProcessVersions";
     SettingKeys["IGNORE_WORKSPACE_NOT_EMPTY"] = "ignoreWorkspaceNotEmpty";
@@ -29,11 +28,6 @@ exports.SETTINGS_DEFINITIONS = [
         default: 'false',
         description: 'Skip Factorial Code agent skills install on clone',
     },
-    {
-        key: SettingKeys.AUTO_SKILLS_SETUP,
-        default: 'false',
-        description: 'Install Factorial Code agent skills non-interactively (defaults, project scope) on clone',
-    },
     {
         key: SettingKeys.IGNORE_FCODE_RUN_PROCESSES,
         default: 'false',

package/dist/core/types.d.ts

@@ -103,11 +103,10 @@ export interface ProcessWebhook {
     username?: string;
     password?: string;
 }
+export type AppRole = 'INSTALL' | 'SETTINGS' | 'USER_FACING_FORM' | 'UNINSTALL' | 'NONE';
 export interface ProcessForm {
     enabled: boolean;
-}
-export interface ProcessVisibility {
-    isPublic: boolean;
+    appRole?: AppRole;
 }
 export interface ProcessMetadataFields {
     name: string;
@@ -115,7 +114,6 @@ export interface ProcessMetadataFields {
     tags: string[];
     webhook?: ProcessWebhook;
     form?: ProcessForm;
-    visibility?: ProcessVisibility;
 }
 export declare class Process extends Resource {
     id: string;
@@ -126,7 +124,6 @@ export declare class Process extends Resource {
     tags: string[];
     webhook?: ProcessWebhook;
     form?: ProcessForm;
-    visibility?: ProcessVisibility;
     script: {
         parametersSchema: any;
         programmingLanguage: ProgrammingLanguage;

package/dist/core/types.js

@@ -47,7 +47,6 @@ class Process extends Resource {
         this.tags = metadata.tags;
         this.webhook = metadata.webhook;
         this.form = metadata.form;
-        this.visibility = metadata.visibility;
         this.script = script;
         this.readme = readme;
         this.manifest = settings.dependencies.scopedToProcess && manifest !== null ? manifest : { dependencies: [] };
@@ -64,7 +63,6 @@ class Process extends Resource {
             tags: this.tags || [],
             webhook: this.webhook || null,
             form: this.form || null,
-            visibility: this.visibility || null,
             manifestDependencies: this.manifest.dependencies,
             dependenciesScopedToProcess: this.settings.dependencies.scopedToProcess,
         });

package/dist/repositories/process.js

@@ -136,7 +136,6 @@ class ProcessRepository extends resource_1.default {
                 tags: Array.isArray(raw.tags) ? raw.tags : [],
                 webhook: raw.webhook,
                 form: raw.form,
-                visibility: raw.visibility,
             };
         }
         catch (error) {
@@ -157,9 +156,6 @@ class ProcessRepository extends resource_1.default {
         if (process.form !== undefined) {
             metadata.form = process.form;
         }
-        if (process.visibility !== undefined) {
-            metadata.visibility = process.visibility;
-        }
         return metadata;
     }
     async findParameters(processSlug) {

package/dist/services/fcode-graphql-client.js

@@ -43,9 +43,7 @@ const PROCESS_FIELDS = `
   settings {
     formSettings {
       enabled
-    }
-    publicationConfig {
-      isPublic
+      appRole
     }
     dependencies {
       scopedToProcess
@@ -276,9 +274,9 @@ class FcodeGraphQLClient {
         };
         if (process.form) {
             settings.formSettings = { enabled: process.form.enabled };
-        }
-        if (process.visibility) {
-            settings.publicationConfig = { isPublic: process.visibility.isPublic };
+            if (process.form.appRole) {
+                settings.formSettings.appRole = process.form.appRole;
+            }
         }
         const input = {
             name: process.name,
@@ -569,9 +567,9 @@ class FcodeGraphQLClient {
         }
         if (settings?.formSettings) {
             metadata.form = { enabled: Boolean(settings.formSettings.enabled) };
-        }
-        if (settings?.publicationConfig) {
-            metadata.visibility = { isPublic: Boolean(settings.publicationConfig.isPublic) };
+            if (settings.formSettings.appRole && settings.formSettings.appRole !== 'NONE') {
+                metadata.form.appRole = settings.formSettings.appRole;
+            }
         }
         return new types_1.Process(id, slug, script, readme, { dependencies }, settings, metadata, this.inheritedTeam(resolvingTeamSlug));
     }

package/oclif.manifest.json

@@ -41,12 +41,6 @@
           "name": "skipSkillsSetup",
           "allowNo": false,
           "type": "boolean"
-        },
-        "autoSkillsSetup": {
-          "description": "Install the Factorial Code agent skills non-interactively (defaults, project scope) instead of prompting",
-          "name": "autoSkillsSetup",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1485,83 +1479,6 @@
         "set.js"
       ]
     },
-    "team:pull": {
-      "aliases": [],
-      "args": {},
-      "description": "Fetch team settings (timezone, error handler, inheritance) from cloud into team.json",
-      "examples": [
-        "$ fcode team:pull"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "team:pull",
-      "pluginAlias": "@factorialco/fcode-cli",
-      "pluginName": "@factorialco/fcode-cli",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": false,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "pull.js"
-      ]
-    },
-    "team:push": {
-      "aliases": [],
-      "args": {},
-      "description": "Update cloud team settings (timezone, error handler, inheritance) from team.json",
-      "examples": [
-        "$ fcode team:push"
-      ],
-      "flags": {
-        "force": {
-          "char": "f",
-          "description": "Force command",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "team:push",
-      "pluginAlias": "@factorialco/fcode-cli",
-      "pluginName": "@factorialco/fcode-cli",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": false,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "push.js"
-      ]
-    },
-    "team:status": {
-      "aliases": [],
-      "args": {},
-      "description": "Show whether team settings (timezone, error handler, inheritance) differ from the cloud",
-      "examples": [
-        "$ fcode team:status"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "team:status",
-      "pluginAlias": "@factorialco/fcode-cli",
-      "pluginName": "@factorialco/fcode-cli",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": false,
-      "relativePath": [
-        "dist",
-        "commands",
-        "team",
-        "status.js"
-      ]
-    },
     "test:scaffold": {
       "aliases": [],
       "args": {
@@ -1783,7 +1700,84 @@
         "variables",
         "status.js"
       ]
+    },
+    "team:pull": {
+      "aliases": [],
+      "args": {},
+      "description": "Fetch team settings (timezone, error handler, inheritance) from cloud into team.json",
+      "examples": [
+        "$ fcode team:pull"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "team:pull",
+      "pluginAlias": "@factorialco/fcode-cli",
+      "pluginName": "@factorialco/fcode-cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "team",
+        "pull.js"
+      ]
+    },
+    "team:push": {
+      "aliases": [],
+      "args": {},
+      "description": "Update cloud team settings (timezone, error handler, inheritance) from team.json",
+      "examples": [
+        "$ fcode team:push"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "Force command",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "team:push",
+      "pluginAlias": "@factorialco/fcode-cli",
+      "pluginName": "@factorialco/fcode-cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "team",
+        "push.js"
+      ]
+    },
+    "team:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Show whether team settings (timezone, error handler, inheritance) differ from the cloud",
+      "examples": [
+        "$ fcode team:status"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "team:status",
+      "pluginAlias": "@factorialco/fcode-cli",
+      "pluginName": "@factorialco/fcode-cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "team",
+        "status.js"
+      ]
     }
   },
-  "version": "1.3.0"
+  "version": "1.5.0"
 }

package/package.json

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