workos 0.19.0 → 0.20.2

package/dist/utils/exec-file.js

@@ -1,39 +0,0 @@
-import { spawn } from 'node:child_process';
-import { SPAWN_OPTS } from './platform.js';
-/**
- * Execute a command without throwing on non-zero exit codes.
- * Returns { status, stdout, stderr } for all outcomes.
- */
-export function execFileNoThrow(command, args, options = {}) {
-    return new Promise((resolve) => {
-        const child = spawn(command, args, {
-            cwd: options.cwd,
-            env: options.env ?? process.env,
-            timeout: options.timeout,
-            ...SPAWN_OPTS,
-        });
-        let stdout = '';
-        let stderr = '';
-        child.stdout?.on('data', (data) => {
-            stdout += data.toString();
-        });
-        child.stderr?.on('data', (data) => {
-            stderr += data.toString();
-        });
-        child.on('close', (code) => {
-            resolve({
-                status: code ?? 1,
-                stdout,
-                stderr,
-            });
-        });
-        child.on('error', (err) => {
-            resolve({
-                status: 1,
-                stdout,
-                stderr: err.message,
-            });
-        });
-    });
-}
-//# sourceMappingURL=exec-file.js.map

package/dist/utils/exec-file.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"exec-file.js","sourceRoot":"","sources":["../../src/utils/exec-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAc3C;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,IAAc,EAAE,UAAuB,EAAE;IACxF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG;YAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,UAAU;SACd,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAChC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAChC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,OAAO,CAAC;gBACN,MAAM,EAAE,IAAI,IAAI,CAAC;gBACjB,MAAM;gBACN,MAAM;aACP,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC;gBACN,MAAM,EAAE,CAAC;gBACT,MAAM;gBACN,MAAM,EAAE,GAAG,CAAC,OAAO;aACpB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { spawn } from 'node:child_process';\nimport { SPAWN_OPTS } from './platform.js';\n\nexport interface ExecResult {\n  status: number;\n  stdout: string;\n  stderr: string;\n}\n\nexport interface ExecOptions {\n  cwd?: string;\n  timeout?: number;\n  env?: NodeJS.ProcessEnv;\n}\n\n/**\n * Execute a command without throwing on non-zero exit codes.\n * Returns { status, stdout, stderr } for all outcomes.\n */\nexport function execFileNoThrow(command: string, args: string[], options: ExecOptions = {}): Promise<ExecResult> {\n  return new Promise((resolve) => {\n    const child = spawn(command, args, {\n      cwd: options.cwd,\n      env: options.env ?? process.env,\n      timeout: options.timeout,\n      ...SPAWN_OPTS,\n    });\n\n    let stdout = '';\n    let stderr = '';\n\n    child.stdout?.on('data', (data) => {\n      stdout += data.toString();\n    });\n\n    child.stderr?.on('data', (data) => {\n      stderr += data.toString();\n    });\n\n    child.on('close', (code) => {\n      resolve({\n        status: code ?? 1,\n        stdout,\n        stderr,\n      });\n    });\n\n    child.on('error', (err) => {\n      resolve({\n        status: 1,\n        stdout,\n        stderr: err.message,\n      });\n    });\n  });\n}\n"]}

package/dist/utils/exit-codes.d.ts

@@ -1,31 +0,0 @@
-/**
- * Standardized exit codes following gh CLI convention.
- *
- * 0 = Success
- * 1 = General error
- * 2 = Cancelled (e.g., Ctrl+C, user cancelled prompt)
- * 4 = Authentication required
- */
-import { type StructuredError } from './output.js';
-import type { TerminationReason } from './telemetry-types.js';
-export declare const ExitCode: {
-    readonly SUCCESS: 0;
-    readonly GENERAL_ERROR: 1;
-    readonly CANCELLED: 2;
-    readonly AUTH_REQUIRED: 4;
-};
-export type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];
-export declare function resolveErrorCode(code: string): {
-    reason: TerminationReason;
-    exit: ExitCodeValue;
-};
-/** Exit with a specific code, optionally writing a structured error first. */
-export declare function exitWithCode(code: ExitCodeValue, error?: StructuredError): never;
-/**
- * Convenience: exit with code 4 and auth-required error.
- *
- * Recovery hints are inferred from interaction mode unless explicitly provided.
- */
-export declare function exitWithAuthRequired(message?: string, options?: {
-    recovery?: StructuredError['recovery'];
-}): never;

