@quonfig/cli 0.0.52 → 0.0.53

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.52 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.53 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -157,6 +157,7 @@ script doesn't need to know which env it's running in.
 * [`qfg sdk-key create`](#qfg-sdk-key-create)
 * [`qfg sdk-key list`](#qfg-sdk-key-list)
 * [`qfg sdk-key revoke KEYID`](#qfg-sdk-key-revoke-keyid)
+* [`qfg serve`](#qfg-serve)
 * [`qfg set-default [NAME]`](#qfg-set-default-name)
 * [`qfg set-rollout [NAME]`](#qfg-set-rollout-name)
 * [`qfg sync`](#qfg-sync)
@@ -195,7 +196,7 @@ EXAMPLES
   $ qfg activity restore my.flag --yes
 ```
 
-_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/activity.ts)_
+_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/activity.ts)_
 
 ## `qfg activity deleted`
 
@@ -224,7 +225,7 @@ EXAMPLES
   $ qfg activity deleted --json
 ```
 
-_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/activity/deleted.ts)_
+_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/activity/deleted.ts)_
 
 ## `qfg activity feed`
 
@@ -259,7 +260,7 @@ EXAMPLES
   $ qfg activity feed --json
 ```
 
-_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/activity/feed.ts)_
+_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/activity/feed.ts)_
 
 ## `qfg activity history [NAME]`
 
@@ -293,7 +294,7 @@ EXAMPLES
   $ qfg activity history request.timeout --json
 ```
 
-_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/activity/history.ts)_
+_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/activity/history.ts)_
 
 ## `qfg activity restore [NAME]`
 
@@ -332,7 +333,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.52/src/commands/activity/restore.ts)_
+_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/activity/restore.ts)_
 
 ## `qfg audit-log [NAME]`
 
@@ -360,7 +361,7 @@ EXAMPLES
   $ qfg audit-log my.flag
 ```
 
-_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/audit-log.ts)_
+_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/audit-log.ts)_
 
 ## `qfg config-schema`
 
@@ -389,7 +390,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.52/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -474,7 +475,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.52/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/create.ts)_
 
 ## `qfg delete NAME`
 
@@ -520,7 +521,7 @@ EXAMPLES
   $ qfg delete my.config --yes
 ```
 
-_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/delete.ts)_
+_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/delete.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -724,7 +725,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.52/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -747,7 +748,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -779,7 +780,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/get.ts)_
 
 ## `qfg history NAME`
 
@@ -805,7 +806,7 @@ EXAMPLES
   $ qfg history my.flag
 ```
 
-_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/history.ts)_
+_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/history.ts)_
 
 ## `qfg info [NAME]`
 
@@ -853,7 +854,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.52/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -893,7 +894,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -923,7 +924,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -963,7 +964,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/list.ts)_
 
 ## `qfg log`
 
@@ -988,7 +989,7 @@ EXAMPLES
   $ qfg log --limit 5
 ```
 
-_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/log.ts)_
+_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/log.ts)_
 
 ## `qfg log-level NAME`
 
@@ -1053,7 +1054,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.52/src/commands/log-level.ts)_
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/log-level.ts)_
 
 ## `qfg login`
 
@@ -1078,7 +1079,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -1101,7 +1102,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/logout.ts)_
 
 ## `qfg migrate`
 
