@quonfig/cli 0.0.50 → 0.0.51

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.50 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.51 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -195,7 +195,7 @@ EXAMPLES
   $ qfg activity restore my.flag --yes
 ```
 
-_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/activity.ts)_
+_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/activity.ts)_
 
 ## `qfg activity deleted`
 
@@ -224,7 +224,7 @@ EXAMPLES
   $ qfg activity deleted --json
 ```
 
-_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/activity/deleted.ts)_
+_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/activity/deleted.ts)_
 
 ## `qfg activity feed`
 
@@ -259,7 +259,7 @@ EXAMPLES
   $ qfg activity feed --json
 ```
 
-_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/activity/feed.ts)_
+_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/activity/feed.ts)_
 
 ## `qfg activity history [NAME]`
 
@@ -293,7 +293,7 @@ EXAMPLES
   $ qfg activity history request.timeout --json
 ```
 
-_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/activity/history.ts)_
+_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/activity/history.ts)_
 
 ## `qfg activity restore [NAME]`
 
@@ -332,7 +332,7 @@ EXAMPLES
   $ qfg activity restore request.timeout --type config --yes
 ```
 
-_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/activity/restore.ts)_
+_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/activity/restore.ts)_
 
 ## `qfg audit-log [NAME]`
 
@@ -360,7 +360,7 @@ EXAMPLES
   $ qfg audit-log my.flag
 ```
 
-_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/audit-log.ts)_
+_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/audit-log.ts)_
 
 ## `qfg config-schema`
 
@@ -389,7 +389,7 @@ EXAMPLES
   $ qfg config-schema --json-schema    # full JSON Schema document (copy into your editor)
 ```
 
-_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -474,7 +474,7 @@ EXAMPLES
   $ qfg set-rollout my.new.flag --environment production --true-percent 20
 ```
 
-_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/create.ts)_
 
 ## `qfg delete NAME`
 
@@ -520,7 +520,7 @@ EXAMPLES
   $ qfg delete my.config --yes
 ```
 
-_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/delete.ts)_
+_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/delete.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -665,8 +665,9 @@ FLAGS
   -o, --output-directory=<value>  Override the output directory for generated files
   -w, --workspace=<value>         Workspace slug or UUID for the remote-fetch path (defaults to QUONFIG_WORKSPACE env
                                   var or active profile). Only used when --dir is omitted.
-      --dir=<value>               Path to local QUONFIG_DIR (defaults to QUONFIG_DIR env var). When omitted, fetches the
-                                  workspace from the server using your active credentials.
+      --dir=<value>               Path to local QUONFIG_DIR (defaults to QUONFIG_DIR env var). When omitted,
+                                  auto-detects a quonfig.json in the current directory; if none, fetches the workspace
+                                  from the server.
       --targets=<value>           [default: react-ts] Determines for language/framework to generate code for (node-ts,
                                   react-ts)
 
@@ -723,7 +724,7 @@ EXAMPLES
   $ qfg generate --targets node-ts -o ./dist # combine with targets
 ```
 
-_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -746,7 +747,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -778,7 +779,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/get.ts)_
 
 ## `qfg history NAME`
 
@@ -804,7 +805,7 @@ EXAMPLES
   $ qfg history my.flag
 ```
 
-_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/history.ts)_
+_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/history.ts)_
 
 ## `qfg info [NAME]`
 
@@ -852,7 +853,7 @@ EXAMPLES
   $ qfg info my.config.name --exclude-evaluations   # skip 24h stats
 ```
 
-_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -892,7 +893,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -922,7 +923,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -962,7 +963,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/list.ts)_
 
 ## `qfg log`
 
@@ -987,7 +988,7 @@ EXAMPLES
   $ qfg log --limit 5
 ```
 
-_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/log.ts)_
+_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/log.ts)_
 
 ## `qfg log-level NAME`
 
@@ -1052,7 +1053,7 @@ EXAMPLES
   $ qfg log-level log-level.my-app --target=Chatty --value=INFO --environment=production
 ```
 
-_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/log-level.ts)_
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/log-level.ts)_
 
 ## `qfg login`
 
@@ -1077,7 +1078,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -1100,7 +1101,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/logout.ts)_
 
 ## `qfg migrate`
 
@@ -1123,8 +1124,9 @@ FLAGS
   --full-summary            Reify the full source-side audit log into per-change git commits (author = original user,
                             date = original timestamp, message = change summary). Only valid on first-run imports — pass
                             --reset to re-import everything from scratch with this flag.
