@quonfig/cli 0.0.1 → 0.0.4

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.4 linux-x64 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)
@@ -38,12 +39,15 @@ USAGE
 * [`qfg mcp`](#qfg-mcp)
 * [`qfg override [NAME]`](#qfg-override-name)
 * [`qfg profile`](#qfg-profile)
+* [`qfg pull`](#qfg-pull)
 * [`qfg schema NAME`](#qfg-schema-name)
 * [`qfg serve DATA-FILE`](#qfg-serve-data-file)
 * [`qfg set-default [NAME]`](#qfg-set-default-name)
+* [`qfg sync`](#qfg-sync)
 * [`qfg verify [PATH]`](#qfg-verify-path)
 * [`qfg whoami`](#qfg-whoami)
 * [`qfg workspace`](#qfg-workspace)
+* [`qfg workspace bootstrap`](#qfg-workspace-bootstrap)
 
 ## `qfg create NAME`
 
@@ -92,7 +96,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.4/src/commands/create.ts)_
 
 ## `qfg download`
 
@@ -125,7 +129,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.4/src/commands/download.ts)_
 
 ## `qfg generate`
 
@@ -195,7 +199,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.4/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -218,7 +222,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.4/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -250,7 +254,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.4/src/commands/get.ts)_
 
 ## `qfg info [NAME]`
 
@@ -280,7 +284,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.4/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.4/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -298,7 +340,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.4/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -335,7 +377,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.4/src/commands/list.ts)_
 
 ## `qfg login`
 
@@ -363,7 +405,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.4/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -386,7 +428,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.4/src/commands/logout.ts)_
 
 ## `qfg mcp`
 
@@ -416,10 +458,10 @@ EXAMPLES
 
   $ qfg mcp --editor cursor
 
-  $ qfg mcp --url http://local-app.goatsofquonfig.com:3003/api/v1/mcp
+  $ qfg mcp --url http://local-app.quonfig-staging.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.4/src/commands/mcp.ts)_
 
 ## `qfg override [NAME]`
 
@@ -458,7 +500,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.4/src/commands/override.ts)_
 
 ## `qfg profile`
 
@@ -481,7 +523,36 @@ 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.4/src/commands/profile.ts)_
+
+## `qfg pull`
+
+Clone or update a local directory from the workspace Gitea repo
+
+```
+USAGE
+  $ qfg pull [--json] [--interactive] [--no-color] [--verbose] [--dir <value>] [--workspace <value>]
+
+FLAGS
+  --dir=<value>        Local directory to clone/update (defaults to QUONFIG_DIR env var)
+  --workspace=<value>  Workspace ID (defaults to active profile)
+
+GLOBAL FLAGS
+  --[no-]interactive  Force interactive mode
+  --json              Format output as json.
+  --no-color          Do not colorize output
+  --verbose           Verbose output
+
+DESCRIPTION
+  Clone or update a local directory from the workspace Gitea repo
+
+EXAMPLES
+  $ qfg pull --dir ./our-config
+
+  $ qfg pull  # uses QUONFIG_DIR env var
+```
+
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.4/src/commands/pull.ts)_
 
 ## `qfg schema NAME`
 
@@ -519,7 +590,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.4/src/commands/schema.ts)_
 
 ## `qfg serve DATA-FILE`
 
@@ -555,7 +626,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.4/src/commands/serve.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -599,7 +670,39 @@ 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.4/src/commands/set-default.ts)_
+
+## `qfg sync`
+
+Continuously poll for workspace config updates and apply them locally
+
+```
+USAGE
+  $ qfg sync --watch [--json] [--interactive] [--no-color] [--verbose] [--dir <value>] [--interval <value>]
+
+FLAGS
+  --dir=<value>       Local directory to sync (defaults to QUONFIG_DIR env var)
+  --interval=<value>  [default: 60] Poll interval in seconds
+  --watch             (required) Run as a continuous polling daemon (required)
+
+GLOBAL FLAGS
+  --[no-]interactive  Force interactive mode
+  --json              Format output as json.
+  --no-color          Do not colorize output
+  --verbose           Verbose output
+
+DESCRIPTION
+  Continuously poll for workspace config updates and apply them locally
+
+EXAMPLES
+  $ qfg sync --watch
+
+  $ qfg sync --watch --interval 10
+
+  $ qfg sync --watch --dir ./our-config --interval 30
+```
+
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.4/src/commands/sync.ts)_
 
 ## `qfg verify [PATH]`
 
@@ -632,7 +735,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.4/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -655,7 +758,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.4/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -678,7 +781,40 @@ 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.4/src/commands/workspace.ts)_
+
+## `qfg workspace bootstrap`
+
+Push a local git repo to Gitea as this workspace's config repository
+
+```
+USAGE
+  $ qfg workspace bootstrap [--json] [--interactive] [--no-color] [--verbose] [--dir <value>] [--force]
+  [--skip-validate]
+
+FLAGS
+  --dir=<value>    Local directory to push (defaults to current directory)
+  --force          Force push even if remote already has commits
+  --skip-validate  Skip config validation before pushing
+
+GLOBAL FLAGS
+  --[no-]interactive  Force interactive mode
+  --json              Format output as json.
+  --no-color          Do not colorize output
+  --verbose           Verbose output
+
+DESCRIPTION
+  Push a local git repo to Gitea as this workspace's config repository
+
+EXAMPLES
+  $ qfg workspace bootstrap --dir ./our-config
+
+  $ qfg workspace bootstrap --dir ./launch-migrator/output
+
+  $ qfg workspace bootstrap --dir ./our-config --skip-validate
+```
+
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.4/src/commands/workspace/bootstrap.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/bin/dev.js

