@factorialco/fcode-cli 1.3.0 → 1.4.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.4.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,8 +103,10 @@ export interface ProcessWebhook {
     username?: string;
     password?: string;
 }
+export type AppRole = 'INSTALL' | 'SETTINGS' | 'USER_FACING_FORM' | 'NONE';
 export interface ProcessForm {
     enabled: boolean;
+    appRole?: AppRole;
 }
 export interface ProcessVisibility {
     isPublic: boolean;

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

@@ -43,6 +43,7 @@ const PROCESS_FIELDS = `
   settings {
     formSettings {
       enabled
+      appRole
     }
     publicationConfig {
       isPublic
@@ -276,6 +277,9 @@ class FcodeGraphQLClient {
         };
         if (process.form) {
             settings.formSettings = { enabled: process.form.enabled };
+            if (process.form.appRole) {
+                settings.formSettings.appRole = process.form.appRole;
+            }
         }
         if (process.visibility) {
             settings.publicationConfig = { isPublic: process.visibility.isPublic };
@@ -569,6 +573,9 @@ class FcodeGraphQLClient {
         }
         if (settings?.formSettings) {
             metadata.form = { enabled: Boolean(settings.formSettings.enabled) };
+            if (settings.formSettings.appRole && settings.formSettings.appRole !== 'NONE') {
+                metadata.form.appRole = settings.formSettings.appRole;
+            }
         }
         if (settings?.publicationConfig) {
             metadata.visibility = { isPublic: Boolean(settings.publicationConfig.isPublic) };

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,
@@ -1785,5 +1779,5 @@
       ]
     }
   },
-  "version": "1.3.0"
+  "version": "1.4.0"
 }

package/package.json

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