@factorialco/fcode-cli 1.2.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.2.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

package/bin/run

@@ -1,6 +1,15 @@
 #!/usr/bin/env node
 
-const { run, handle, flush } = require('@oclif/core')
+const { run, handle, flush, settings } = require('@oclif/core')
+
+// This is the production runner: it always executes the compiled `dist/` output,
+// so oclif must never try to auto-transpile TypeScript sources via ts-node.
+// Otherwise, when the caller's environment has NODE_ENV=development or =test,
+// oclif attempts ts-node and prints "Could not find typescript ... Falling back
+// to compiled source" because typescript is (correctly) not installed in the
+// production dependency tree. Auto-transpile stays enabled for local
+// development through `bin/dev`.
+settings.enableAutoTranspile = false
 
 run()
   .catch(async (error) => handle(error))

package/dist/commands/clone.d.ts

@@ -19,6 +19,7 @@ export default class Clone extends Command {
     createWorkspaceLocalVariables(slug: string): Promise<void>;
     private skillsInstallHint;
     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 {
@@ -75,26 +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() {
         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.
+        // 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', ['--yes', 'skills', 'add', SKILLS_REPO, '-s', '*'], { stdio: 'inherit' });
+            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();
             });

package/dist/commands/remote/list.js

@@ -6,6 +6,7 @@ const color_1 = require("@oclif/color");
 const workspace_1 = require("../../config/workspace");
 class RemoteList extends base_command_1.default {
     async init() {
+        await this.parse(RemoteList);
         this.workspaceConfig = new workspace_1.default();
     }
     async run() {

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/dist/services/resource-checker.js

@@ -60,6 +60,9 @@ exports.default = {
                 case types_1.ResourceStatus.OUT_OF_DATE:
                     outOfDateResources.push(remoteResource);
                     break;
+                case types_1.ResourceStatus.SENSITIVITY_CHANGED:
+                    outOfDateResources.push(remoteResource);
+                    break;
                 case types_1.ResourceStatus.REMOTE_REMOVED:
                     remoteRemovedResources.push(localResource);
                     break;

package/oclif.manifest.json

@@ -1779,5 +1779,5 @@
       ]
     }
   },
-  "version": "1.2.0"
+  "version": "1.4.0"
 }

package/package.json

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