@@ -1,9 +1,5 @@
-#!/usr/bin/env -S node --loader ts-node/esm --no-warnings=ExperimentalWarning
-
-// eslint-disable-next-line node/shebang
-async function main() {
-  const {execute} = await import('@oclif/core')
-  await execute({development: true, dir: import.meta.url})
-}
-
-await main()
+#!/usr/bin/env bash
+# Run dev CLI from any directory — ensures ts-node resolves from cli's node_modules
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+export TS_NODE_PROJECT="$DIR/tsconfig.json"
+exec node --loader "$DIR/node_modules/ts-node/esm.mjs" --no-warnings=ExperimentalWarning "$DIR/bin/dev.mjs" "$@"

package/bin/dev.mjs

@@ -0,0 +1,6 @@
+async function main() {
+  const {execute} = await import('@oclif/core')
+  await execute({development: true, dir: import.meta.url})
+}
+
+await main()

package/dist/codegen/zod-introspection.js

@@ -183,18 +183,27 @@ export function getMetaDescription(schema) {
     if (!meta || Object.keys(meta).length === 0) {
         return undefined;
     }
-    // If meta only has a description key, return just the description
     const keys = Object.keys(meta);
-    if (keys.length === 1 && keys[0] === 'description' && typeof meta.description === 'string') {
-        return meta.description;
+    const standardKeys = new Set(['title', 'description']);
+    const hasExtraKeys = keys.some((k) => !standardKeys.has(k));
+    // If meta has non-standard keys (e.g. id, required, deprecated),
+    // return JSON representation of the entire meta object so all metadata is preserved
+    if (hasExtraKeys) {
+        try {
+            return JSON.stringify(meta, null, 2);
+        }
+        catch {
+            // If JSON serialization fails, fall through
+        }
     }
+    // For standard keys only (title, description), prefer description then title
     if (typeof meta.description === 'string') {
         return meta.description;
     }
     if (typeof meta.title === 'string') {
         return meta.title;
     }
-    // Otherwise, return JSON representation of the entire meta object
+    // Fallback: return JSON representation of the entire meta object
     try {
         return JSON.stringify(meta, null, 2);
     }

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/commands/login.js

@@ -1,4 +1,5 @@
 import { Flags } from '@oclif/core';
+import { select } from '@inquirer/prompts';
 import { BaseCommand } from '../index.js';
 import { decodeJWT, pollForToken, requestDeviceCode } from '../util/oauth-client.js';
 import { getApiUrl } from '../util/domain-urls.js';
@@ -53,6 +54,8 @@ export default class Login extends BaseCommand {
         // Resolve org_id → workspace UUID via the API
         let workspaceId;
         let workspaceName;
+        let workspaceSlug;
+        let organizationName;
         try {
             const apiUrl = getApiUrl();
             this.verboseLog('Resolving workspace...', { apiUrl, orgId });
@@ -66,14 +69,28 @@ export default class Login extends BaseCommand {
             });
             if (res.ok) {
                 const body = await res.json();
-                const workspaces = body.json ?? body;
-                const match = Array.isArray(workspaces)
-                    ? workspaces.find((w) => w.workosOrgId === orgId) ?? workspaces[0]
-                    : undefined;
+                const allWorkspaces = (body.json ?? body);
+                const orgWorkspaces = Array.isArray(allWorkspaces)
+                    ? allWorkspaces.filter((w) => w.workosOrgId === orgId)
+                    : [];
+                const candidates = orgWorkspaces.length > 0 ? orgWorkspaces : (Array.isArray(allWorkspaces) ? allWorkspaces : []);
+                let match;
+                if (candidates.length === 1) {
+                    match = candidates[0];
+                }
+                else if (candidates.length > 1) {
+                    const chosen = await select({
+                        choices: candidates.map((w) => ({ name: w.workspaceSlug, value: w.workspaceId })),
+                        message: 'Select workspace:',
+                    });
+                    match = candidates.find((w) => w.workspaceId === chosen);
+                }
                 if (match) {
                     workspaceId = match.workspaceId;
-                    workspaceName = match.organizationName;
-                    this.verboseLog('Resolved workspace', { workspaceId, workspaceName });
+                    workspaceName = match.workspaceSlug;
+                    workspaceSlug = match.workspaceSlug;
+                    organizationName = match.organizationName;
+                    this.verboseLog('Resolved workspace', { workspaceId, workspaceName, workspaceSlug, organizationName });
                 }
             }
             else {
@@ -95,6 +112,7 @@ export default class Login extends BaseCommand {
                 [profileName]: {
                     workspace: workspaceId || orgId || 'unknown',
                     workspaceName: workspaceName || (orgId ? `org:${orgId}` : undefined),
+                    workspaceSlug,
                 },
             },
         });
@@ -108,6 +126,9 @@ export default class Login extends BaseCommand {
         }
         if (workspaceName) {
             this.log(`Workspace: ${workspaceName} (${workspaceId})`);
+            if (organizationName) {
+                this.log(`Organization: ${organizationName}`);
+            }
         }
         else if (orgId) {
             this.log(`Organization: ${orgId}`);

package/dist/commands/mcp.js

@@ -12,7 +12,7 @@ export default class Mcp extends BaseCommand {
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --editor cursor',
-        '<%= config.bin %> <%= command.id %> --url http://local-app.goatsofquonfig.com:3003/api/v1/mcp',
+        '<%= config.bin %> <%= command.id %> --url http://local-app.quonfig-staging.com:3003/api/v1/mcp',
     ];
     static flags = {
         ...BaseCommand.baseFlags,

package/dist/commands/pull.d.ts

@@ -0,0 +1,15 @@
+import type { JsonObj } from '../result.js';
+import { BaseCommand } from '../index.js';
+export default class Pull extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        dir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        workspace: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<JsonObj | void>;
+    private resolveRepoUrl;
+    private refreshAndGetUrl;
+    private looksLike401;
+    private maybeWriteQuonfigDir;
+}