@@ -1164,7 +1165,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.52/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -1202,7 +1203,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -1234,7 +1235,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -1265,7 +1266,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME] [VALUE]`
 
@@ -1320,7 +1321,7 @@ EXAMPLES
   $ qfg override my.flag true --env=staging
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -1368,7 +1369,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -1417,7 +1418,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/push.ts)_
 
 ## `qfg run [COMMAND]`
 
@@ -1468,7 +1469,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.52/src/commands/run.ts)_
+_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/run.ts)_
 
 ## `qfg schema NAME`
 
@@ -1506,7 +1507,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.52/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1533,7 +1534,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1565,7 +1566,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.52/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1594,7 +1595,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1621,7 +1622,64 @@ 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.52/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/sdk-key/revoke.ts)_
+
+## `qfg serve`
+
+Serve a local datadir over HTTP to browser/RN SDKs.
+
+```
+USAGE
+  $ qfg serve [--json] [--interactive] [--no-color] [--verbose] [--datadir <value>] [--environment <value>]
+    [--port <value>] [--host <value>] [--frontend-sdk-key <value>] [--cors-origin <value>...] [--watch]
+    [--allow-non-loopback]
+
+FLAGS
+  --allow-non-loopback        Confirm a LAN-reachable bind. Required when --host is not loopback.
+  --cors-origin=<value>...    [default: *] Allowed CORS origin (repeatable). Default is *; required when binding to a
+                              non-loopback host.
+  --datadir=<value>           Datadir to serve (defaults to ./our-config, then ./.quonfig, then errors). Honors
+                              QUONFIG_DIR.
+  --environment=<value>       [default: development] Which environment slug to evaluate. Honors QUONFIG_ENVIRONMENT.
+  --frontend-sdk-key=<value>  If set, every request must present Authorization: Basic 1:<key>. If unset, the server is
+                              open (matches the "datadir is the source of truth" mental model).
+  --host=<value>              [default: 127.0.0.1] Bind address. Loopback by default; non-loopback requires
+                              --allow-non-loopback.
+  --port=<value>              [default: 6580] TCP port to listen on. Errors on collision; pass --port <n> to retry.
+  --[no-]watch                Reload the envelope when the datadir changes. --no-watch disables.
+
+GLOBAL FLAGS
+  --[no-]interactive  Force interactive mode
+  --json              Format output as json.
+  --no-color          Do not colorize output
+  --verbose           Verbose output
+
+DESCRIPTION
+  Serve a local datadir over HTTP to browser/RN SDKs.
+
+  Reads configs from a local datadir and exposes them at
+  `GET /api/v2/configs/eval-with-context/{base64url(ctx)}`. Point your
+  browser SDK at the resulting URL (`http://localhost:6580` by default)
+  and the same client code that talks to api-delivery in production will
+  work unmodified.
+
+  Telemetry is intentionally not served — qfg serve has no Quonfig backend
+  behind it. Disable client-side telemetry with
+  `collectEvaluationSummaries: false` (and `contextUploadMode: "none"`),
+  or point the SDK's `telemetryUrl` at a real endpoint.
+
+  The server is bound to 127.0.0.1 by default; pass --allow-non-loopback
+  to confirm a LAN-reachable bind.
+
+EXAMPLES
+  $ qfg serve
+
+  $ qfg serve --datadir ./our-config --environment production
+
+  $ qfg serve --port 6581 --frontend-sdk-key PUBLIC_KEY
+```
+
+_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/serve.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1692,7 +1750,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -1769,7 +1827,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.52/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -1801,7 +1859,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -1903,7 +1961,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -1926,7 +1984,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -1949,7 +2007,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -1982,7 +2040,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.52/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace create SLUG`
 
@@ -2016,7 +2074,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.52/src/commands/workspace/create.ts)_
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -2044,7 +2102,7 @@ EXAMPLES
   $ qfg workspace switch acme/production
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.52/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.53/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/commands/run.js

