@camaradesuk/git-worktree-tools 1.9.0 → 1.11.0

package/dist/lib/deprecation.js

@@ -0,0 +1,28 @@
+/**
+ * Shared deprecation notice utility
+ *
+ * Prints a stderr deprecation warning for legacy CLI commands.
+ * Respects JSON mode and suppression env var.
+ */
+/**
+ * Print a deprecation notice to stderr.
+ *
+ * Skips output when:
+ * - GWT_NO_DEPRECATION_WARNINGS=1 is set
+ * - --json flag is present in process.argv (avoids corrupting structured output)
+ *
+ * @param oldCommand - The deprecated command name (e.g., 'lswt')
+ * @param newCommand - The replacement command (e.g., 'wt list')
+ */
+export function printDeprecationNotice(oldCommand, newCommand) {
+    // Skip in JSON mode to avoid corrupting structured output
+    if (process.argv.includes('--json'))
+        return;
+    // Allow suppression via environment variable
+    if (process.env.GWT_NO_DEPRECATION_WARNINGS === '1')
+        return;
+    process.stderr.write(`\x1b[33m[DEPRECATED]\x1b[0m "${oldCommand}" is deprecated. Use "${newCommand}" instead.\n` +
+        `This command will be removed in a future version.\n` +
+        `Set GWT_NO_DEPRECATION_WARNINGS=1 to suppress this notice.\n\n`);
+}
+//# sourceMappingURL=deprecation.js.map

package/dist/lib/deprecation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation.js","sourceRoot":"","sources":["../../src/lib/deprecation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,UAAkB;IAC3E,0DAA0D;IAC1D,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO;IAE5C,6CAA6C;IAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,GAAG;QAAE,OAAO;IAE5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gCAAgC,UAAU,yBAAyB,UAAU,cAAc;QACzF,qDAAqD;QACrD,gEAAgE,CACnE,CAAC;AACJ,CAAC"}

package/dist/lib/logger.d.ts

@@ -1,175 +1,60 @@
 /**
  * Logging system for git-worktree-tools
  *
- * Provides a singleton logger with:
- * - Multiple log levels (silent, error, warn, info, debug, trace)
- * - Console and file output support
- * - Log file rotation
- * - Timestamps and context
- * - Color support for console output
+ * Consola-based singleton logger with:
+ * - AuditFileReporter: persistent audit log with size-based rotation
+ * - ConditionalStderrReporter: verbose/quiet aware stderr output
+ * - Audit session tracking (command, cwd, branch, exit code, duration)
+ * - DEBUG=newpr deprecation handling
  *
  * Configuration sources (in order of priority):
- * 1. CLI flags (--verbose, --debug, --log-file)
- * 2. Environment variables (GWT_LOG_LEVEL, GWT_LOG_FILE)
- * 3. Config files (logLevel, logFile properties)
+ * 1. CLI flags (--verbose, --quiet, --no-color)
+ * 2. Environment variables (GWT_LOG_LEVEL, DEBUG)
+ * 3. Default (INFO)
  */
 import { LogLevel } from './constants.js';
 export { LogLevel };
+/** Audit session context for the process exit handler */
+declare let auditContext: {
+    command?: string;
+    startTime?: number;
+    cwd?: string;
+    gitBranch?: string;
+    worktreePath?: string;
+    prNumber?: number;
+    exitCode?: number;
+};
 /**
- * Logger configuration options
+ * The singleton consola logger instance.
+ * Starts with empty reporters — call initializeLogger() to configure.
  */
