@quonfig/cli 0.0.15 → 0.0.16

package/dist/push/run-push.js

@@ -0,0 +1,318 @@
+/**
+ * Core logic for `qfg push`. Pure-ish, dependency-injected, so tests can drive
+ * it without hitting the network, touching git, or running validation.
+ *
+ * The oclif command (`src/commands/push.ts`) is a thin wrapper that fills in
+ * real implementations of every dependency and calls `runPush`.
+ *
+ * The three guards from `project/plans/cli-git-sync.md` are all enforced here:
+ *   - Guards 1 + 2: `checkIdentity` cross-checks the requested target, repo
+ *     pin, and git origin against the backend-resolved workspace.
+ *   - Guard 3: `summarizeDiff` + `confirmYesNo`/`confirmTypedSlug` force the
+ *     user to acknowledge destructive changes.
+ *
+ * Dispatch between the "clone path" (the local dir is a clone of the cloud
+ * repo) and the "bare path" (anything else — no .git, or a mismatched origin)
+ * is decided after identity passes.
+ *
+ * `--yes` skips the normal Y/N confirmation. It NEVER skips a typed-slug
+ * confirmation — that prompt is the destructive-change brake.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { MIGRATOR_IDENTITY, cloneAndStackPush } from '../util/clone-and-stack-push.js';
+import { readWorkspaceSlug, writeWorkspaceSlug } from '../util/quonfig-json.js';
+import { checkIdentity } from './identity-check.js';
+import { confirmTypedSlug, confirmYesNo } from './confirm.js';
+import { summarizeDiff } from './diff-summary.js';
+export class PushFatalError extends Error {
+    code;
+    constructor(message, code = 'PUSH_FATAL') {
+        super(message);
+        this.code = code;
+        this.name = 'PushFatalError';
+    }
+}
+/**
+ * Normalize a git remote URL for case-insensitive-host comparison. Mirrors
+ * the logic in `identity-check.ts` but we only need the boolean "do these
+ * point at the same repo" answer.
+ */
+const normalizeForCompare = (url) => {
+    const stripped = url.replace(/^([a-z][\d+.a-z-]*:\/\/)[^/@]+@/i, '$1');
+    try {
+        const u = new URL(stripped);
+        const host = u.host.toLowerCase();
+        const pathname = u.pathname.replace(/\/+$/, '').replace(/\.git$/, '');
+        return `${u.protocol}//${host}${pathname}`;
+    }
+    catch {
+        return url.trim();
+    }
+};
+const sameRepo = (a, b) => normalizeForCompare(a) === normalizeForCompare(b);
+const PUSHED_VIA_TRAILER = 'Pushed-Via: cli';
+/** Append the Pushed-Via trailer to a commit message if it isn't already present. */
+export const withPushedViaTrailer = (message) => {
+    if (message.includes(PUSHED_VIA_TRAILER))
+        return message;
+    const trimmed = message.replace(/\s+$/, '');
+    return `${trimmed}\n\n${PUSHED_VIA_TRAILER}\n`;
+};
+export async function runPush(input, deps) {
+    const log = deps.log ?? ((s) => console.log(s));
+    const errLog = deps.errLog ?? ((s) => console.error(s));
+    if (!input.requestedTarget || input.requestedTarget.trim().length === 0) {
+        throw new PushFatalError('No workspace target set. Pass --workspace or run `qfg login` to set the active profile workspace.', 'NO_TARGET');
+    }
+    if (!fs.existsSync(input.dir)) {
+        throw new PushFatalError(`Directory does not exist: ${input.dir}`, 'NO_DIR');
+    }
+    // Guard 1 pre-work: read repo pin + current origin BEFORE we mint a write
+    // token. The identity check happens after minting (so we can cross-reference
+    // the backend's canonical identity) but we want the pin/origin up front.
+    const repoPinSlug = await readWorkspaceSlug(input.dir);
+    const hasGit = await deps.gitOps.isGitRepo(input.dir);
+    const remoteOriginUrl = hasGit ? await deps.gitOps.getRemoteOriginUrl(input.dir) : undefined;
+    // Mint the write token. The backend accepts a slug OR a UUID for workspaceId
+    // and resolves to the same row — we trust whatever `requestedTarget` is.
+    const backend = await deps.mintWriteToken(input.requestedTarget);
+    // Guards 1 + 2: cross-check the three identity signals.
+    const identity = checkIdentity({
+        requestedTarget: input.requestedTarget,
+        repoPinSlug,
+        remoteOriginUrl,
+        backend: {
+            workspaceSlug: backend.workspaceSlug,
+            workspaceId: backend.workspaceId,
+            repoUrl: backend.repoUrl,
+        },
+    });
+    if (identity.kind === 'abort') {
+        errLog(`Identity check failed: ${identity.reason}`);
+        for (const [k, v] of Object.entries(identity.details)) {
+            errLog(`  ${k}: ${v}`);
+        }
+        errLog('Refusing to push. --yes does not override this.');
+        throw new PushFatalError(`identity check: ${identity.reason}`, 'IDENTITY_ABORT');
+    }
+    const requiresTypedSlug = identity.kind === 'requires-typed-slug-confirmation';
+    // Guard: validation. Skipped with --skip-validate.
+    if (!input.skipValidate) {
+        log('Verifying config files...');
+        const result = await deps.validate(input.dir);
+        if (result.errors.length > 0) {
+            errLog(`Found ${result.errors.length} validation error(s):`);
+            for (const msg of result.errors)
+                errLog(`  ${msg}`);
+            throw new PushFatalError('validation failed; pass --skip-validate to bypass', 'VALIDATION_FAILED');
+        }
+        log('Validation passed.');
+    }
+    // Dispatch: clone path vs bare path.
+    //
+    // Clone path: the dir has a `.git/` AND its origin normalizes to the
+    // backend.repoUrl. We push HEAD directly.
+    //
+    // Bare path: no `.git/`, OR the origin points elsewhere. We clone the cloud
+    // repo into a scratch dir inside `.quonfig-push-clone/` and stack a commit
+    // that mirrors the local dir's contents on top.
+    const isClonePath = hasGit && remoteOriginUrl !== undefined && sameRepo(remoteOriginUrl, backend.repoUrl);
+    if (isClonePath) {
+        return doClonePath(input, deps, backend, requiresTypedSlug, repoPinSlug === undefined, log);
+    }
+    return doBarePath(input, deps, backend, requiresTypedSlug, repoPinSlug === undefined, log);
+}
+async function doClonePath(input, deps, backend, requiresTypedSlug, unpinned, log) {
+    // Point origin at the authenticated URL so `git fetch` / `git push` work
+    // without touching global credential helpers.
+    await deps.gitOps.setRemoteOrigin(input.dir, backend.repoUrl);
+    log('Fetching from remote...');
+    await deps.gitOps.fetch(input.dir);
+    const deltas = await deps.gitOps.diffHeadVsOrigin(input.dir);
+    const totalFilesInRemote = await deps.gitOps.countFilesInRemote(input.dir);
+    const summary = summarizeDiff(deltas, { totalFilesInRemote, unpinned });
+    log('');
+    log(summary.renderText({
+        workspaceSlug: backend.workspaceSlug,
+        repoUrl: stripAuth(backend.repoUrl),
+        branch: 'main',
+        localDir: input.dir,
+    }));
+    log('');
+    // Short-circuit: literally nothing to push.
+    if (summary.totals.filesTouched === 0) {
+        return { kind: 'no-op', reason: 'Local tree matches remote HEAD. Nothing to push.' };
+    }
+    const ok = await decideConfirm({
+        destructive: summary.isDestructive,
+        requiresTypedSlug,
+        yes: input.yes,
+        workspaceSlug: backend.workspaceSlug,
+        confirmIO: deps.confirmIO,
+    });
+    if (!ok) {
+        log('Aborted, nothing pushed.');
+        return { kind: 'aborted', reason: 'user declined at confirm prompt' };
+    }
+    log('Pushing to origin/main...');
+    try {
+        await deps.gitOps.push(input.dir);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        if (/non-fast-forward|fetch first|rejected/i.test(msg)) {
+            throw new PushFatalError('Remote has changes not in local — run `qfg pull` first, then re-run `qfg push`.', 'NON_FAST_FORWARD');
+        }
+        throw new PushFatalError(`Push failed: ${msg}`, 'PUSH_FAILED');
+    }
+    // Offer to pin the workspace slug in quonfig.json if missing. Non-fatal.
+    if (unpinned && !input.noPinWrite) {
+        try {
+            await writeWorkspaceSlug(input.dir, backend.workspaceSlug);
+            log(`Wrote workspace = "${backend.workspaceSlug}" into quonfig.json`);
+        }
+        catch {
+            // non-fatal; pin is advisory
+        }
+    }
+    return { kind: 'pushed', dispatchedAs: 'clone-path' };
+}
+async function doBarePath(input, deps, backend, requiresTypedSlug, unpinned, log) {
+    // Scratch clone location: sibling `.quonfig-push-clone-<timestamp>` so we
+    // don't clobber or re-use anything from a previous run.
+    const scratchDir = path.join(path.dirname(path.resolve(input.dir)), `.quonfig-push-clone-${Date.now()}`);
+    // Local author for the migrated commit. Prefer the local git config in
+    // `input.dir` so attribution matches what the user has set. If it is not
+    // available, fall back to the migrator identity but tell the user — the plan
+    // requires this be loud.
+    let author = MIGRATOR_IDENTITY;
+    try {
+        const local = await deps.gitOps.getLocalAuthor(input.dir);
+        if (local && local.name && local.email) {
+            author = local;
+        }
+        else {
+            log(`Warning: no local git user.name/user.email in ${input.dir}; commits will be attributed to ${MIGRATOR_IDENTITY.name} <${MIGRATOR_IDENTITY.email}>.`);
+        }
+    }
+    catch {
+        log(`Warning: could not read local git user identity; commits will be attributed to ${MIGRATOR_IDENTITY.name} <${MIGRATOR_IDENTITY.email}>.`);
+    }
+    // We need the deltas for the Guard 3 summary BEFORE we decide to commit and
+    // push. To produce them we need the scratch clone in hand (so we can compare
+    // file-by-file). We clone into the scratch dir, take the diff, show the
+    // summary, confirm, then apply the delta via `cloneAndStackPush`.
+    //
+    // Rather than re-implement cloneAndStackPush's clone step here, we let it
+    // own the clone-commit-push pipeline and pass a deltas callback that runs
+    // AFTER the clone (it receives the localDir/scratchDir) but BEFORE the
+    // commit. `cloneAndStackPush` only exposes an `applyDelta` hook (write files
+    // then return), so we split the flow: first a probe clone to take the
+    // diff, then the real clone-and-stack-push. This is simpler than rewiring
+    // cloneAndStackPush's API.
+    // Probe clone.
+    await deps.gitOps.fetch(input.dir) // no-op for bare path if not a repo; deps.gitOps may short-circuit
+        .catch(() => {
+        // bare-path doesn't require a local fetch — swallow the error
+    });
+    // We don't have a probe clone helper; instead, ask the deps for a bare-path
+    // delta computation. The test double will produce this from a fixture; the
+    // real implementation walks both trees after ensuring a scratch clone exists.
+    // This is provided by the command glue layer.
+    const deltas = await deps.gitOps.diffHeadVsOrigin(input.dir);
+    const totalFilesInRemote = await deps.gitOps.countFilesInRemote(input.dir);
+    const summary = summarizeDiff(deltas, { totalFilesInRemote, unpinned });
+    log('');
+    log(summary.renderText({
+        workspaceSlug: backend.workspaceSlug,
+        repoUrl: stripAuth(backend.repoUrl),
+        branch: 'main',
+        localDir: input.dir,
+    }));
+    log('');
+    if (summary.totals.filesTouched === 0) {
+        return { kind: 'no-op', reason: 'Local tree matches remote HEAD. Nothing to push.' };
+    }
+    const ok = await decideConfirm({
+        destructive: summary.isDestructive,
+        requiresTypedSlug,
+        yes: input.yes,
+        workspaceSlug: backend.workspaceSlug,
+        confirmIO: deps.confirmIO,
+    });
+    if (!ok) {
+        log('Aborted, nothing pushed.');
+        return { kind: 'aborted', reason: 'user declined at confirm prompt' };
+    }
+    const baseMessage = input.message ?? `qfg push: ${summary.totals.filesTouched} file change(s)`;
+    const commitMessage = withPushedViaTrailer(baseMessage);
+    log('Pushing via clone-and-stack...');
+    try {
+        const result = await cloneAndStackPush({
+            remoteUrl: backend.repoUrl,
+            localDir: scratchDir,
+            author,
+            commitMessage,
+            async applyDelta(clonedDir) {
+                // The caller promised deps.copyDirMirror copies `input.dir` into
+                // `clonedDir`, skipping `.git/`. cloneAndStackPush will `git add --all`
+                // after this returns.
+                await deps.copyDirMirror(input.dir, clonedDir);
+            },
+        });
+        if (unpinned && !input.noPinWrite) {
+            try {
+                await writeWorkspaceSlug(input.dir, backend.workspaceSlug);
+                log(`Wrote workspace = "${backend.workspaceSlug}" into quonfig.json`);
+            }
+            catch {
+                // non-fatal
+            }
+        }
+        return { kind: 'pushed', dispatchedAs: 'bare-path', commitSha: result.commitSha };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        if (/non-fast-forward|fetch first|rejected/i.test(msg)) {
+            throw new PushFatalError('Remote has changes not in local — run `qfg pull` first, then re-run `qfg push`.', 'NON_FAST_FORWARD');
+        }
+        throw new PushFatalError(`Push failed: ${msg}`, 'PUSH_FAILED');
+    }
+    finally {
+        // Best-effort cleanup of the scratch clone. Ignore failures so a cleanup
+        // problem doesn't mask a real error.
+        try {
+            fs.rmSync(scratchDir, { recursive: true, force: true });
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+/**
+ * Map the guard outputs to the right prompt:
+ *   - Typed-slug (always, never skipped by --yes) when identity demanded it
+ *     OR when the diff is destructive.
+ *   - Standard Y/N otherwise, unless --yes is set.
+ */
+async function decideConfirm(args) {
+    const needsTyped = args.requiresTypedSlug || args.destructive;
+    if (needsTyped) {
+        return confirmTypedSlug(args.workspaceSlug, `Type the workspace slug "${args.workspaceSlug}" to confirm: `, args.confirmIO ?? {});
+    }
+    if (args.yes)
+        return true;
+    return confirmYesNo('Proceed? [y/N] ', args.confirmIO ?? {});
+}
+const stripAuth = (url) => {
+    try {
+        const u = new URL(url);
+        u.username = '';
+        u.password = '';
+        return u.toString();
+    }
+    catch {
+        return url;
+    }
+};

package/dist/util/gitea-api.d.ts

@@ -3,8 +3,22 @@ export interface GiteaTokenResponse {
     expiresAt: string | null;
     repoUrl: string;
     token: string;
+    /**
+     * Canonical workspace UUID for the minted token. Used as the backend
+     * identity in the push identity check — required so the CLI can match a
+     * `--workspace <UUID>` request against the canonical workspace row without
+     * assuming the slug is also the UUID. Backend returns this alongside
+     * `workspaceSlug` as of the Guard 1 rollout in `project/plans/cli-git-sync.md`.
+     */
+    workspaceId: string;
+    /**
+     * Human-readable workspace slug (NOT the UUID). Used to pin `quonfig.json`
+     * and for identity-check guard messages. Required as of the Guard 1 rollout
+     * in `project/plans/cli-git-sync.md`; the backend always returns it.
+     */
+    workspaceSlug: string;
 }
-export declare const mintGiteaToken: (workspaceId: string, scope: "read" | "write", purpose: "pull" | "bootstrap") => Promise<GiteaTokenResponse>;
+export declare const mintGiteaToken: (workspaceId: string, scope: "read" | "write", purpose: "pull" | "bootstrap" | "push") => Promise<GiteaTokenResponse>;
 /**
  * Mint a Gitea read token, store it, and return the entry.
  */

package/dist/util/gitea-api.js

@@ -41,6 +41,7 @@ export const mintAndStoreGiteaReadToken = async (workspaceId) => {
         token: data.token,
         repoUrl: data.repoUrl,
         expiresAt: data.expiresAt,
+        workspaceSlug: data.workspaceSlug,
     };
     await saveGiteaToken(workspaceId, entry);
     return entry;

package/dist/util/gitea-token-storage.d.ts

@@ -2,6 +2,13 @@ export interface GiteaTokenEntry {
     expiresAt: string | null;
     repoUrl: string;
     token: string;
+    /**
+     * Human-readable workspace slug (NOT the UUID). Populated from the
+     * `gitea.token` response. Optional to stay backward-compatible with older
+     * entries written before the field was added; callers must handle the
+     * `undefined` case by re-minting.
+     */
+    workspaceSlug?: string;
 }
 export declare const loadGiteaToken: (workspaceId: string) => Promise<GiteaTokenEntry | null>;
 export declare const saveGiteaToken: (workspaceId: string, entry: GiteaTokenEntry) => Promise<void>;

package/dist/util/quonfig-json.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Reader/writer for the workspace's `quonfig.json` file.
+ *
+ * Today the file is `{ environments: string[] }`. We are adding an optional
+ * `workspace: "<slug>"` pin (Guard 1 in `project/plans/cli-git-sync.md`)
+ * so commands like `qfg push` can confirm that the local dir belongs to the
+ * cloud workspace they think it does.
+ *
+ * The reader is permissive: missing file or missing field returns `undefined`
+ * (no throw). It only throws when the file exists but cannot be parsed.
+ *
+ * The writer preserves all unknown fields, sticks to 2-space indent, and
+ * always ends with a trailing newline — matching how `qfg init` and the
+ * migrate flow create the file today.
+ */
+/**
+ * Shape of `quonfig.json`. Everything is optional from the reader's
+ * perspective so a partially-written or in-flight file doesn't blow up
+ * downstream consumers — `qfg verify` is the source of strict validation.
+ */
+export interface QuonfigJson {
+    [key: string]: unknown;
+    environments?: string[];
+    /** Workspace slug (human-readable, not the UUID). Used as the repo pin. */
+    workspace?: string;
+}
+/**
+ * Read the workspace slug pin from `<dir>/quonfig.json`.
+ *
+ * Returns `undefined` when the file is missing OR when the `workspace`
+ * field is absent OR when the field is present but not a string.
+ * Throws only when the file exists but contains malformed JSON, since
+ * that is a real bug a caller should surface.
+ */
+export declare function readWorkspaceSlug(dir: string): Promise<string | undefined>;
+/**
+ * Write the workspace slug pin into `<dir>/quonfig.json`.
+ *
+ * If the file exists, all other fields are preserved and only `workspace`
+ * is set/overwritten. If the file is missing, a minimal `{workspace: slug}`
+ * file is created. Format is 2-space indent + trailing newline to match
+ * the file shape produced by `qfg init` and `qfg migrate`.
+ */
+export declare function writeWorkspaceSlug(dir: string, slug: string): Promise<void>;

package/dist/util/quonfig-json.js

@@ -0,0 +1,65 @@
+/**
+ * Reader/writer for the workspace's `quonfig.json` file.
+ *
+ * Today the file is `{ environments: string[] }`. We are adding an optional
+ * `workspace: "<slug>"` pin (Guard 1 in `project/plans/cli-git-sync.md`)
+ * so commands like `qfg push` can confirm that the local dir belongs to the
+ * cloud workspace they think it does.
+ *
+ * The reader is permissive: missing file or missing field returns `undefined`
+ * (no throw). It only throws when the file exists but cannot be parsed.
+ *
+ * The writer preserves all unknown fields, sticks to 2-space indent, and
+ * always ends with a trailing newline — matching how `qfg init` and the
+ * migrate flow create the file today.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const QUONFIG_JSON = 'quonfig.json';
+async function readQuonfigJson(dir) {
+    const filePath = path.join(dir, QUONFIG_JSON);
+    let raw;
+    try {
+        raw = await fs.promises.readFile(filePath, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    // JSON.parse will throw on malformed JSON — that's the documented behavior.
+    const parsed = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new TypeError(`${QUONFIG_JSON} must be a JSON object`);
+    }
+    return parsed;
+}
+/**
+ * Read the workspace slug pin from `<dir>/quonfig.json`.
+ *
+ * Returns `undefined` when the file is missing OR when the `workspace`
+ * field is absent OR when the field is present but not a string.
+ * Throws only when the file exists but contains malformed JSON, since
+ * that is a real bug a caller should surface.
+ */
+export async function readWorkspaceSlug(dir) {
+    const parsed = await readQuonfigJson(dir);
+    if (!parsed)
+        return undefined;
+    const slug = parsed.workspace;
+    return typeof slug === 'string' ? slug : undefined;
+}
+/**
+ * Write the workspace slug pin into `<dir>/quonfig.json`.
+ *
+ * If the file exists, all other fields are preserved and only `workspace`
+ * is set/overwritten. If the file is missing, a minimal `{workspace: slug}`
+ * file is created. Format is 2-space indent + trailing newline to match
+ * the file shape produced by `qfg init` and `qfg migrate`.
+ */
+export async function writeWorkspaceSlug(dir, slug) {
+    const existing = (await readQuonfigJson(dir)) ?? {};
+    const next = { ...existing, workspace: slug };
+    const filePath = path.join(dir, QUONFIG_JSON);
+    await fs.promises.writeFile(filePath, JSON.stringify(next, null, 2) + '\n', 'utf8');
+}

package/dist/verify/validate.js

@@ -279,7 +279,9 @@ export function validateWorkspace(workspaceDir) {
                 quonfigParsed = null;
                 issues.push({ file: 'quonfig.json', message: `Invalid JSON: ${error.message}`, severity: 'error' });
             }
-            const quonfigResult = z.object({ environments: z.array(z.string()) }).safeParse(quonfigParsed);
+            const quonfigResult = z
+                .object({ environments: z.array(z.string()), workspace: z.string().optional() })
+                .safeParse(quonfigParsed);
             if (quonfigResult.success) {
                 for (const envId of quonfigResult.data.environments) {
                     declaredEnvIds.add(envId);
@@ -606,7 +608,9 @@ export function validateFileMap(files) {
             issues.push({ file: 'quonfig.json', message: `Invalid JSON: ${error.message}`, severity: 'error' });
         }
         if (quonfigParsed !== null) {
-            const quonfigResult = z.object({ environments: z.array(z.string()) }).safeParse(quonfigParsed);
+            const quonfigResult = z
+                .object({ environments: z.array(z.string()), workspace: z.string().optional() })
+                .safeParse(quonfigParsed);
             if (quonfigResult.success) {
                 for (const envId of quonfigResult.data.environments) {
                     declaredEnvIds.add(envId);

package/oclif.manifest.json

@@ -567,6 +567,14 @@
           "name": "samples",
           "allowNo": true,
           "type": "boolean"
+        },
+        "workspace": {
+          "description": "Workspace slug to pin in quonfig.json (Guard 1). If omitted, no pin is written.",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -1287,6 +1295,101 @@
         "pull.js"
       ]
     },
+    "push": {
+      "aliases": [],
+      "args": {},
+      "description": "Push local config changes up to your workspace on Quonfig cloud.\n\nEnforces three guards before touching the remote:\n  1. The dir's quonfig.json \"workspace\" pin must match the backend (if set).\n  2. The dir's git origin must match the backend repo URL (if set).\n  3. A diff summary is shown; destructive changes (10+ deletes, >=25% of\n     files, or an unpinned dir) require typing the workspace slug to confirm.\n\n  qfg push                                 # uses QUONFIG_DIR + profile workspace\n  qfg push --dir ./our-config\n  qfg push --dir ./our-config --workspace acme-prod\n  qfg push --dir ./our-config --yes        # skip normal Y/N (never skips typed-slug)\n  qfg push --dir ./our-config --skip-validate",
+      "examples": [
+        "<%= config.bin %> push --dir ./our-config",
+        "<%= config.bin %> push --workspace acme-prod --dir ./our-config",
+        "<%= config.bin %> push --dir ./our-config --yes"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interactive": {
+          "description": "Force interactive mode",
+          "helpGroup": "GLOBAL",
+          "name": "interactive",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "no-color": {
+          "description": "Do not colorize output",
+          "env": "NO_COLOR",
+          "helpGroup": "GLOBAL",
+          "name": "no-color",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "description": "Verbose output",
+          "helpGroup": "GLOBAL",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dir": {
+          "description": "Local directory to push (defaults to QUONFIG_DIR env var)",
+          "name": "dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "description": "Workspace slug or UUID (defaults to active profile)",
+          "name": "workspace",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "description": "Skip the standard Y/N confirm. Never skips typed-slug prompts.",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-validate": {
+          "description": "Skip `qfg validate` preflight",
+          "name": "skip-validate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-pin-write": {
+          "description": "Do not offer to write workspace slug into quonfig.json on success",
+          "name": "no-pin-write",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "message": {
+          "char": "m",
+          "description": "Commit message for bare-path pushes (ignored on clone-path; push what is already committed)",
+          "name": "message",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "push",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "push.js"
+      ]
+    },
     "schema": {
       "aliases": [],
       "args": {
@@ -2586,5 +2689,5 @@
       ]
     }
   },
-  "version": "0.0.15"
+  "version": "0.0.16"
 }

package/package.json

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