@factorialco/fcode-cli 1.1.1 → 1.3.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @factorialco/fcode-cli
 $ fcode COMMAND
 running command...
 $ fcode (--version)
-@factorialco/fcode-cli/1.1.1 linux-x64 node-v22.22.3
+@factorialco/fcode-cli/1.3.0 linux-x64 node-v22.22.3
 $ fcode --help [COMMAND]
 USAGE
   $ fcode COMMAND
@@ -100,12 +100,14 @@ Clone team workspace from cloud
 
 ```
 USAGE
-  $ fcode clone [TEAM] [--skipSkillsSetup]
+  $ fcode clone [TEAM] [--skipSkillsSetup] [--autoSkillsSetup]
 
 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/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

@@ -8,17 +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): Promise<void>;
+    cloneTeam(origin: TeamOrigin, skipSkillsSetup?: boolean, autoSkillsSetup?: 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(): Promise<void>;
+    setupSkills(autoSkillsSetup?: boolean): Promise<void>;
     catch(error: any): Promise<void>;
     init(): Promise<void>;
     mkdirWorkspace(slug: string): Promise<void>;

package/dist/commands/clone.js

@@ -41,7 +41,7 @@ class Clone extends core_1.Command {
             });
         }
     }
-    async cloneTeam(origin, skipSkillsSetup = false) {
+    async cloneTeam(origin, skipSkillsSetup = false, autoSkillsSetup = false) {
         await this.mkdirWorkspace(origin.slug);
         await this.createWorkspaceConfig(origin);
         await this.createWorkspaceGitIgnore(origin.slug);
@@ -51,7 +51,7 @@ class Clone extends core_1.Command {
         process.chdir(origin.slug);
         await pull_1.default.run([]);
         if (!skipSkillsSetup) {
-            await this.setupSkills();
+            await this.setupSkills(autoSkillsSetup);
         }
     }
     async createWorkspaceConfig(origin) {
@@ -79,12 +79,18 @@ class Clone extends core_1.Command {
         cli_1.default.log('💡 Install the Factorial Code agent skills later with:');
         cli_1.default.log(`   npx skills add ${SKILLS_REPO} -s '*'`);
     }
-    async setupSkills() {
+    async setupSkills(autoSkillsSetup = false) {
         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');
+        }
         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?).");
@@ -161,7 +167,11 @@ class Clone extends core_1.Command {
         if (skipSkillsSetup === undefined) {
             skipSkillsSetup = (await new global_1.default().getSetting(settings_1.SettingKeys.SKIP_SKILLS_SETUP)) === 'true';
         }
-        await this.cloneTeam({ url, slug }, skipSkillsSetup);
+        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);
         cli_1.default.log(`\n🎉  ${args.team} team workspace cloned successfully!\n`);
         cli_1.default.log(`$ cd ${slug}\n`);
     }
@@ -173,5 +183,8 @@ 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/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/config/settings.d.ts

@@ -4,6 +4,7 @@ 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,6 +4,7 @@ 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";
@@ -28,6 +29,11 @@ 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/executors/javascript-execution-task.js

@@ -587,7 +587,14 @@ const main = typeof _hooksModule['${fn}'] === 'function'
               console.log('[fcode] variables.delete removed ' + key + ' from variables.local.env (local run).');
             }
           };
-        })()
+        })(),
+        sendMail: async ({ to, subject, text, html } = {}) => {
+          // No manager locally: log the email contents instead of sending, so
+          // devs can see exactly what would be delivered when run in the cloud.
+          console.log('[fcode] sendMail (local run) — not sent, logging contents below:');
+          console.log(JSON.stringify({ to, subject, text, html }, null, 2));
+          return { messageId: 'local-run', accepted: [].concat(to || []), rejected: [] };
+        }
       };
       ${Object.entries(this.getVariablesObject())
                 .map(([key, value]) => `process.env['${key}'] = process.env['${key}'] ?? ${JSON.stringify(value)}`)

package/dist/env.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+/**
+ * Validated environment schema for the fcode CLI. This is the single source of truth
+ * for the environment variables the CLI reads — add new vars here.
+ *
+ * Unlike the long-running services (storage-api, ai), a CLI reads config lazily and
+ * different commands need different vars, so there is currently NO universally required
+ * variable: every entry is optional or carries a default that preserves prior behavior.
+ * The fail-fast (❌ + exit 1) path is kept for parity with the services and so that a
+ * genuinely-required var added later fails at process start listing every problem.
+ */
+export declare const envSchema: z.ZodObject<{
+    FCODE_CLOUD_URL: z.ZodDefault<z.ZodString>;
+    FCODE_AUTH_URL: z.ZodOptional<z.ZodString>;
+    FCODE_CLIENT_ID: z.ZodDefault<z.ZodString>;
+    FCODE_CONFIG_PATH: z.ZodOptional<z.ZodString>;
+    IGNORE_WORKSPACE_NOT_EMPTY: z.ZodOptional<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>;
+    FCODE_DISABLE_UPDATE_NOTIFIER: z.ZodOptional<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>;
+    SILENT_MODE: z.ZodOptional<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>;
+    CLI_UX_SKIP_TTY_CHECK: z.ZodOptional<z.ZodString>;
+    YC_COMMAND: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const env: {
+    FCODE_CLOUD_URL: string;
+    FCODE_CLIENT_ID: string;
+    FCODE_AUTH_URL?: string | undefined;
+    FCODE_CONFIG_PATH?: string | undefined;
+    IGNORE_WORKSPACE_NOT_EMPTY?: "true" | "false" | undefined;
+    FCODE_DISABLE_UPDATE_NOTIFIER?: "true" | "false" | undefined;
+    SILENT_MODE?: "true" | "false" | undefined;
+    CLI_UX_SKIP_TTY_CHECK?: string | undefined;
+    YC_COMMAND?: string | undefined;
+};
+export default env;

package/dist/env.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.env = exports.envSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Validated environment schema for the fcode CLI. This is the single source of truth
+ * for the environment variables the CLI reads — add new vars here.
+ *
+ * Unlike the long-running services (storage-api, ai), a CLI reads config lazily and
+ * different commands need different vars, so there is currently NO universally required
+ * variable: every entry is optional or carries a default that preserves prior behavior.
+ * The fail-fast (❌ + exit 1) path is kept for parity with the services and so that a
+ * genuinely-required var added later fails at process start listing every problem.
+ */
+exports.envSchema = zod_1.z.object({
+    // --- Cloud / auth endpoints ---
+    FCODE_CLOUD_URL: zod_1.z.string().min(1).default('https://code.factorial.dev/platform'),
+    FCODE_AUTH_URL: zod_1.z.string().min(1).optional(),
+    FCODE_CLIENT_ID: zod_1.z.string().min(1).default('cli'),
+    // --- Local config location (defaults to os.homedir() at the call site) ---
+    FCODE_CONFIG_PATH: zod_1.z.string().min(1).optional(),
+    // --- Behavior flags (compared as the strings 'true' / 'false' at the call sites) ---
+    IGNORE_WORKSPACE_NOT_EMPTY: zod_1.z.enum(['true', 'false']).optional(),
+    FCODE_DISABLE_UPDATE_NOTIFIER: zod_1.z.enum(['true', 'false']).optional(),
+    SILENT_MODE: zod_1.z.enum(['true', 'false']).optional(),
+    CLI_UX_SKIP_TTY_CHECK: zod_1.z.string().min(1).optional(),
+    // --- Debug tooling ---
+    YC_COMMAND: zod_1.z.string().min(1).optional(),
+});
+/** Treat empty strings (e.g. an unset shell/dotenv var rendered as "") as missing. */
+const raw = Object.fromEntries(Object.entries(process.env).filter(([, value]) => value !== ''));
+/**
+ * Skip the hard fail-fast under test runners and when explicitly opted out, so importing
+ * this module never kills a test worker. Real invocations always validate.
+ */
+const skipHardExit = Boolean(process.env.VITEST) || process.env.SKIP_ENV_VALIDATION === 'true';
+const result = exports.envSchema.safeParse(raw);
+let parsed;
+if (result.success) {
+    parsed = result.data;
+}
+else if (skipHardExit) {
+    // No universally-required vars today, so parsing `raw` alone succeeds; this branch stays
+    // for parity with the services if a required var is ever added.
+    parsed = exports.envSchema.parse(raw);
+}
+else {
+    const issues = result.error.issues.map((issue) => `  - ${issue.path.join('.') || '(root)'}: ${issue.message}`).join('\n');
+    process.stderr.write(`❌ Invalid environment variables:\n${issues}\n`);
+    process.exit(1);
+}
+exports.env = parsed;
+exports.default = exports.env;

package/dist/hooks/init/update.js

@@ -20,14 +20,12 @@ const updateNotifier = async function ({ config, id }) {
             await globalConfig.set('versionCheckTime', now);
             if (config.version !== lastestVersion) {
                 console.log(`