-export interface LoggerConfig {
-    /** Log level threshold */
-    level?: LogLevel;
-    /** Path to log file (enables file logging) */
-    logFile?: string;
-    /** Whether to include timestamps in output */
-    timestamps?: boolean;
-    /** Whether to use colors in console output */
-    colors?: boolean;
-    /** Whether to also write to console when file logging is enabled */
-    consoleOutput?: boolean;
+export declare const logger: import("consola").ConsolaInstance;
+export interface LoggerOptions {
+    verbose?: boolean;
+    quiet?: boolean;
+    noColor?: boolean;
+    json?: boolean;
+    commandName?: string;
 }
 /**
- * Parse log level from string
- */
-export declare function parseLogLevel(value: string): LogLevel | undefined;
-/**
- * Singleton Logger class
+ * Configure the logger with CLI flags, env vars, and reporters.
+ * Must be called early in CLI startup. Safe to call multiple times
+ * (replaces reporters each time).
  */
-declare class Logger {
-    private static instance;
-    private level;
-    private logFile;
-    private fileStream;
-    private timestamps;
-    private colors;
-    private consoleOutput;
-    private context;
-    private initialized;
-    private constructor();
-    /**
-     * Get the singleton logger instance
-     */
-    static getInstance(): Logger;
-    /**
-     * Initialize the logger with configuration
-     * Should be called early in CLI startup
-     */
-    initialize(config?: LoggerConfig): void;
-    /**
-     * Set up file logging with rotation
-     */
-    private setupFileLogging;
-    /**
-     * Rotate log files
-     */
-    private rotateLogFiles;
-    /**
-     * Set the current context (e.g., command name)
-     */
-    setContext(context: string | null): void;
-    /**
-     * Set the log level
-     */
-    setLevel(level: LogLevel): void;
-    /**
-     * Get the current log level
-     */
-    getLevel(): LogLevel;
-    /**
-     * Check if a log level is enabled
-     */
-    isLevelEnabled(level: LogLevel): boolean;
-    /**
-     * Check if the logger is in debug mode
-     */
-    isDebug(): boolean;
-    /**
-     * Check if the logger is in trace mode
-     */
-    isTrace(): boolean;
-    /**
-     * Internal log method
-     */
-    private log;
-    /**
-     * Internal log method with explicit context (thread-safe for child loggers)
-     */
-    logWithContext(level: LogLevel, context: string | null, message: string, ...args: unknown[]): void;
-    /**
-     * Format message with arguments (simple substitution)
-     */
-    private formatMessage;
-    /**
-     * Log an error message
-     */
-    error(message: string, ...args: unknown[]): void;
-    /**
-     * Log a warning message
-     */
-    warn(message: string, ...args: unknown[]): void;
-    /**
-     * Log an info message
-     */
-    info(message: string, ...args: unknown[]): void;
-    /**
-     * Log a debug message
-     */
-    debug(message: string, ...args: unknown[]): void;
-    /**
-     * Log a trace message
-     */
-    trace(message: string, ...args: unknown[]): void;
-    /**
-     * Log an error with stack trace
-     */
-    errorWithStack(err: Error, message?: string): void;
-    /**
-     * Create a child logger with a specific context
-     */
-    child(context: string): ChildLogger;
-    /**
-     * Close the logger (flush file stream)
-     */
-    close(): Promise<void>;
-    /**
-     * Get the default log file path
-     */
-    static getDefaultLogFilePath(): string;
-    /**
-     * Reset the singleton instance (for testing)
-     */
-    static reset(): void;
-}
+export declare function initializeLogger(options?: LoggerOptions): void;
 /**
- * Child logger with a specific context
- * Uses logWithContext to avoid race conditions with concurrent logging
+ * Merge additional metadata into the audit context.
+ * Called from CLI handlers to add worktreePath, prNumber, etc.
  */
-declare class ChildLogger {
-    private parent;
-    private context;
-    constructor(parent: Logger, context: string);
-    error(message: string, ...args: unknown[]): void;
-    warn(message: string, ...args: unknown[]): void;
-    info(message: string, ...args: unknown[]): void;
-    debug(message: string, ...args: unknown[]): void;
-    trace(message: string, ...args: unknown[]): void;
-}
+export declare function setAuditContext(ctx: Partial<typeof auditContext>): void;
 /**
- * The singleton logger instance
+ * Parse a string log level name to its numeric consola equivalent.
+ * Returns undefined for unrecognized values.
  */
-export declare const logger: Logger;
+export declare function parseLogLevel(value: string): number | undefined;
 /**
- * Initialize the logger from CLI arguments and config
- * Call this early in CLI entry points
+ * Reset all module-level state for test isolation.
+ * Prefixed with _ to signal internal-only use.
  */
-export declare function initializeLogger(options: {
-    verbose?: boolean | number;
-    debug?: boolean;
-    logFile?: string;
-    quiet?: boolean;
-    configLogLevel?: LogLevel | string;
-    configLogFile?: string;
-}): void;
+export declare function _resetForTesting(): void;
 //# sourceMappingURL=logger.d.ts.map

package/dist/lib/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,EAAE,QAAQ,EAAsD,MAAM,gBAAgB,CAAC;AAG9F,OAAO,EAAE,QAAQ,EAAE,CAAC;AAYpB,yDAAyD;AACzD,QAAA,IAAI,YAAY,EAAE;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAqOP;;;GAGG;AACH,eAAO,MAAM,MAAM,mCAGjB,CAAC;AAMH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI,CAwGlE;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,YAAY,CAAC,GAAG,IAAI,CAEvE;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa/D;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAavC"}