@quonfig/cli 0.2.2 → 0.2.3

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.2.2 linux-x64 node-v24.4.1
+@quonfig/cli/0.2.3 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -201,7 +201,7 @@ EXAMPLES
   $ qfg activity restore my.flag --yes
 ```
 
-_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/activity.ts)_
+_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/activity.ts)_
 
 ## `qfg activity deleted`
 
@@ -230,7 +230,7 @@ EXAMPLES
   $ qfg activity deleted --json
 ```
 
-_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/activity/deleted.ts)_
+_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/activity/deleted.ts)_
 
 ## `qfg activity feed`
 
@@ -265,7 +265,7 @@ EXAMPLES
   $ qfg activity feed --json
 ```
 
-_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/activity/feed.ts)_
+_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/activity/feed.ts)_
 
 ## `qfg activity history [NAME]`
 
@@ -299,7 +299,7 @@ EXAMPLES
   $ qfg activity history request.timeout --json
 ```
 
-_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/activity/history.ts)_
+_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/activity/history.ts)_
 
 ## `qfg activity restore [NAME]`
 
@@ -338,7 +338,7 @@ EXAMPLES
   $ qfg activity restore request.timeout --type config --yes
 ```
 
-_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/activity/restore.ts)_
+_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/activity/restore.ts)_
 
 ## `qfg audit-log [NAME]`
 
@@ -366,7 +366,7 @@ EXAMPLES
   $ qfg audit-log my.flag
 ```
 
-_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/audit-log.ts)_
+_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/audit-log.ts)_
 
 ## `qfg cleanup`
 
@@ -407,7 +407,7 @@ EXAMPLES
   $ qfg cleanup status my.flag.key
 ```
 
-_See code: [src/commands/cleanup.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/cleanup.ts)_
+_See code: [src/commands/cleanup.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/cleanup.ts)_
 
 ## `qfg cleanup list`
 
@@ -453,7 +453,7 @@ EXAMPLES
   $ qfg cleanup list --json
 ```
 
-_See code: [src/commands/cleanup/list.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/cleanup/list.ts)_
+_See code: [src/commands/cleanup/list.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/cleanup/list.ts)_
 
 ## `qfg cleanup remove [NAME]`
 
@@ -498,7 +498,7 @@ EXAMPLES
   $ qfg cleanup remove my.flag.key --json
 ```
 
-_See code: [src/commands/cleanup/remove.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/cleanup/remove.ts)_
+_See code: [src/commands/cleanup/remove.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/cleanup/remove.ts)_
 
 ## `qfg cleanup status [NAME]`
 
@@ -538,7 +538,7 @@ EXAMPLES
   $ qfg cleanup status my.flag.key --json
 ```
 
-_See code: [src/commands/cleanup/status.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/cleanup/status.ts)_
+_See code: [src/commands/cleanup/status.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/cleanup/status.ts)_
 
 ## `qfg cleanup verify [NAME]`
 
@@ -584,7 +584,7 @@ EXAMPLES
   $ qfg cleanup verify my.flag.key && qfg delete my.flag.key
 ```
 
-_See code: [src/commands/cleanup/verify.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/cleanup/verify.ts)_
+_See code: [src/commands/cleanup/verify.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/cleanup/verify.ts)_
 
 ## `qfg config-schema`
 
@@ -613,7 +613,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.2.2/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -700,7 +700,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.2.2/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/create.ts)_
 
 ## `qfg delete NAME`
 
@@ -746,7 +746,7 @@ EXAMPLES
   $ qfg delete my.config --yes
 ```
 
-_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/delete.ts)_
+_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/delete.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -950,7 +950,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.2.2/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -973,7 +973,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -1005,7 +1005,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/get.ts)_
 
 ## `qfg history NAME`
 
@@ -1031,7 +1031,7 @@ EXAMPLES
   $ qfg history my.flag
 ```
 
-_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/history.ts)_
+_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/history.ts)_
 
 ## `qfg info [NAME]`
 
@@ -1079,7 +1079,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.2.2/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -1119,7 +1119,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -1149,7 +1149,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -1189,7 +1189,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/list.ts)_
 
 ## `qfg log`
 
@@ -1214,7 +1214,7 @@ EXAMPLES
   $ qfg log --limit 5
 ```
 