-        ${color_1.default.cyan(`__     __         _____          _
-        \\ \\   / /        / ____|        | |
-         \\ \\_/ /__ _ __ | |     ___   __| | ___
-          \\   / _ \\ '_ \\| |    / _ \\ / _\` |/ _ \\
-           | |  __/ |_) | |___| (_) | (_| |  __/
-           |_|\\___| .__/ \\_____\\___/ \\__,_|\\___|
-                  | |
-                  |_|`)}
+        ${color_1.default.cyan(` ______         _             _       _  _____          _
+        |  ____|       | |           (_)     | |/ ____|        | |
+        | |__ __ _  ___| |_ ___  _ __ _  __ _| | |     ___   __| | ___
+        |  __/ _\` |/ __| __/ _ \\| '__| |/ _\` | | |    / _ \\ / _\` |/ _ \\
+        | | | (_| | (__| || (_) | |  | | (_| | | |___| (_) | (_| |  __/
+        |_|  \\__,_|\\___|\\__\\___/|_|  |_|\\__,_|_|\\_____\\___/ \\__,_|\\___|`)}
 
         Update available ${color_1.default.red(config.version)} → ${color_1.default.greenBright(lastestVersion)}
         Run ${color_1.default.bold('`npm i -g @factorialco/fcode-cli`')} to update