package/dist/utils/exit-codes.js

@@ -1,69 +0,0 @@
-/**
- * Standardized exit codes following gh CLI convention.
- *
- * 0 = Success
- * 1 = General error
- * 2 = Cancelled (e.g., Ctrl+C, user cancelled prompt)
- * 4 = Authentication required
- */
-import { CliExit } from './cli-exit.js';
-import { outputError } from './output.js';
-import { formatWorkOSCommand } from './command-invocation.js';
-import { authLoginRecovery } from './recovery-hints.js';
-import { getInteractionMode } from './interaction-mode.js';
-export const ExitCode = {
-    SUCCESS: 0,
-    GENERAL_ERROR: 1,
-    CANCELLED: 2,
-    AUTH_REQUIRED: 4,
-};
-const ERROR_CODE_MAP = {
-    auth_required: { reason: 'auth_required', exit: ExitCode.AUTH_REQUIRED },
-    // resolveApiKey() emits `no_api_key` when no key is configured; semantically
-    // an auth failure, so it must not fall through to `validation_error`.
-    no_api_key: { reason: 'auth_required', exit: ExitCode.AUTH_REQUIRED },
-    cancelled: { reason: 'cancelled', exit: ExitCode.CANCELLED },
-};
-export function resolveErrorCode(code) {
-    const mapped = ERROR_CODE_MAP[code];
-    if (mapped)
-        return mapped;
-    if (code.startsWith('http_')) {
-        return { reason: 'api_error', exit: ExitCode.GENERAL_ERROR };
-    }
-    return { reason: 'validation_error', exit: ExitCode.GENERAL_ERROR };
-}
-function reasonForExitCode(code) {
-    if (code === ExitCode.AUTH_REQUIRED)
-        return 'auth_required';
-    if (code === ExitCode.CANCELLED)
-        return 'cancelled';
-    if (code === ExitCode.SUCCESS)
-        return 'success';
-    return 'validation_error';
-}
-/** Exit with a specific code, optionally writing a structured error first. */
-export function exitWithCode(code, error) {
-    if (error) {
-        outputError(error);
-    }
-    throw new CliExit(code, {
-        reason: reasonForExitCode(code),
-        errorCode: error?.code,
-    });
-}
-/**
- * Convenience: exit with code 4 and auth-required error.
- *
- * Recovery hints are inferred from interaction mode unless explicitly provided.
- */
-export function exitWithAuthRequired(message, options) {
-    const mode = getInteractionMode().mode;
-    exitWithCode(ExitCode.AUTH_REQUIRED, {
-        code: 'auth_required',
-        message: message ??
-            `Not authenticated. Run \`${formatWorkOSCommand('auth login')}\` in an interactive terminal, or set WORKOS_API_KEY.`,
-        recovery: options?.recovery ?? authLoginRecovery({ mode }),
-    });
-}
-//# sourceMappingURL=exit-codes.js.map