-_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/log.ts)_
+_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/log.ts)_
 
 ## `qfg log-level NAME`
 
@@ -1279,7 +1279,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.2.2/src/commands/log-level.ts)_
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/log-level.ts)_
 
 ## `qfg login`
 
@@ -1304,7 +1304,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -1327,7 +1327,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/logout.ts)_
 
 ## `qfg migrate`
 
@@ -1392,7 +1392,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.2.2/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -1430,7 +1430,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -1462,7 +1462,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -1493,7 +1493,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME] [VALUE]`
 
@@ -1548,7 +1548,7 @@ EXAMPLES
   $ qfg override my.flag true --env=staging
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -1595,7 +1595,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -1644,7 +1644,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/push.ts)_
 
 ## `qfg run [COMMAND]`
 
@@ -1695,7 +1695,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.2.2/src/commands/run.ts)_
+_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/run.ts)_
 
 ## `qfg schema NAME`
 
@@ -1733,7 +1733,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.2.2/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1760,7 +1760,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1792,7 +1792,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.2.2/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1821,7 +1821,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1848,7 +1848,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.2.2/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg serve`
 
@@ -1906,7 +1906,7 @@ EXAMPLES
   $ qfg serve --port 6581 --frontend-sdk-key PUBLIC_KEY
 ```
 
-_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/serve.ts)_
+_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/serve.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1982,7 +1982,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -2073,7 +2073,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.2.2/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -2105,7 +2105,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -2212,7 +2212,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -2235,7 +2235,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -2258,7 +2258,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -2291,7 +2291,7 @@ EXAMPLES
   $ qfg workspace bootstrap --dir ./our-config --skip-validate
 ```
 
