@quonfig/cli 0.0.21 → 0.0.23

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.21 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.23 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -27,6 +27,7 @@ USAGE
 <!-- commands -->
 * [`qfg config-schema`](#qfg-config-schema)
 * [`qfg create NAME`](#qfg-create-name)
+* [`qfg delete NAME`](#qfg-delete-name)
 * [`qfg flag info [NAME]`](#qfg-flag-info-name)
 * [`qfg flag list`](#qfg-flag-list)
 * [`qfg flag show [NAME]`](#qfg-flag-show-name)
@@ -91,7 +92,7 @@ EXAMPLES
   $ qfg config-schema --json-schema    # full JSON Schema document (copy into your editor)
 ```
 
-_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -176,7 +177,53 @@ EXAMPLES
   $ qfg set-rollout my.new.flag --environment production --true-percent 20
 ```
 
-_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/create.ts)_
+
+## `qfg delete NAME`
+
+Delete a flag, config, or log-level from the workspace.
+
+```
+USAGE
+  $ qfg delete NAME [--json] [--interactive] [--no-color] [--verbose] [-w <value>] [--yes]
+
+ARGUMENTS
+  NAME  flag/config/log-level key to delete
+
+FLAGS
+  --yes  skip confirmation prompt
+
+GLOBAL FLAGS
+  -w, --workspace=<value>  Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)
+      --[no-]interactive   Force interactive mode
+      --json               Format output as json.
+      --no-color           Do not colorize output
+      --verbose            Verbose output
+
+DESCRIPTION
+  Delete a flag, config, or log-level from the workspace.
+
+  DESTRUCTIVE — removes the underlying JSON file from the workspace git repo
+  and commits with the actor's identity. The commit history preserves the
+  prior content; this is a hard-delete on the file but a soft-delete on
+  history.
+
+  Confirmation is required:
+  --yes                       skip the prompt (for scripts and CI)
+  interactive (default)       you'll be asked to type the key name back
+
+  Examples
+  qfg delete my.flag --yes
+  qfg delete my.flag                          # interactive: type the key back to confirm
+  qfg delete my.config --yes
+
+EXAMPLES
+  $ qfg delete my.flag --yes
+
+  $ qfg delete my.config --yes
+```
+
+_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/delete.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -379,7 +426,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.21/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -402,7 +449,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -434,7 +481,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/get.ts)_
 
 ## `qfg info [NAME]`
 
@@ -482,7 +529,7 @@ EXAMPLES
   $ qfg info my.config.name --exclude-evaluations   # skip 24h stats
 ```
 
-_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -522,7 +569,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -552,7 +599,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -592,7 +639,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/list.ts)_
 
 ## `qfg log-level NAME`
 
@@ -657,7 +704,7 @@ EXAMPLES
   $ qfg log-level log-level.my-app --target=Chatty --value=INFO --environment=production
 ```
 
-_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/log-level.ts)_
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/log-level.ts)_
 
 ## `qfg login`
 
@@ -682,7 +729,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -705,7 +752,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/logout.ts)_
 
 ## `qfg mcp`
 
@@ -738,7 +785,7 @@ EXAMPLES
   $ 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.21/src/commands/mcp.ts)_
+_See code: [src/commands/mcp.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/mcp.ts)_
 
 ## `qfg migrate`
 
@@ -792,7 +839,7 @@ EXAMPLES
   $ qfg migrate --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-config --staging
 ```
 
-_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -830,7 +877,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -862,7 +909,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -893,7 +940,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME] [VALUE]`
 
@@ -948,7 +995,7 @@ EXAMPLES
   $ qfg override my.flag true --env=staging
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -992,7 +1039,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -1040,7 +1087,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/push.ts)_
 
 ## `qfg schema NAME`
 
@@ -1078,7 +1125,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.21/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1105,7 +1152,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1137,7 +1184,7 @@ EXAMPLES
   $ qfg sdk-key create --environment staging --type browser
 ```
 
-_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1166,7 +1213,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1193,7 +1240,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.0.21/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1264,7 +1311,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -1341,7 +1388,7 @@ EXAMPLES
   $ qfg set-rollout my.variant.flag --environment production --weights "a:33,b:33,c:34" --hash-by user.id
 ```
 