package/dist/utils/exit-codes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/utils/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAwB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,SAAS,EAAE,CAAC;IACZ,aAAa,EAAE,CAAC;CACR,CAAC;AAIX,MAAM,cAAc,GAAuE;IACzF,aAAa,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,aAAa,EAAE;IACxE,6EAA6E;IAC7E,sEAAsE;IACtE,UAAU,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,aAAa,EAAE;IACrE,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE;CAC7D,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAI3C,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAmB;IAC5C,IAAI,IAAI,KAAK,QAAQ,CAAC,aAAa;QAAE,OAAO,eAAe,CAAC;IAC5D,IAAI,IAAI,KAAK,QAAQ,CAAC,SAAS;QAAE,OAAO,WAAW,CAAC;IACpD,IAAI,IAAI,KAAK,QAAQ,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,IAAmB,EAAE,KAAuB;IACvE,IAAI,KAAK,EAAE,CAAC;QACV,WAAW,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC;QAC/B,SAAS,EAAE,KAAK,EAAE,IAAI;KACvB,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,OAAoD;IACzG,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC,IAAI,CAAC;IACvC,YAAY,CAAC,QAAQ,CAAC,aAAa,EAAE;QACnC,IAAI,EAAE,eAAe;QACrB,OAAO,EACL,OAAO;YACP,4BAA4B,mBAAmB,CAAC,YAAY,CAAC,uDAAuD;QACtH,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC;KAC3D,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Standardized exit codes following gh CLI convention.\n *\n * 0 = Success\n * 1 = General error\n * 2 = Cancelled (e.g., Ctrl+C, user cancelled prompt)\n * 4 = Authentication required\n */\n\nimport { CliExit } from './cli-exit.js';\nimport { outputError, type StructuredError } from './output.js';\nimport { formatWorkOSCommand } from './command-invocation.js';\nimport { authLoginRecovery } from './recovery-hints.js';\nimport { getInteractionMode } from './interaction-mode.js';\nimport type { TerminationReason } from './telemetry-types.js';\n\nexport const ExitCode = {\n  SUCCESS: 0,\n  GENERAL_ERROR: 1,\n  CANCELLED: 2,\n  AUTH_REQUIRED: 4,\n} as const;\n\nexport type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];\n\nconst ERROR_CODE_MAP: Record<string, { reason: TerminationReason; exit: ExitCodeValue }> = {\n  auth_required: { reason: 'auth_required', exit: ExitCode.AUTH_REQUIRED },\n  // resolveApiKey() emits `no_api_key` when no key is configured; semantically\n  // an auth failure, so it must not fall through to `validation_error`.\n  no_api_key: { reason: 'auth_required', exit: ExitCode.AUTH_REQUIRED },\n  cancelled: { reason: 'cancelled', exit: ExitCode.CANCELLED },\n};\n\nexport function resolveErrorCode(code: string): {\n  reason: TerminationReason;\n  exit: ExitCodeValue;\n} {\n  const mapped = ERROR_CODE_MAP[code];\n  if (mapped) return mapped;\n  if (code.startsWith('http_')) {\n    return { reason: 'api_error', exit: ExitCode.GENERAL_ERROR };\n  }\n  return { reason: 'validation_error', exit: ExitCode.GENERAL_ERROR };\n}\n\nfunction reasonForExitCode(code: ExitCodeValue): TerminationReason {\n  if (code === ExitCode.AUTH_REQUIRED) return 'auth_required';\n  if (code === ExitCode.CANCELLED) return 'cancelled';\n  if (code === ExitCode.SUCCESS) return 'success';\n  return 'validation_error';\n}\n\n/** Exit with a specific code, optionally writing a structured error first. */\nexport function exitWithCode(code: ExitCodeValue, error?: StructuredError): never {\n  if (error) {\n    outputError(error);\n  }\n  throw new CliExit(code, {\n    reason: reasonForExitCode(code),\n    errorCode: error?.code,\n  });\n}\n\n/**\n * Convenience: exit with code 4 and auth-required error.\n *\n * Recovery hints are inferred from interaction mode unless explicitly provided.\n */\nexport function exitWithAuthRequired(message?: string, options?: { recovery?: StructuredError['recovery'] }): never {\n  const mode = getInteractionMode().mode;\n  exitWithCode(ExitCode.AUTH_REQUIRED, {\n    code: 'auth_required',\n    message:\n      message ??\n      `Not authenticated. Run \\`${formatWorkOSCommand('auth login')}\\` in an interactive terminal, or set WORKOS_API_KEY.`,\n    recovery: options?.recovery ?? authLoginRecovery({ mode }),\n  });\n}\n"]}

package/dist/utils/git-utils.d.ts

@@ -1,23 +0,0 @@
-/**
- * Get the current git branch name.
- * Returns null if not in a git repo or if the command fails.
- */
-export declare function getCurrentBranch(): string | null;
-/**
- * Check if a branch name is considered protected (main, master, develop).
- */
-export declare function isProtectedBranch(branch: string): boolean;
-export declare function createBranch(name: string): void;
-export declare function branchExists(name: string): boolean;
-/**
- * Get the default branch from origin, falling back to main/master detection.
- */
-export declare function getDefaultBranch(): string;
-/**
- * Check if the GitHub CLI (gh) is available.
- */
-export declare function hasGhCli(): boolean;
-/**
- * Get list of uncommitted/untracked files from git status.
- */
-export declare function getUncommittedFiles(): string[];

package/dist/utils/git-utils.js

@@ -1,86 +0,0 @@
-import { execSync, execFileSync } from 'node:child_process';
-const PROTECTED_BRANCHES = ['main', 'master', 'develop'];
-/**
- * Get the current git branch name.
- * Returns null if not in a git repo or if the command fails.
- */
-export function getCurrentBranch() {
-    try {
-        return execSync('git rev-parse --abbrev-ref HEAD', {
-            stdio: ['ignore', 'pipe', 'ignore'],
-        })
-            .toString()
-            .trim();
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Check if a branch name is considered protected (main, master, develop).
- */
-export function isProtectedBranch(branch) {
-    return PROTECTED_BRANCHES.includes(branch);
-}
-export function createBranch(name) {
-    execFileSync('git', ['checkout', '-b', name], { stdio: 'ignore' });
-}
-export function branchExists(name) {
-    try {
-        execFileSync('git', ['rev-parse', '--verify', name], { stdio: 'ignore' });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Get the default branch from origin, falling back to main/master detection.
- */
-export function getDefaultBranch() {
-    try {
-        const ref = execSync('git symbolic-ref refs/remotes/origin/HEAD', {
-            stdio: ['ignore', 'pipe', 'ignore'],
-        })
-            .toString()
-            .trim();
-        return ref.replace('refs/remotes/origin/', '');
-    }
-    catch {
-        if (branchExists('main'))
-            return 'main';
-        if (branchExists('master'))
-            return 'master';
-        return 'main';
-    }
-}
-/**
- * Check if the GitHub CLI (gh) is available.
- */
-export function hasGhCli() {
-    try {
-        execSync('gh --version', { stdio: 'ignore' });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Get list of uncommitted/untracked files from git status.
- */
-export function getUncommittedFiles() {
-    try {
-        const status = execSync('git status --porcelain', {
-            stdio: ['ignore', 'pipe', 'ignore'],
-        }).toString();
-        return status
-            .split('\n')
-            .filter(Boolean)
-            .map((line) => line.slice(3));
-    }
-    catch {
-        return [];
-    }
-}
-//# sourceMappingURL=git-utils.js.map

package/dist/utils/git-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"git-utils.js","sourceRoot":"","sources":["../../src/utils/git-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,iCAAiC,EAAE;YACjD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC;aACC,QAAQ,EAAE;aACV,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,YAAY,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,2CAA2C,EAAE;YAChE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC;aACC,QAAQ,EAAE;aACV,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACxC,IAAI,YAAY,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,IAAI,CAAC;QACH,QAAQ,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,EAAE;YAChD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,MAAM;aACV,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC","sourcesContent":["import { execSync, execFileSync } from 'node:child_process';\n\nconst PROTECTED_BRANCHES = ['main', 'master', 'develop'];\n\n/**\n * Get the current git branch name.\n * Returns null if not in a git repo or if the command fails.\n */\nexport function getCurrentBranch(): string | null {\n  try {\n    return execSync('git rev-parse --abbrev-ref HEAD', {\n      stdio: ['ignore', 'pipe', 'ignore'],\n    })\n      .toString()\n      .trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Check if a branch name is considered protected (main, master, develop).\n */\nexport function isProtectedBranch(branch: string): boolean {\n  return PROTECTED_BRANCHES.includes(branch);\n}\n\nexport function createBranch(name: string): void {\n  execFileSync('git', ['checkout', '-b', name], { stdio: 'ignore' });\n}\n\nexport function branchExists(name: string): boolean {\n  try {\n    execFileSync('git', ['rev-parse', '--verify', name], { stdio: 'ignore' });\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Get the default branch from origin, falling back to main/master detection.\n */\nexport function getDefaultBranch(): string {\n  try {\n    const ref = execSync('git symbolic-ref refs/remotes/origin/HEAD', {\n      stdio: ['ignore', 'pipe', 'ignore'],\n    })\n      .toString()\n      .trim();\n    return ref.replace('refs/remotes/origin/', '');\n  } catch {\n    if (branchExists('main')) return 'main';\n    if (branchExists('master')) return 'master';\n    return 'main';\n  }\n}\n\n/**\n * Check if the GitHub CLI (gh) is available.\n */\nexport function hasGhCli(): boolean {\n  try {\n    execSync('gh --version', { stdio: 'ignore' });\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Get list of uncommitted/untracked files from git status.\n */\nexport function getUncommittedFiles(): string[] {\n  try {\n    const status = execSync('git status --porcelain', {\n      stdio: ['ignore', 'pipe', 'ignore'],\n    }).toString();\n    return status\n      .split('\\n')\n      .filter(Boolean)\n      .map((line) => line.slice(3));\n  } catch {\n    return [];\n  }\n}\n"]}

package/dist/utils/help-json.d.ts

@@ -1,58 +0,0 @@
-/**
- * Agent-discoverable help: machine-readable command tree for --help --json.
- *
- * Static command registry mirroring bin.ts yargs definitions.
- * yargs v18 doesn't expose public APIs for command introspection,
- * so we maintain a parallel typed registry.
- */
-export interface OptionSchema {
-    name: string;
-    type: 'string' | 'boolean' | 'number' | 'array';
-    description: string;
-    required: boolean;
-    default?: unknown;
-    alias?: string;
-    choices?: string[];
-    hidden: boolean;
-}
-export interface PositionalSchema {
-    name: string;
-    type: string;
-    description: string;
-    required: boolean;
-}
-export interface CommandSchema {
-    name: string;
-    description: string;
-    commands?: CommandSchema[];
-    options?: OptionSchema[];
-    positionals?: PositionalSchema[];
-    examples?: string[];
-}
-export interface HelpOutput {
-    name: string;
-    version: string;
-    description: string;
-    commands: CommandSchema[];
-    options: OptionSchema[];
-}
-/**
- * Extract the requested command from raw argv before yargs parses --help.
- *
- * This intentionally matches only known command names so option values from
- * global flags like `--mode agent` are not mistaken for commands.
- */
-export declare function extractHelpJsonCommand(argv: string[]): string | undefined;
-/**
- * Build a machine-readable command tree for --help --json output.
- *
- * @param subcommand - Optional command name to return a subtree for (e.g. "env").
- *                     Returns full tree if omitted or if command not found.
- */
-/**
- * Top-level command names (first token of each registered command). Used by
- * telemetry to recognise real commands without trusting arbitrary argv tokens
- * (so option values / secrets are never recorded as a command name).
- */
-export declare function getTopLevelCommandNames(): string[];
-export declare function buildCommandTree(subcommand?: string): HelpOutput | CommandSchema;