package/dist/runtime/libs/python/fcode/context.py

@@ -90,6 +90,25 @@ class FcodeGlobal:
         self.variables = variables
         self.processes = Processes()
 
+    def send_mail(self, to=None, subject=None, text=None, html=None):
+        # No manager locally: log the email contents instead of sending, so devs
+        # can see exactly what would be delivered when run in the cloud.
+        import json
+        import logging
+
+        logger = logging.getLogger("fcode_logger")
+        logger.info(
+            "[fcode] send_mail (local run) — not sent, logging contents below:"
+        )
+        logger.info(
+            json.dumps(
+                {"to": to, "subject": subject, "text": text, "html": html},
+                indent=2,
+            )
+        )
+        accepted = to if isinstance(to, list) else ([to] if to else [])
+        return {"messageId": "local-run", "accepted": accepted, "rejected": []}
+
     def import_module(self, module_name, version=None):
         module_path = module_name
         if version:

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@factorialco/fcode-cli",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "packageManager": "pnpm@11.7.0",
   "description": "Factorial Code Command Line Interface",
   "homepage": "https://code.factorialhr.com/docs/cli/",
@@ -40,7 +40,8 @@
     "open": "^8.4.2",
     "openid-client": "^5.6.5",
     "string-width": "^4.2.3",
-    "strip-comments": "^2.0.1"
+    "strip-comments": "^2.0.1",
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "graphql-request": "^7.4.0",