-_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace create SLUG`
 
@@ -2325,7 +2325,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.2.2/src/commands/workspace/create.ts)_
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -2353,7 +2353,7 @@ EXAMPLES
   $ qfg workspace switch acme/production
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.2.2/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.2.3/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/commands/override.js

@@ -1,5 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import { APICommand } from '../index.js';
+import { DURATION_FORMAT_HINT, isValidIsoDuration } from '../util/coerce.js';
 import { checkmark } from '../util/color.js';
 import { loadTokens } from '../util/token-storage.js';
 const OVERRIDE_PROP = 'quonfig-user.email';
@@ -40,6 +41,20 @@ function inferValue(raw) {
     }
     return { type: 'string', value: raw };
 }
+/**
+ * Type the override from the flag's declared valueType where inference cannot
+ * (qfg-2agi.3): a duration flag gets {type: 'duration'} and the value must
+ * match the shared grammar. No conversions. Every other valueType keeps
+ * inferValue. Returns an error string for invalid input.
+ */
+function typeOverrideValue(raw, valueType) {
+    if (valueType?.toLowerCase() === 'duration') {
+        return isValidIsoDuration(raw)
+            ? { type: 'duration', value: raw }
+            : `Invalid value for duration: ${raw}. ${DURATION_FORMAT_HINT}`;
+    }
+    return inferValue(raw);
+}
 /**
  * Find the existing override rule for a user in a specific env. Returns the
  * value the user is currently overridden to, or undefined.
@@ -254,11 +269,14 @@ Examples
         return removed ? this.ok(`${checkmark} Removed override on ${opts.key} in env=${opts.env}.`) : undefined;
     }
     async runSet(opts) {
-        const value = inferValue(opts.rawValue);
         const flag = await this.fetchFlag(opts.key);
         if (!flag) {
             return this.err(`Flag ${opts.key} not found.`);
         }
+        const value = typeOverrideValue(opts.rawValue, flag.valueType);
+        if (typeof value === 'string') {
+            return this.err(value);
+        }
         const existing = findExistingOverride(flag, opts.env, opts.userEmail);
         if (existing && valuesEqual(existing, value)) {
             return this.ok(`${opts.key} is already set to ${JSON.stringify(value.value)} (${value.type}) for ${opts.userEmail} in env=${opts.env}.`);

package/dist/commands/set-default.js

@@ -5,6 +5,7 @@ import getConfirmation, { confirmFlag } from '../ui/get-confirmation.js';
 import getEnvironment from '../ui/get-environment.js';
 import getString from '../ui/get-string.js';
 import autocomplete from '../util/autocomplete.js';
+import { DURATION_FORMAT_HINT, isValidIsoDuration, parseDoubleValue, parseIntValue } from '../util/coerce.js';
 import { checkmark } from '../util/color.js';
 import { mapConfigValueToDto } from '../util/config-value-dto.js';
 import { makeConfidentialValue } from '../util/encryption.js';
@@ -250,14 +251,18 @@ To see all current values and rules for a flag:
                         break;
                     }
                     case 'int': {
-                        variantValue = Number.parseInt(value, 10);
-                        if (Number.isNaN(variantValue)) {
+                        // Shared strict grammar with qfg create (qfg-2agi.23).
+                        variantValue = parseIntValue(value);
+                        if (variantValue === undefined) {
                             return this.err(`Invalid default value for int: ${value}`);
                         }
                         break;
                     }
                     case 'double': {
-                        variantValue = Number.parseFloat(value);
+                        variantValue = parseDoubleValue(value);
+                        if (variantValue === undefined) {
+                            return this.err(`Invalid default value for double: ${value}`);
+                        }
                         break;
                     }
                     case 'json': {
@@ -273,6 +278,13 @@ To see all current values and rules for a flag:
                         variantValue = value;
                         break;
                     }
+                    case 'duration': {
+                        // Stored verbatim as the ISO 8601 string; no conversions (qfg-2agi.3).
+                        if (!isValidIsoDuration(value)) {
+                            return this.err(`Invalid value for duration: ${value}. ${DURATION_FORMAT_HINT}`);
+                        }
+                        break;
+                    }
                     // No default
                 }
                 configValue = {

package/dist/init/schema.js

@@ -70,7 +70,10 @@ const durationValue = {
     type: 'object',
     properties: {
         type: { const: 'duration' },
-        value: { type: 'string', description: 'Go-style duration (e.g. "30s", "5m", "1h30m")' },
+        value: {
+            type: 'string',
+            description: 'ISO 8601 duration (e.g. "PT30S", "PT5M", "PT1H30M", "P1DT6H"): optional days, then T and hours/minutes/seconds; only seconds may have a fraction',
+        },
     },
     required: ['type', 'value'],
     additionalProperties: false,

package/dist/util/coerce.d.ts

@@ -1,7 +1,7 @@
 import type { ConfigValue } from '@quonfig/node';
 import { ConfigValueType } from '@quonfig/node';
+export { DURATION_FORMAT_HINT, isValidIsoDuration, parseDoubleValue, parseIntValue } from '../verify/value-grammar.js';
 type ConfigValueWithConfigValueType = [ConfigValue, ConfigValueType];
 export declare const TYPE_MAPPING: Record<string, ConfigValueType>;
 export declare const coerceIntoType: (type: string, value: string) => ConfigValueWithConfigValueType | undefined;
 export declare const coerceBool: (value: string) => boolean;
-export {};

package/dist/util/coerce.js

@@ -1,16 +1,10 @@
 import { ConfigValueType, durationToMilliseconds } from '@quonfig/node';
+import { DURATION_FORMAT_HINT, isValidIsoDuration, parseDoubleValue, parseIntValue } from '../verify/value-grammar.js';
 const TRUE_VALUES = new Set(['true', '1', 't']);
 const BOOLEAN_VALUES = new Set([...TRUE_VALUES, 'false', '0', 'f']);
-// Strict ISO 8601 duration: at least one of D/H/M/S must be present (i.e. bare "P"
-// or "PT" alone are rejected). Mirrors the lenient pattern in @quonfig/node but
-// adds anchors and a non-empty check.
-const ISO_DURATION_PATTERN = /^P(?:\d+(?:\.\d+)?D)?(?:T(?:\d+(?:\.\d+)?H)?(?:\d+(?:\.\d+)?M)?(?:\d+(?:\.\d+)?S)?)?$/;
-const isValidIsoDuration = (value) => {
-    if (!ISO_DURATION_PATTERN.test(value))
-        return false;
-    // Reject "P", "PT" — pattern allows them but they have no components.
-    return value !== 'P' && value !== 'PT';
-};
+// The duration and int/double grammars live in verify/value-grammar.ts so the
+// standalone pre-receive hook build can use the same definition.
+export { DURATION_FORMAT_HINT, isValidIsoDuration, parseDoubleValue, parseIntValue } from '../verify/value-grammar.js';
 export const TYPE_MAPPING = {
     bool: ConfigValueType.Bool,
     boolean: ConfigValueType.Bool,
@@ -27,18 +21,15 @@ export const coerceIntoType = (type, value) => {
             return [{ string: value }, TYPE_MAPPING[type]];
         }
         case 'int': {
-            try {
-                const bigInt = BigInt(value);
-                const int = Number(bigInt);
-                return [{ int }, TYPE_MAPPING[type]];
-            }
-            catch {
+            const int = parseIntValue(value);
+            if (int === undefined) {
                 throw new TypeError(`Invalid default value for int: ${value}`);
             }
+            return [{ int }, TYPE_MAPPING[type]];
         }
         case 'double': {
-            const double = Number.parseFloat(value);
-            if (Number.isNaN(double)) {
+            const double = parseDoubleValue(value);
+            if (double === undefined) {
                 throw new TypeError(`Invalid default value for double: ${value}`);
             }
             return [{ double }, TYPE_MAPPING[type]];
@@ -65,7 +56,7 @@ export const coerceIntoType = (type, value) => {
             // durationToMilliseconds() returns 0 on no-match instead of throwing, so
             // we anchor-check the format ourselves before delegating.
             if (!isValidIsoDuration(value)) {
-                throw new TypeError(`Invalid default value for duration: ${value}. Expected ISO 8601 duration like PT30S, PT5M, PT1H30M.`);
+                throw new TypeError(`Invalid default value for duration: ${value}. ${DURATION_FORMAT_HINT}`);
             }
             const millis = durationToMilliseconds(value);
             return [{ duration: { definition: value, millis } }, ConfigValueType.Duration];

package/dist/verify/validate.js

@@ -28,6 +28,7 @@
 import { z } from 'zod';
 import { findMapKeyOrderWarnings, navigate, scanOrderedJson } from './map-key-order.js';
 import { compileSchema, validateAgainstSchema } from './schema-validator.js';
+import { DURATION_FORMAT_HINT, isValidIsoDuration, parseDoubleValue, parseIntValue } from './value-grammar.js';
 // Inlined to keep this directory self-contained for the standalone bun-compile
 // build that runs as the qfg-verify pre-receive hook in app-gitea — that build
 // only copies cli/src/verify/, so any out-of-tree imports break it. Source of
@@ -69,8 +70,26 @@ const OperatorSchema = z.enum(OPERATORS);
 const LogLevelSchema = z.enum(LOG_LEVELS);
 const BoolValueSchema = z.object({ type: z.literal('bool'), value: z.boolean() });
 const StringValueSchema = z.object({ type: z.literal('string'), value: z.string() });
-const IntValueSchema = z.object({ type: z.literal('int'), value: z.union([z.number(), z.string()]) });
-const DoubleValueSchema = z.object({ type: z.literal('double'), value: z.union([z.number(), z.string()]) });
+// Value grammars (qfg-e87r.30): the same definitions qfg create / set-default /
+// override use (value-grammar.ts). Issues carry params.valueGrammar so the
+// reporter can add the config key (formatSchemaIssue).
+const grammarIssue = (ctx, message) => ctx.addIssue({ code: 'custom', message, params: { valueGrammar: true } });
+const IntValueSchema = z.object({
+    type: z.literal('int'),
+    value: z.union([z.number(), z.string()]).superRefine((value, ctx) => {
+        const ok = typeof value === 'number' ? Number.isSafeInteger(value) : parseIntValue(value) !== undefined;
+        if (!ok)
+            grammarIssue(ctx, `invalid int ${JSON.stringify(value)}. Expected a whole number (optional -, ASCII digits) within +/-(2^53-1).`);
+    }),
+});
+const DoubleValueSchema = z.object({
+    type: z.literal('double'),
+    value: z.union([z.number(), z.string()]).superRefine((value, ctx) => {
+        const ok = typeof value === 'number' ? Number.isFinite(value) : parseDoubleValue(value) !== undefined;
+        if (!ok)
+            grammarIssue(ctx, `invalid double ${JSON.stringify(value)}. Expected a finite decimal number with an optional exponent, such as 2.5, .5 or -1.5e3.`);
+    }),
+});
 const JsonValueSchema = z.object({
     type: z.literal('json'),
     value: z.any().refine((v) => typeof v !== 'string', {
@@ -78,7 +97,13 @@ const JsonValueSchema = z.object({
     }),
 });
 const StringListValueSchema = z.object({ type: z.literal('string_list'), value: z.array(z.string()) });
-const DurationValueSchema = z.object({ type: z.literal('duration'), value: z.string() });
+const DurationValueSchema = z.object({
+    type: z.literal('duration'),
+    value: z.string().superRefine((value, ctx) => {
+        if (!isValidIsoDuration(value))
+            grammarIssue(ctx, `invalid duration ${JSON.stringify(value)}. ${DURATION_FORMAT_HINT}`);
+    }),
+});
 const LogLevelValueSchema = z.object({ type: z.literal('log_level'), value: LogLevelSchema });
 const SchemaValueSchema = z.object({
     type: z.literal('schema'),
@@ -157,6 +182,17 @@ const StoredConfigSchema = z
 })
     .passthrough(); // Allow extra fields (tags, schemaUsageMode, etc.)
 const SchemaDocumentSchema = z.object({}).passthrough();
+/**
+ * `Schema: <path> - <message>`. A value-grammar issue (duration / int /
+ * double) also names the config key, so the hook's error says which config
+ * holds the bad value, not just which file (qfg-e87r.30).
+ */
+function formatSchemaIssue(issue, parsed) {
+    const base = `Schema: ${issue.path.join('.')} - ${issue.message}`;
+    const isGrammar = issue.code === 'custom' && issue.params?.valueGrammar;
+    const key = typeof parsed === 'object' && parsed !== null ? parsed.key : undefined;
+    return isGrammar && typeof key === 'string' ? `${base} (config "${key}")` : base;
+}
 /** Maps config directory names to their expected config type. */
 const DIR_TO_TYPE = {
     configs: 'config',
@@ -469,7 +505,7 @@ export function validateWorkspace(workspaceDir, options = {}) {
                 for (const issue of result.error.issues) {
                     issues.push({
                         file: relPath,
-                        message: `Schema: ${issue.path.join('.')} - ${issue.message}`,
+                        message: formatSchemaIssue(issue, parsed),
                         severity: 'error',
                     });
                 }
@@ -777,7 +813,7 @@ export function validateFileMap(files, options = {}) {
             for (const issue of result.error.issues) {
                 issues.push({
                     file: relPath,
-                    message: `Schema: ${issue.path.join('.')} - ${issue.message}`,
+                    message: formatSchemaIssue(issue, parsed),
                     severity: 'error',
                 });
             }

package/dist/verify/value-grammar.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The ONE value grammar for durations (qfg-2agi.3) and int/double input
+ * (qfg-2agi.23), shared by qfg create, set-default, override and verify
+ * (qfg-e87r.30). util/coerce.ts re-exports it.
+ *
+ * SELF-CONTAINED ON PURPOSE: no imports. It lives under src/verify/ because the
+ * standalone qfg-verify pre-receive hook (app-gitea Dockerfile) is built from
+ * this directory alone.
+ */
+export declare const DURATION_FORMAT_HINT = "Expected an ISO 8601 duration such as PT30S, PT5M, PT1H30M or P1DT6H (days, hours, minutes, seconds; a fraction only on seconds; at most P36500D).";
+export declare const isValidIsoDuration: (value: string) => boolean;
+export declare const parseIntValue: (value: string) => number | undefined;
+export declare const parseDoubleValue: (value: string) => number | undefined;

package/dist/verify/value-grammar.js

@@ -0,0 +1,63 @@
+/**
+ * The ONE value grammar for durations (qfg-2agi.3) and int/double input
+ * (qfg-2agi.23), shared by qfg create, set-default, override and verify
+ * (qfg-e87r.30). util/coerce.ts re-exports it.
+ *
+ * SELF-CONTAINED ON PURPOSE: no imports. It lives under src/verify/ because the
+ * standalone qfg-verify pre-receive hook (app-gitea Dockerfile) is built from
+ * this directory alone.
+ */
+// The ONE duration grammar (qfg-2agi.29), shared by qfg create, set-default,
+// override and verify. Fixture of record: integration-test-data
+// tests/duration/grammar.yaml (test/util/duration-grammar.test.ts holds this
+// function to it).
+//
+//   ^P(?:\d+D)?(?:T(?:\d+H)?(?:\d+M)?(?:\d+(?:\.\d+)?S)?)?$
+//
+// plus: at least one component, no dangling T, a fraction only on S with at
+// most 9 digits, total magnitude <= P36500D. [0-9] (not \d) and the whole
+// string anchored so ports to other regex engines stay strict.
+// JS \d is already ASCII-only; [0-9] is kept so a copy into Python/.NET is safe.
+/* eslint-disable unicorn/better-regex */
+const ISO_DURATION_PATTERN = /^P(?:(?<d>[0-9]+)D)?(?:T(?:(?<h>[0-9]+)H)?(?:(?<m>[0-9]+)M)?(?:(?<s>[0-9]+)(?:\.(?<f>[0-9]{1,9}))?S)?)?$/;
+/* eslint-enable unicorn/better-regex */
+export const DURATION_FORMAT_HINT = 'Expected an ISO 8601 duration such as PT30S, PT5M, PT1H30M or P1DT6H (days, hours, minutes, seconds; a fraction only on seconds; at most P36500D).';
+const NANOS_PER_SECOND = 1000000000n;
+const MAX_DURATION_NANOS = 36500n * 86400n * NANOS_PER_SECOND;
+export const isValidIsoDuration = (value) => {
+    const match = ISO_DURATION_PATTERN.exec(value);
+    if (!match?.groups)
+        return false;
+    const { d, f, h, m, s } = match.groups;
+    // At least one component; a T must be followed by at least one of H/M/S.
+    if (d === undefined && h === undefined && m === undefined && s === undefined)
+        return false;
+    if (value.includes('T') && h === undefined && m === undefined && s === undefined)
+        return false;
+    // Exact integer arithmetic: huge digit strings cannot overflow past the cap.
+    const nanos = (BigInt(d ?? 0) * 86400n + BigInt(h ?? 0) * 3600n + BigInt(m ?? 0) * 60n + BigInt(s ?? 0)) * NANOS_PER_SECOND +
+        BigInt((f ?? '').padEnd(9, '0'));
+    return nanos <= MAX_DURATION_NANOS;
+};
+// The ONE int/double input grammar (qfg-2agi.23), shared by qfg create and
+// set-default. Strict whole-string matches with ASCII digits only: no
+// surrounding whitespace, no hex, no trailing junk ('12abc'), no NaN/Infinity.
+// An int must stay within +/-(2^53-1) because it is written as a JSON number
+// and anything larger silently loses precision. Returns undefined when the
+// input is not valid.
+/* eslint-disable unicorn/better-regex */
+const INT_PATTERN = /^-?[0-9]+$/;
+const DOUBLE_PATTERN = /^-?(?:[0-9]+(?:\.[0-9]*)?|\.[0-9]+)(?:[eE][-+]?[0-9]+)?$/;
+/* eslint-enable unicorn/better-regex */
+export const parseIntValue = (value) => {
+    if (!INT_PATTERN.test(value))
+        return undefined;
+    const int = Number(value);
+    return Number.isSafeInteger(int) ? int : undefined;
+};
+export const parseDoubleValue = (value) => {
+    if (!DOUBLE_PATTERN.test(value))
+        return undefined;
+    const double = Number(value);
+    return Number.isFinite(double) ? double : undefined;
+};

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "0.2.2";
+declare const _default: "0.2.3";
 export default _default;

package/dist/version.js

@@ -1,2 +1,2 @@
 // AUTO-GENERATED from package.json by scripts/generate-version.mjs — do not edit.
-export default '0.2.2';
+export default '0.2.3';

package/oclif.manifest.json

@@ -4150,5 +4150,5 @@
       ]
     }
   },
-  "version": "0.2.2"
+  "version": "0.2.3"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "packageManager": "yarn@4.11.0+sha512.4e54aeace9141df2f0177c266b05ec50dc044638157dae128c471ba65994ac802122d7ab35bcd9e81641228b7dcf24867d28e750e0bcae8a05277d600008ad54",
   "name": "@quonfig/cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "bugs": {
     "url": "https://github.com/quonfig/cli/issues"
   },