-  --project=<value>         [default: default] LaunchDarkly project key to migrate from (or set
-                            LAUNCHDARKLY_PROJECT_KEY). Scoped to `--from launchdarkly`; ignored by other sources.
+  --project=<value>         Source-system project identifier. For --from launchdarkly this is the project KEY (default:
+                            "default"; env: LAUNCHDARKLY_PROJECT_KEY). For --from flagsmith this is the numeric project
+                            ID (env: FLAGSMITH_PROJECT_ID). Ignored by --from launch.
   --push                    After migrating to a local dir, also push to the given --workspace on Quonfig cloud
   --recent=<value>          Import only the last N changes (useful for tire-kicking)
   --reset                   Ignore the delta cursor and re-import everything from scratch
@@ -1162,7 +1164,7 @@ EXAMPLES
   $ qfg migrate --from launch --source-api-key $LAUNCH_API_KEY --dir ./quonfig-repo --staging
 ```
 
-_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -1200,7 +1202,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -1232,7 +1234,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -1263,7 +1265,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME] [VALUE]`
 
@@ -1318,7 +1320,7 @@ EXAMPLES
   $ qfg override my.flag true --env=staging
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -1366,7 +1368,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -1415,7 +1417,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/push.ts)_
 
 ## `qfg run [COMMAND]`
 
@@ -1466,7 +1468,7 @@ EXAMPLES
   $ qfg run --env DATABASE_URL=db.url --preserve-env --environment=staging -- npm test
 ```
 
-_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/run.ts)_
+_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/run.ts)_
 
 ## `qfg schema NAME`
 
@@ -1504,7 +1506,7 @@ EXAMPLES
   $ qfg schema my-schema --set-json-schema=@schemas/my-schema.json --protected
 ```
 
-_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1531,7 +1533,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1563,7 +1565,7 @@ EXAMPLES
   $ qfg sdk-key create --environment staging --type browser
 ```
 
-_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1592,7 +1594,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1619,7 +1621,7 @@ EXAMPLES
   $ qfg sdk-key revoke a1b2c3d4-e5f6-7890-abcd-ef1234567890
 ```
 
-_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1690,7 +1692,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -1767,7 +1769,7 @@ EXAMPLES
   $ qfg set-rollout my.variant.flag --environment production --weights "a:33,b:33,c:34" --hash-by user.id
 ```
 
-_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -1799,7 +1801,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -1901,7 +1903,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -1924,7 +1926,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -1947,7 +1949,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -1980,7 +1982,7 @@ EXAMPLES
   $ qfg workspace bootstrap --dir ./our-config --skip-validate
 ```
 
-_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace create SLUG`
 
@@ -2014,7 +2016,7 @@ EXAMPLES
   $ qfg workspace create my-team --org 11111111-1111-1111-1111-111111111111
 ```
 
-_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/workspace/create.ts)_
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -2042,7 +2044,7 @@ EXAMPLES
   $ qfg workspace switch acme/production
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.51/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/commands/generate.js

@@ -9,6 +9,7 @@ import { LocalConfigReader } from '../codegen/local-config-reader.js';
 import { SupportedLanguage } from '../codegen/types.js';
 import { BaseCommand } from '../index.js';
 import { createFileManager } from '../util/file-manager.js';
