@quonfig/cli 0.0.1 → 0.0.2

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.1 darwin-arm64 node-v24.4.1
+@quonfig/cli/0.0.2 darwin-arm64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -31,6 +31,7 @@ USAGE
 * [`qfg generate-new-hex-key`](#qfg-generate-new-hex-key)
 * [`qfg get [NAME]`](#qfg-get-name)
 * [`qfg info [NAME]`](#qfg-info-name)
+* [`qfg init [DIRECTORY]`](#qfg-init-directory)
 * [`qfg interactive`](#qfg-interactive)
 * [`qfg list`](#qfg-list)
 * [`qfg login`](#qfg-login)
@@ -92,7 +93,7 @@ EXAMPLES
   $ qfg create my.new.string --type json --value="{\"key\": \"value\"}"
 ```
 
-_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/create.ts)_
 
 ## `qfg download`
 
@@ -125,7 +126,7 @@ EXAMPLES
   $ qfg download --environment=test --sdk-key=YOUR_SDK_KEY
 ```
 
-_See code: [src/commands/download.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/download.ts)_
+_See code: [src/commands/download.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/download.ts)_
 
 ## `qfg generate`
 
@@ -195,7 +196,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.1/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -218,7 +219,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -250,7 +251,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/get.ts)_
 
 ## `qfg info [NAME]`
 
@@ -280,7 +281,45 @@ EXAMPLES
   $ qfg info my.config.name
 ```
 
-_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/info.ts)_
+
+## `qfg init [DIRECTORY]`
+
+Initialize or update a Quonfig workspace
+
+```
+USAGE
+  $ qfg init [DIRECTORY] [--json] [--interactive] [--no-color] [--verbose] [--dry-run] [--samples]
+
+ARGUMENTS
+  DIRECTORY  [default: .] Target directory (default: current directory)
+
+FLAGS
+  --dry-run       Show what would be done without writing anything
+  --[no-]samples  Include sample configs (default: yes on first init, no on update)
+
+GLOBAL FLAGS
+  --[no-]interactive  Force interactive mode
+  --json              Format output as json.
+  --no-color          Do not colorize output
+  --verbose           Verbose output
+
+DESCRIPTION
+  Initialize or update a Quonfig workspace
+
+EXAMPLES
+  $ qfg init
+
+  $ qfg init ./my-workspace
+
+  $ qfg init --no-samples
+
+  $ qfg init --samples
+
+  $ qfg init --dry-run
+```
+
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -298,7 +337,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -335,7 +374,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/list.ts)_
 
 ## `qfg login`
 
@@ -363,7 +402,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -386,7 +425,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/logout.ts)_
 
 ## `qfg mcp`
 
@@ -419,7 +458,7 @@ EXAMPLES
   $ qfg mcp --url http://local-app.goatsofquonfig.com:3003/api/v1/mcp
 ```
 
-_See code: [src/commands/mcp.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/mcp.ts)_
+_See code: [src/commands/mcp.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/mcp.ts)_
 
 ## `qfg override [NAME]`
 
@@ -458,7 +497,7 @@ EXAMPLES
   $ qfg override my.double.config --value=3.14159
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/override.ts)_
 
 ## `qfg profile`
 
@@ -481,7 +520,7 @@ EXAMPLES
   $ qfg profile
 ```
 
-_See code: [src/commands/profile.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/profile.ts)_
+_See code: [src/commands/profile.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/profile.ts)_
 
 ## `qfg schema NAME`
 
@@ -519,7 +558,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.1/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/schema.ts)_
 
 ## `qfg serve DATA-FILE`
 
@@ -555,7 +594,7 @@ EXAMPLES
   $ qfg serve ./quonfig.test.588.config.json --port=3099
 ```
 
-_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/serve.ts)_
+_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/serve.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -599,7 +638,7 @@ EXAMPLES
   $ qfg set-default my.config.name --env-var=MY_ENV_VAR_NAME --environment=production
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/set-default.ts)_
 
 ## `qfg verify [PATH]`
 
@@ -632,7 +671,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -655,7 +694,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -678,7 +717,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.1/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.2/src/commands/workspace.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/commands/init.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../index.js';
+export default class Init extends BaseCommand {
+    static args: {
+        directory: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'dry-run': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        samples: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<object>;
+}

package/dist/commands/init.js

@@ -0,0 +1,83 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../index.js';
+import { executeInit, planInit } from '../init/init-workspace.js';
+export default class Init extends BaseCommand {
+    static args = {
+        directory: Args.string({
+            default: '.',
+            description: 'Target directory (default: current directory)',
+        }),
+    };
+    static description = 'Initialize or update a Quonfig workspace';
+    static examples = [
+        '<%= config.bin %> init',
+        '<%= config.bin %> init ./my-workspace',
+        '<%= config.bin %> init --no-samples',
+        '<%= config.bin %> init --samples',
+        '<%= config.bin %> init --dry-run',
+    ];
+    static flags = {
+        'dry-run': Flags.boolean({
+            default: false,
+            description: 'Show what would be done without writing anything',
+        }),
+        samples: Flags.boolean({
+            allowNo: true,
+            description: 'Include sample configs (default: yes on first init, no on update)',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Init);
+        const dir = args.directory;
+        const plan = planInit({
+            dir,
+            dryRun: flags['dry-run'],
+            samples: flags.samples,
+        });
+        const mode = plan.isFirstTime ? 'Initializing' : 'Updating';
+        const writeActions = plan.actions.filter((a) => a.kind !== 'skip-file' && a.kind !== 'skip-hook');
+        const skipActions = plan.actions.filter((a) => a.kind === 'skip-file' || a.kind === 'skip-hook');
+        if (flags['dry-run']) {
+            this.log(`${mode} workspace (dry run)\n`);
+            if (writeActions.length > 0) {
+                this.log('Would perform:');
+                for (const action of writeActions) {
+                    this.log(`  + ${action.description}`);
+                }
+            }
+            if (skipActions.length > 0) {
+                this.log('\nSkipped:');
+                for (const action of skipActions) {
+                    this.log(`  - ${action.description}`);
+                }
+            }
+            if (writeActions.length === 0) {
+                this.log('  Nothing to do.');
+            }
+            if (this.jsonEnabled()) {
+                return { actions: plan.actions, dryRun: true, isFirstTime: plan.isFirstTime, samplesIncluded: plan.samplesIncluded };
+            }
+            return plan;
+        }
+        // Execute for real
+        executeInit(plan, dir);
+        this.log(`${mode} workspace: ${dir === '.' ? process.cwd() : dir}\n`);
+        for (const action of writeActions) {
+            this.log(`  + ${action.description}`);
+        }
+        for (const action of skipActions) {
+            this.log(`  - ${action.description}`);
+        }
+        if (!plan.samplesIncluded && plan.isFirstTime) {
+            this.log('\nSample data skipped. Run `qfg init --samples` to add examples.');
+        }
+        else if (!plan.isFirstTime && !plan.samplesIncluded) {
+            this.log('\nDocs updated. Run `qfg init --samples` to add example configs.');
+        }
+        this.log('\nRun `qfg verify` to validate the workspace.');
+        if (this.jsonEnabled()) {
+            return { actions: plan.actions, dryRun: false, isFirstTime: plan.isFirstTime, samplesIncluded: plan.samplesIncluded };
+        }
+        return plan;
+    }
+}

package/dist/init/init-workspace.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Core logic for `qfg init`.
+ *
+ * Uses a plan/execute pattern so --dry-run can show what *would* happen
+ * without writing anything.
+ */
+export interface InitOptions {
+    dir: string;
+    /** true = force include samples, false = force skip, undefined = auto-detect */
+    samples: boolean | undefined;
+    dryRun: boolean;
+}
+export type ActionKind = 'git-init' | 'create-dir' | 'write-file' | 'skip-file' | 'create-hook' | 'update-hook' | 'skip-hook';
+export interface InitAction {
+    kind: ActionKind;
+    path: string;
+    description: string;
+}
+export interface InitPlan {
+    actions: InitAction[];
+    isFirstTime: boolean;
+    samplesIncluded: boolean;
+}
+export declare function planInit(options: InitOptions): InitPlan;
+export declare function executeInit(plan: InitPlan, dir: string): void;

package/dist/init/init-workspace.js

@@ -0,0 +1,162 @@
+/**
+ * Core logic for `qfg init`.
+ *
+ * Uses a plan/execute pattern so --dry-run can show what *would* happen
+ * without writing anything.
+ */
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { SAMPLE_FILES } from './samples.js';
+import { storedConfigJsonSchema } from './schema.js';
+import { PRE_COMMIT_MARKER, agentsMdTemplate, claudeMdTemplate, preCommitHookContent, readmeTemplate, } from './templates.js';
+// ── Directories that define a workspace ────────────────────────────────
+const WORKSPACE_DIRS = [
+    'configs',
+    'feature-flags',
+    'segments',
+    'log-levels',
+    'schemas',
+];
+// ── Plan ───────────────────────────────────────────────────────────────
+export function planInit(options) {
+    const { dir } = options;
+    const actions = [];
+    // Detect first-time vs update: do any workspace dirs already exist?
+    const isFirstTime = !WORKSPACE_DIRS.some((d) => fs.existsSync(path.join(dir, d)));
+    // Resolve samples flag: first-time → default on, update → default off
+    const includeSamples = options.samples ?? isFirstTime;
+    // 0. Ensure it's a git repo
+    const gitDir = path.join(dir, '.git');
+    const needsGitInit = !fs.existsSync(gitDir);
+    if (needsGitInit) {
+        actions.push({ kind: 'git-init', path: '.git', description: 'Initialize git repository' });
+    }
+    // 1. Ensure directories exist
+    for (const d of WORKSPACE_DIRS) {
+        const dirPath = path.join(dir, d);
+        if (fs.existsSync(dirPath)) {
+            // directory already exists, nothing to do
+        }
+        else {
+            actions.push({ kind: 'create-dir', path: d, description: `Create ${d}/` });
+        }
+    }
+    // 2. Managed files — always overwrite
+    const managedFiles = [
+        { file: 'quonfig.schema.json', content: JSON.stringify(storedConfigJsonSchema(), null, 2) + '\n' },
+        { file: 'README.md', content: readmeTemplate() },
+        { file: 'CLAUDE.md', content: claudeMdTemplate() },
+        { file: 'AGENTS.md', content: agentsMdTemplate() },
+    ];
+    for (const { file, content: _content } of managedFiles) {
+        const filePath = path.join(dir, file);
+        const verb = fs.existsSync(filePath) ? 'Update' : 'Create';
+        actions.push({ kind: 'write-file', path: file, description: `${verb} ${file}` });
+    }
+    // 3. environments.json — create if missing
+    const envsPath = path.join(dir, 'environments.json');
+    if (fs.existsSync(envsPath)) {
+        // leave it alone
+    }
+    else {
+        actions.push({ kind: 'write-file', path: 'environments.json', description: 'Create environments.json' });
+    }
+    // 4. Sample data
+    if (includeSamples) {
+        for (const sample of SAMPLE_FILES) {
+            const samplePath = path.join(dir, sample.path);
+            if (fs.existsSync(samplePath)) {
+                actions.push({ kind: 'skip-file', path: sample.path, description: `Skip ${sample.path} (already exists)` });
+            }
+            else {
+                actions.push({ kind: 'write-file', path: sample.path, description: `Create ${sample.path}` });
+            }
+        }
+    }
+    // 5. Git pre-commit hook (always runs — git repo guaranteed by step 0)
+    if (needsGitInit) {
+        // Fresh git init — hook will be created
+        actions.push({ kind: 'create-hook', path: '.git/hooks/pre-commit', description: 'Install pre-commit hook (qfg verify)' });
+    }
+    else {
+        const hooksDir = path.join(gitDir, 'hooks');
+        const hookPath = path.join(hooksDir, 'pre-commit');
+        if (fs.existsSync(hookPath)) {
+            const existing = fs.readFileSync(hookPath, 'utf-8');
+            if (existing.includes(PRE_COMMIT_MARKER)) {
+                actions.push({ kind: 'skip-hook', path: '.git/hooks/pre-commit', description: 'Pre-commit hook already installed' });
+            }
+            else if (existing.includes('qfg verify')) {
+                actions.push({ kind: 'skip-hook', path: '.git/hooks/pre-commit', description: 'Pre-commit hook already runs qfg verify' });
+            }
+            else {
+                actions.push({ kind: 'update-hook', path: '.git/hooks/pre-commit', description: 'Append qfg verify to existing pre-commit hook' });
+            }
+        }
+        else {
+            actions.push({ kind: 'create-hook', path: '.git/hooks/pre-commit', description: 'Install pre-commit hook (qfg verify)' });
+        }
+    }
+    return { actions, isFirstTime, samplesIncluded: includeSamples };
+}
+// ── Execute ────────────────────────────────────────────────────────────
+export function executeInit(plan, dir) {
+    // Build a lookup for managed file content
+    const managedContent = {
+        'quonfig.schema.json': JSON.stringify(storedConfigJsonSchema(), null, 2) + '\n',
+        'README.md': readmeTemplate(),
+        'CLAUDE.md': claudeMdTemplate(),
+        'AGENTS.md': agentsMdTemplate(),
+        'environments.json': JSON.stringify({ environments: [] }, null, 2) + '\n',
+    };
+    // Build a lookup for sample content
+    const sampleContent = {};
+    for (const sample of SAMPLE_FILES) {
+        sampleContent[sample.path] = JSON.stringify(sample.content, null, 2) + '\n';
+    }
+    for (const action of plan.actions) {
+        const fullPath = path.join(dir, action.path);
+        switch (action.kind) {
+            case 'git-init': {
+                execSync('git init', { cwd: dir, stdio: 'pipe' });
+                break;
+            }
+            case 'create-dir': {
+                fs.mkdirSync(fullPath, { recursive: true });
+                break;
+            }
+            case 'write-file': {
+                // Ensure parent directory exists
+                const parentDir = path.dirname(fullPath);
+                if (!fs.existsSync(parentDir)) {
+                    fs.mkdirSync(parentDir, { recursive: true });
+                }
+                const content = managedContent[action.path] ?? sampleContent[action.path];
+                if (content) {
+                    fs.writeFileSync(fullPath, content, 'utf-8');
+                }
+                break;
+            }
+            case 'create-hook': {
+                const hooksDir = path.dirname(fullPath);
+                if (!fs.existsSync(hooksDir)) {
+                    fs.mkdirSync(hooksDir, { recursive: true });
+                }
+                fs.writeFileSync(fullPath, preCommitHookContent(), 'utf-8');
+                fs.chmodSync(fullPath, 0o755);
+                break;
+            }
+            case 'update-hook': {
+                const existing = fs.readFileSync(fullPath, 'utf-8');
+                const appended = existing.trimEnd() + '\n\n' + preCommitHookContent().split('\n').slice(1).join('\n');
+                fs.writeFileSync(fullPath, appended, 'utf-8');
+                break;
+            }
+            case 'skip-file':
+            case 'skip-hook':
+                // Nothing to do
+                break;
+        }
+    }
+}

package/dist/init/samples.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sample config data for `qfg init --samples`.
+ *
+ * Each entry maps a relative path (e.g. "configs/example.greeting.json")
+ * to the JSON object that should be written there.
+ */
+export interface SampleFile {
+    path: string;
+    content: object;
+}
+export declare const SAMPLE_FILES: SampleFile[];

package/dist/init/samples.js

@@ -0,0 +1,118 @@
+/**
+ * Sample config data for `qfg init --samples`.
+ *
+ * Each entry maps a relative path (e.g. "configs/example.greeting.json")
+ * to the JSON object that should be written there.
+ */
+export const SAMPLE_FILES = [
+    {
+        path: 'configs/example.greeting.json',
+        content: {
+            key: 'example.greeting',
+            type: 'config',
+            valueType: 'string',
+            sendToClientSdk: true,
+            description: 'A greeting message shown to users.',
+            default: {
+                rules: [
+                    {
+                        criteria: [{ operator: 'ALWAYS_TRUE' }],
+                        value: { type: 'string', value: 'Hello, world!' },
+                    },
+                ],
+            },
+            environments: [
+                {
+                    id: 'production',
+                    rules: [
+                        {
+                            criteria: [{ operator: 'ALWAYS_TRUE' }],
+                            value: { type: 'string', value: 'Welcome to our app!' },
+                        },
+                    ],
+                },
+            ],
+            variants: [],
+        },
+    },
+    {
+        path: 'feature-flags/example.dark-mode.json',
+        content: {
+            key: 'example.dark-mode',
+            type: 'feature_flag',
+            valueType: 'bool',
+            sendToClientSdk: true,
+            description: 'Enable dark mode UI.',
+            default: {
+                rules: [
+                    {
+                        criteria: [{ operator: 'ALWAYS_TRUE' }],
+                        value: { type: 'bool', value: false },
+                    },
+                ],
+            },
+            environments: [
+                {
+                    id: 'staging',
+                    rules: [
+                        {
+                            criteria: [{ operator: 'ALWAYS_TRUE' }],
+                            value: { type: 'bool', value: true },
+                        },
+                    ],
+                },
+            ],
+            variants: [],
+        },
+    },
+    {
+        path: 'segments/example.beta-users.json',
+        content: {
+            key: 'example.beta-users',
+            type: 'segment',
+            valueType: 'bool',
+            sendToClientSdk: false,
+            description: 'Users who opted in to the beta program.',
+            default: {
+                rules: [
+                    {
+                        criteria: [
+                            {
+                                operator: 'PROP_IS_ONE_OF',
+                                propertyName: 'user.beta',
+                                valueToMatch: { type: 'string_list', value: ['true'] },
+                            },
+                        ],
+                        value: { type: 'bool', value: true },
+                    },
+                    {
+                        criteria: [{ operator: 'ALWAYS_TRUE' }],
+                        value: { type: 'bool', value: false },
+                    },
+                ],
+            },
+            environments: [],
+            variants: [],
+        },
+    },
+    {
+        path: 'log-levels/example.app.json',
+        content: {
+            key: 'example.app',
+            type: 'log_level',
+            valueType: 'log_level',
+            sendToClientSdk: false,
+            description: 'Application log level.',
+            default: {
+                rules: [
+                    {
+                        criteria: [{ operator: 'ALWAYS_TRUE' }],
+                        value: { type: 'log_level', value: 'INFO' },
+                    },
+                ],
+            },
+            environments: [],
+            variants: [],
+        },
+    },
+];

package/dist/init/schema.d.ts

@@ -0,0 +1,9 @@
+/**
+ * JSON Schema for Quonfig StoredConfig files.
+ *
+ * This is the machine-readable schema for files in configs/, feature-flags/,
+ * segments/, and log-levels/. Written to `quonfig.schema.json` by `qfg init`.
+ *
+ * Derived from the Zod schemas in verify/validate.ts — keep in sync.
+ */
+export declare function storedConfigJsonSchema(): object;