-_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -1373,7 +1420,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -1475,7 +1522,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -1498,7 +1545,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -1521,7 +1568,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -1554,7 +1601,7 @@ EXAMPLES
   $ qfg workspace bootstrap --dir ./our-config --skip-validate
 ```
 
-_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace create SLUG`
 
@@ -1588,7 +1635,7 @@ EXAMPLES
   $ qfg workspace create my-team --org 11111111-1111-1111-1111-111111111111
 ```
 
-_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/workspace/create.ts)_
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -1616,7 +1663,7 @@ EXAMPLES
   $ qfg workspace switch my-workspace-slug
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.21/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.23/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/commands/delete.d.ts

@@ -0,0 +1,13 @@
+import { APICommand } from '../index.js';
+import type { JsonObj } from '../result.js';
+export default class Delete extends APICommand {
+    static args: {
+        name: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        yes: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<JsonObj | void>;
+}

package/dist/commands/delete.js

@@ -0,0 +1,114 @@
+import { Args, Flags } from '@oclif/core';
+import { APICommand } from '../index.js';
+import { confirmTypedSlug } from '../push/confirm.js';
+import isInteractive from '../util/is-interactive.js';
+import { checkmark } from '../util/color.js';
+import { loadTokens } from '../util/token-storage.js';
+const DELETE_ROUTES = {
+    config: { endpoint: '/api/v1/configs/delete', keyField: 'configKey' },
+    feature_flag: { endpoint: '/api/v1/flags/delete', keyField: 'flagKey' },
+    log_level: { endpoint: '/api/v1/logLevels/delete', keyField: 'logLevelKey' },
+};
+/**
+ * Parse the fresh SHA out of a 409 conflict message of the form
+ *   "<path> was modified (expected <oldSha>, got <newSha>)"
+ */
+function parseFreshShaFromConflict(message) {
+    if (!message)
+        return undefined;
+    const match = message.match(/got\s+([\w.-]+)\)/);
+    return match?.[1];
+}
+export default class Delete extends APICommand {
+    static args = {
+        name: Args.string({ description: 'flag/config/log-level key to delete', required: true }),
+    };
+    static description = `Delete a flag, config, or log-level from the workspace.
+
+DESTRUCTIVE — removes the underlying JSON file from the workspace git repo
+and commits with the actor's identity. The commit history preserves the
+prior content; this is a hard-delete on the file but a soft-delete on
+history.
+
+Confirmation is required:
+  --yes                       skip the prompt (for scripts and CI)
+  interactive (default)       you'll be asked to type the key name back
+
+Examples
+  qfg delete my.flag --yes
+  qfg delete my.flag                          # interactive: type the key back to confirm
+  qfg delete my.config --yes`;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> my.flag --yes',
+        '<%= config.bin %> <%= command.id %> my.config --yes',
+    ];
+    static flags = {
+        yes: Flags.boolean({ default: false, description: 'skip confirmation prompt' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Delete);
+        const tokens = await loadTokens();
+        if (!tokens?.accessToken) {
+            return this.err('Not logged in. Run `qfg login` first.');
+        }
+        const key = args.name;
+        const metaRes = await this.apiClient.post('/api/v1/metadata/list', { workspaceId: this.workspaceId });
+        if (!metaRes.ok) {
+            return this.err(`Failed to look up ${key}: ${metaRes.status} ${JSON.stringify(metaRes.error)}`);
+        }
+        const items = metaRes.json?.configs ?? [];
+        const item = items.find((i) => i.key === key);
+        if (!item) {
+            return this.err(`${key} not found in this workspace.`);
+        }
+        const route = DELETE_ROUTES[item.type];
+        if (!route) {
+            return this.err(`Cannot delete ${key}: unsupported type "${item.type}". Supported: flag, config, log-level.`);
+        }
+        if (!flags.yes) {
+            if (!isInteractive(flags)) {
+                return this.err(`Refusing to delete ${key} without confirmation. Pass --yes or run interactively.`);
+            }
+            this.log(`About to delete ${item.type.replaceAll('_', ' ')}: ${key}`);
+            this.log('This rewrites the workspace repo and is destructive.');
+            const confirmed = await confirmTypedSlug(key, `Type "${key}" to confirm: `);
+            if (!confirmed) {
+                return this.err(`Aborted: ${key} was not typed back exactly. No changes made.`);
+            }
+        }
+        let expectedCommitSha = item.version;
+        let attempt = 0;
+        while (attempt < 2) {
+            attempt += 1;
+            const payload = {
+                workspaceId: this.workspaceId,
+                [route.keyField]: key,
+                ...(expectedCommitSha ? { expectedCommitSha } : {}),
+            };
+            this.verboseLog(`RPC ${route.endpoint}`, payload);
+            // eslint-disable-next-line no-await-in-loop
+            const res = await this.apiClient.post(route.endpoint, payload);
+            if (res.ok) {
+                const commitSha = res.json?.commitSha;
+                const shaSuffix = commitSha ? ` (commit ${commitSha})` : '';
+                return this.ok(`${checkmark} Deleted ${item.type.replaceAll('_', ' ')}: ${key}${shaSuffix}`, {
+                    key,
+                    type: item.type,
+                    ...(commitSha ? { commitSha } : {}),
+                });
+            }
+            if (res.status === 404) {
+                return this.err(`${key} not found on the server (it may have been deleted by someone else).`);
+            }
+            if (res.status === 409 && attempt === 1) {
+                const fresh = parseFreshShaFromConflict(res.error?.message);
+                if (fresh) {
+                    this.verboseLog(`Stale SHA — retrying delete with fresh SHA ${fresh}`);
+                    expectedCommitSha = fresh;
+                    continue;
+                }
+            }
+            return this.err(`Failed to delete ${key}: ${res.status} ${JSON.stringify(res.error)}`);
+        }
+    }
+}

package/dist/commands/pull.js

@@ -186,9 +186,9 @@ CLI shortcuts (no JSON editing needed for simple cases):
     async maybeWriteQuonfigDir(dir) {
         if (process.env.QUONFIG_DIR)
             return; // already set via env
-        const os = await import('node:os');
         const pathMod = await import('node:path');
-        const configFilePath = pathMod.join(os.homedir(), '.quonfig', 'config');
+        const { getQuonfigConfigHome } = await import('../util/quonfig-home.js');
+        const configFilePath = pathMod.join(getQuonfigConfigHome(), 'config');
         try {
             const existing = await fs.promises.readFile(configFilePath, 'utf8').catch(() => '');
             if (existing.includes('QUONFIG_DIR') || existing.includes('quonfig_dir'))

package/dist/commands/push.d.ts

@@ -1,8 +1,7 @@
 import type { JsonObj } from '../result.js';
 import { BaseCommand } from '../index.js';
 import { GiteaTokenResponse } from '../util/gitea-api.js';
-import type { GiteaTokenMintResult } from '../push/run-push.js';
-import { runPush } from '../push/run-push.js';
+import { runPush, type GiteaTokenMintResult } from '../push/run-push.js';
 export default class Push extends BaseCommand {
     static description: string;
     static examples: string[];
@@ -34,20 +33,13 @@ export declare function giteaResponseToMintResult(resp: GiteaTokenResponse): Git
  *
  * Returns a `{deps, cleanup}` pair. The caller MUST call `cleanup()` in a
  * finally block so the bare-path probe clone is removed even on errors.
+ *
+ * As of qfg-azk.13 the push code path no longer mints a write-scoped Gitea
+ * token; the actual commit is performed server-side by the `configs.push`
+ * oRPC procedure. We still mint a READ token to authenticate the bare-path
+ * probe-clone and the clone-path `git fetch`.
  */
 export declare function buildRealDeps(cmd: Push): {
     deps: Parameters<typeof runPush>[1];
     cleanup: () => Promise<void>;
 };
-/**
- * Copy the contents of `sourceDir` into `destDir`, skipping `.git/` and any
- * temp push-clone scratch directories. Used as the `applyDelta` callback for
- * bare-path pushes — we mirror local files into a fresh clone so that
- * `cloneAndStackPush`'s `git add --all` + diff will reflect the union of
- * (deletes, modifies, adds) we intend.
- *
- * IMPORTANT: this deletes files in destDir that are not in sourceDir so that
- * deletions make it into the push. Without this the clone-and-stack produces
- * an "adds-only" delta and destructive heuristics would never fire in the UI.
- */
-export declare function copyDirMirror(sourceDir: string, destDir: string): Promise<void>;