+import { resolveWorkspaceDir } from '../util/resolve-workspace-dir.js';
 // base types
 const nodeOrReactLanguageSpecificSchema = z.object({
     clientFileName: z.string().optional(),
@@ -110,7 +111,7 @@ Example quonfig.config.json:
     ];
     static flags = {
         dir: Flags.string({
-            description: 'Path to local QUONFIG_DIR (defaults to QUONFIG_DIR env var). When omitted, fetches the workspace from the server using your active credentials.',
+            description: 'Path to local QUONFIG_DIR (defaults to QUONFIG_DIR env var). When omitted, auto-detects a quonfig.json in the current directory; if none, fetches the workspace from the server.',
             env: 'QUONFIG_DIR',
         }),
         'output-directory': Flags.string({
@@ -132,12 +133,27 @@ Example quonfig.config.json:
         this.verboseLog('=== GENERATE COMMAND START ===');
         let snapshot;
         try {
-            // When --dir/QUONFIG_DIR is set, read the local checkout (so users
-            // who edit flag JSON in place keep that workflow). Otherwise clone
-            // the workspace into a tmp dir for codegen-only callers.
+            // Resolution order (qfg-local-codegen):
+            //   1. --dir / QUONFIG_DIR (explicit local checkout)
+            //   2. Walk up from cwd looking for quonfig.json (no-account/local-only
+            //      path — same resolver `qfg push` / `qfg pull` use)
+            //   3. Server snapshot clone (codegen-only callers without a checkout)
+            // --workspace is only meaningful for the server-snapshot path; if the
+            // user passed it explicitly, skip the cwd walk and go straight to fetch.
             let dir = flags.dir;
+            if (!dir && !flags.workspace) {
+                const resolved = resolveWorkspaceDir({
+                    cwd: process.cwd(),
+                    envDir: undefined, // QUONFIG_DIR is already merged into flags.dir by oclif
+                    flagDir: undefined,
+                });
+                if (resolved.kind === 'ok') {
+                    dir = resolved.dir;
+                    console.log(`Using local workspace at ${dir} (auto-detected quonfig.json).`);
+                }
+            }
             if (!dir) {
-                this.verboseLog('No --dir/QUONFIG_DIR set; fetching workspace snapshot from server...');
+                this.verboseLog('No local workspace found; fetching workspace snapshot from server...');
                 snapshot = await fetchWorkspaceSnapshot(this, { workspace: flags.workspace });
                 dir = snapshot.dir;
             }

package/dist/commands/migrate.d.ts

@@ -9,7 +9,7 @@ export default class Migrate extends BaseCommand {
         'dry-run': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         from: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         'full-summary': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
-        project: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        project: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         push: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         recent: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         reset: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;

package/dist/commands/migrate.js

@@ -10,6 +10,8 @@ import { MigratorVerifyError, pushMigrationToCloud } from '../migrate/push-to-cl
 import { UnknownSourceError, getSource } from '../migrate/registry.js';
 import { NotYetImplementedError, } from '../migrate/source.js';
 import { missingSourceApiKeyMessage, resolveSourceApiKey } from '../migrate/source-api-key.js';
+import { applyFlagsmithBaseUrl } from '../migrate/sources/flagsmith/api.js';
+import { setFlagsmithProjectId } from '../migrate/sources/flagsmith.js';
 import { applyLaunchBaseUrl } from '../migrate/sources/launch/api.js';
 import { applyLaunchDarklyBaseUrl } from '../migrate/sources/launchdarkly/api.js';
 import { getLaunchDarklyRetentionHorizon, setLaunchDarklyFullSummary, setLaunchDarklyProjectKey, } from '../migrate/sources/launchdarkly.js';
@@ -55,10 +57,9 @@ export default class Migrate extends BaseCommand {
                 'Only valid on first-run imports — pass --reset to re-import everything from scratch with this flag.',
         }),
         project: Flags.string({
-            default: 'default',
-            description: 'LaunchDarkly project key to migrate from (or set LAUNCHDARKLY_PROJECT_KEY). ' +
-                'Scoped to `--from launchdarkly`; ignored by other sources.',
-            env: 'LAUNCHDARKLY_PROJECT_KEY',
+            description: 'Source-system project identifier. For --from launchdarkly this is the project KEY (default: "default"; ' +
+                'env: LAUNCHDARKLY_PROJECT_KEY). For --from flagsmith this is the numeric project ID (env: FLAGSMITH_PROJECT_ID). ' +
+                'Ignored by --from launch.',
         }),
         push: Flags.boolean({
             default: false,
@@ -149,9 +150,19 @@ export default class Migrate extends BaseCommand {
             // --full-summary swaps the snapshot for the Phase-2 audit-log walk (the
             // walk's own resume cursor lives in os.tmpdir, not in `dir`).
             applyLaunchDarklyBaseUrl();
-            setLaunchDarklyProjectKey(flags.project);
+            setLaunchDarklyProjectKey(flags.project ?? process.env.LAUNCHDARKLY_PROJECT_KEY ?? 'default');
             setLaunchDarklyFullSummary(flags['full-summary']);
         }
+        if (flags.from === 'flagsmith') {
+            // Flagsmith projects are numeric IDs. --project is a string flag because
+            // it's source-shared; we just pass it through. The Flagsmith source's
+            // own resolveProjectId() honours FLAGSMITH_PROJECT_ID at module-load if
+            // --project isn't passed.
+            applyFlagsmithBaseUrl();
+            const projectId = flags.project ?? process.env.FLAGSMITH_PROJECT_ID;
+            if (projectId)
+                setFlagsmithProjectId(projectId);
+        }
         let source;
         try {
             source = getSource(flags.from);

package/dist/init/templates.js

@@ -25,22 +25,50 @@ This is a [Quonfig](https://quonfig.com) workspace repository. All configuration
 | \`schemas/\` | JSON Schemas that configs can reference for validation |
 | \`schemas-protected/\` | Admin-only schemas |
 
-## Quick start
+## Quick start (works fully offline — no account required)
+
+This workspace is just a git repo full of JSON files. You can edit those files
+directly, validate them locally, and point any Quonfig SDK at this directory.
+No login, no API call, no internet connection needed.
 
 \`\`\`bash
-# Validate the workspace
+# 1. Edit a flag — see the sample files in feature-flags/ for the shape.
+$EDITOR feature-flags/my.new.flag.json
+
+# 2. Validate the workspace.
 qfg verify
 
-# Create a new feature flag
-qfg create my.new.flag --type=boolean-flag
+# 3. (Optional) Generate TypeScript types for your app.
+qfg generate
 
-# List all configs
-qfg list
+# 4. Commit. The pre-commit hook re-runs qfg verify automatically.
+git add . && git commit -m "Add my.new.flag"
 \`\`\`
 
+## Two ways to use this repo
+
+**Open-source / fully local.** Edit JSON, run \`qfg verify\`, point your SDK
+at this directory (\`datadir: "./quonfig"\`). Push the repo wherever you want
+(GitHub, self-hosted Gitea, your own server). This is the no-account path.
+
+**Hosted Quonfig.** If you also have a Quonfig account, server-side commands
+like \`qfg push\`, \`qfg create\`, \`qfg list\`, \`qfg set-default\`, and
+\`qfg get\` give you a UI, real-time SSE delivery to SDKs, evaluation
+telemetry, and audit history. These all require \`qfg login\`.
+
+## Local-only commands (no login required)
+
+| Command | What it does |
+|---------|--------------|
+| \`qfg init\` | Re-initialize this workspace (idempotent, refreshes templates) |
+| \`qfg verify\` | Validate every JSON file against the schema and cross-file rules |
+| \`qfg generate\` | Generate typed SDK client code from the configs in this dir |
+| \`qfg config-schema\` | Print the canonical config schema (great for AI agents) |
+| \`qfg migrate\` | Import flags from LaunchDarkly, Flagsmith, etc. |
+
 ## Schema
 
-Config files reference the hosted JSON Schema at <https://api.quonfig.com/schemas/v1/stored-config.json> via their \`$schema\` field. Editors that support JSON Schema will provide autocomplete and validation automatically.
+Config files reference the hosted JSON Schema at <https://api.quonfig.com/schemas/v1/stored-config.json> via their \`$schema\` field. Editors that support JSON Schema will provide autocomplete and validation automatically. The schema URL is fetched once by your editor's LSP — the CLI and SDK don't need it.
 
 ## Validation
 
@@ -55,7 +83,24 @@ export function claudeMdTemplate() {
 
 This is a Quonfig workspace repository. Configuration is stored as JSON files in git.
 
-**After every change to this repo, run \`qfg verify\` to validate.**
+## How to work in this repo
+
+**You edit JSON files directly.** Do not run \`qfg create\`, \`qfg set-default\`,
+\`qfg set-rollout\`, \`qfg override\`, \`qfg push\`, \`qfg pull\`, \`qfg get\`,
+or \`qfg list\` — those commands talk to a hosted Quonfig server. In a local
+workspace, the source of truth is this git repo, so edit JSON in place.
+
+The complete local-only toolkit:
+
+| Command | When to use |
+|---------|-------------|
+| \`qfg verify\` | After every change. Validates schema + cross-file rules. |
+| \`qfg config-schema\` | Print the canonical schema. Use this to look up field names, operator enums, value-type shapes before you write a new config. |
+| \`qfg generate\` | Regenerate typed SDK client code (consumers ask for this; you usually won't need to run it unless asked). |
+| Read existing files | Look at sibling JSON files in the same directory for the canonical shape before writing a new one. |
+
+**After every change to this repo, run \`qfg verify\` to validate.** If it
+fails, fix the JSON until it passes — do not ship a broken workspace.
 
 ## JSON Schema
 
@@ -144,10 +189,12 @@ This is a Quonfig workspace repository. See \`CLAUDE.md\` for the complete schem
 
 ## Key rules
 
-1. **Always validate**: run \`qfg verify\` after any change to this repo.
-2. Filename must match the \`key\` field (e.g. \`my.flag.json\` has \`"key": "my.flag"\`).
-3. Files must be in the correct directory for their \`type\`.
-4. See \`CLAUDE.md\` for the full list of value types, operators, and constraints.
+1. **Edit JSON files directly.** Do NOT use \`qfg create\`, \`qfg set-default\`, \`qfg push\`, \`qfg get\`, or \`qfg list\` — those require a hosted Quonfig account. The source of truth here is the git repo.
+2. **Always validate**: run \`qfg verify\` after any change to this repo.
+3. **Look before you leap**: read sibling JSON files for the canonical shape, and run \`qfg config-schema\` to confirm field names, operator enums, and value types before writing a new config.
+4. Filename must match the \`key\` field (e.g. \`my.flag.json\` has \`"key": "my.flag"\`).
+5. Files must be in the correct directory for their \`type\`.
+6. See \`CLAUDE.md\` for the full list of value types, operators, and constraints.
 `;
 }
 // ── Pre-commit hook ────────────────────────────────────────────────────