@@ -241,7 +241,6 @@ The flag separator '--' is REQUIRED between qfg flags and the child command.`;
         const quonfig = new Quonfig({
             sdkKey,
             collectEvaluationSummaries: false,
-            collectLoggerCounts: false,
             contextUploadMode: 'none',
             enableSSE: false,
             apiUrls: [getDeliveryUrl()],

package/dist/commands/serve.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `qfg serve` — Node-native local server that exposes a datadir over the
+ * same HTTP protocol the browser SDKs already speak. Designed to close the
+ * "browser SDKs can't read a local datadir" gap (epic qfg-38sf, plan
+ * project/plans/qfg-serve.md, Option A).
+ */
+import type { JsonObj } from '../result.js';
+import { BaseCommand } from '../index.js';
+export default class Serve extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        datadir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        port: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        host: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'frontend-sdk-key': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'cors-origin': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[], import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        watch: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'allow-non-loopback': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<JsonObj | void>;
+}

package/dist/commands/serve.js

@@ -0,0 +1,136 @@
+/**
+ * `qfg serve` — Node-native local server that exposes a datadir over the
+ * same HTTP protocol the browser SDKs already speak. Designed to close the
+ * "browser SDKs can't read a local datadir" gap (epic qfg-38sf, plan
+ * project/plans/qfg-serve.md, Option A).
+ */
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../index.js';
+import { resolveDatadirForServe } from '../serve/datadir-discovery.js';
+import { startServer } from '../serve/server.js';
+export default class Serve extends BaseCommand {
+    static description = `Serve a local datadir over HTTP to browser/RN SDKs.
+
+Reads configs from a local datadir and exposes them at
+\`GET /api/v2/configs/eval-with-context/{base64url(ctx)}\`. Point your
+browser SDK at the resulting URL (\`http://localhost:6580\` by default)
+and the same client code that talks to api-delivery in production will
+work unmodified.
+
+Telemetry is intentionally not served — qfg serve has no Quonfig backend
+behind it. Disable client-side telemetry with
+\`collectEvaluationSummaries: false\` (and \`contextUploadMode: "none"\`),
+or point the SDK's \`telemetryUrl\` at a real endpoint.
+
+The server is bound to 127.0.0.1 by default; pass --allow-non-loopback
+to confirm a LAN-reachable bind.`;
+    static examples = [
+        '<%= config.bin %> serve',
+        '<%= config.bin %> serve --datadir ./our-config --environment production',
+        '<%= config.bin %> serve --port 6581 --frontend-sdk-key PUBLIC_KEY',
+    ];
+    static flags = {
+        datadir: Flags.string({
+            description: 'Datadir to serve (defaults to ./our-config, then ./.quonfig, then errors). Honors QUONFIG_DIR.',
+        }),
+        environment: Flags.string({
+            default: 'development',
+            description: 'Which environment slug to evaluate. Honors QUONFIG_ENVIRONMENT.',
+        }),
+        port: Flags.integer({
+            default: 6580,
+            description: 'TCP port to listen on. Errors on collision; pass --port <n> to retry.',
+        }),
+        host: Flags.string({
+            default: '127.0.0.1',
+            description: 'Bind address. Loopback by default; non-loopback requires --allow-non-loopback.',
+        }),
+        'frontend-sdk-key': Flags.string({
+            description: 'If set, every request must present Authorization: Basic 1:<key>. ' +
+                'If unset, the server is open (matches the "datadir is the source of truth" mental model).',
+        }),
+        'cors-origin': Flags.string({
+            default: ['*'],
+            description: 'Allowed CORS origin (repeatable). Default is *; required when binding to a non-loopback host.',
+            multiple: true,
+        }),
+        watch: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Reload the envelope when the datadir changes. --no-watch disables.',
+        }),
+        'allow-non-loopback': Flags.boolean({
+            default: false,
+            description: 'Confirm a LAN-reachable bind. Required when --host is not loopback.',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Serve);
+        const envEnvironment = process.env.QUONFIG_ENVIRONMENT;
+        const environment = flags.environment ?? envEnvironment ?? 'development';
+        const resolved = resolveDatadirForServe({
+            flagDatadir: flags.datadir,
+            envDatadir: process.env.QUONFIG_DIR,
+            cwd: process.cwd(),
+        });
+        if (resolved.kind === 'error') {
+            return this.err(resolved.message);
+        }
+        const datadir = resolved.dir;
+        if (this.isVerbose) {
+            this.verboseLog('Serve', { datadir, environment, port: flags.port, host: flags.host });
+        }
+        const logger = {
+            log: (msg) => this.log(msg),
+            warn: (msg) => this.logToStderr(msg),
+        };
+        let handle;
+        try {
+            handle = await startServer({
+                datadir,
+                environment,
+                port: flags.port,
+                host: flags.host,
+                frontendSdkKey: flags['frontend-sdk-key'],
+                corsOrigins: flags['cors-origin'],
+                watch: flags.watch,
+                allowNonLoopback: flags['allow-non-loopback'],
+                verbose: this.isVerbose,
+                logger,
+            });
+        }
+        catch (error) {
+            return this.err(error.message);
+        }
+        const url = `http://${flags.host}:${handle.port}`;
+        this.log(`qfg serve listening on ${url}`);
+        this.log(`  datadir:     ${datadir}`);
+        this.log(`  environment: ${environment}`);
+        if (flags['frontend-sdk-key']) {
+            this.log(`  auth:        required (Authorization: Basic 1:<key>)`);
+        }
+        else {
+            this.log(`  auth:        none (datadir served openly)`);
+        }
+        this.log('');
+        this.log('Point your browser SDK at the URL above:');
+        this.log(`  init({ apiUrls: ["${url}"] })`);
+        this.log('Press Ctrl-C to stop.');
+        // Block until the process is killed. The server is already accepting
+        // connections; we just need to keep the event loop alive.
+        await new Promise((resolve) => {
+            const shutdown = async () => {
+                this.log('\nqfg serve shutting down...');
+                try {
+                    await handle.close();
+                }
+                finally {
+                    resolve();
+                }
+            };
+            process.once('SIGINT', shutdown);
+            process.once('SIGTERM', shutdown);
+        });
+        return { datadir, environment, url };
+    }
+}

package/dist/quonfig.js

@@ -19,7 +19,6 @@ export const initQuonfig = async (_ctx, flagsOrDatafile) => {
     quonfig = new Quonfig({
         sdkKey,
         collectEvaluationSummaries: false,
-        collectLoggerCounts: false,
         contextUploadMode: 'none',
         datafile,
         enableSSE: false,

package/dist/serve/datadir-discovery.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Datadir discovery for `qfg serve`.
+ *
+ * Resolution order (plan §4):
+ *   1. --datadir flag
+ *   2. QUONFIG_DIR env var
+ *   3. ./our-config if present
+ *   4. ./.quonfig if present
+ *   5. error
+ *
+ * Kept narrow on purpose: `qfg pull`/`qfg push` use a richer
+ * `resolveWorkspaceDir` helper that walks up looking for `quonfig.json` — but
+ * `qfg serve` is intentionally cwd-relative (the user said "serve THIS dir")
+ * and the walk would surface a confusing path on a misconfigured repo. The
+ * default-pair lookup mirrors `qfg pull --dir` defaults documented in the
+ * plan.
+ */
+export declare const DEFAULT_DATADIR_CANDIDATES: readonly ["our-config", ".quonfig"];
+export declare const NO_DATADIR_ERROR: string;
+export interface ResolveDatadirInput {
+    cwd: string;
+    envDatadir: string | undefined;
+    flagDatadir: string | undefined;
+}
+export type ResolveDatadirResult = {
+    kind: 'ok';
+    dir: string;
+    source: 'flag' | 'env' | 'cwd-default';
+} | {
+    kind: 'error';
+    message: string;
+};
+export declare const resolveDatadirForServe: (input: ResolveDatadirInput) => ResolveDatadirResult;