@void.01/advanced-logger 0.5.0 → 0.6.0

package/ARCHITECTURE.md

@@ -28,6 +28,9 @@ src/
   ansi.ts         escape-code factory, color catalog, stripAnsi
   caller.ts       stack parsing: "caller" suffix and "[CHAIN]"
   sinks.ts        Sink interface, built-in sinks, file writing, retention, registry
+  cli.ts          the `advanced-logger` bin: run(args, dir, io) for init, backups, restore <n>
+  init.ts         config template (OPTIONS, FILE_OPTIONS), adding missing options to an existing file
+  configBackup.ts config file backups (newest 5), restore, the "Last modified by CLI" stamp
 test/
   logger.test.ts, logger.aggressive.test.ts   core behavior (vitest)
   colors.test.ts        fg/bg/ansi/callerColor matrix
@@ -38,6 +41,9 @@ test/
   multi-worker.test.ts  spawns real Playwright with 2 workers (fixtures/multi-worker/)
   table-files.test.ts   CSV/JSON table attachments: names, contents, redaction, retention
   palette.test.ts, redaction.test.ts   per-action colors; nested and free-text redaction
+  init.test.ts          template vs real defaults, adding missing options (object, function, CRLF, JSON)
+  configBackup.test.ts  backups kept, numbering, restore (incl. undo), stamp
+  cli.test.ts           every command, argument checks, stdout/stderr, exit codes
   sweep/                npm run sweep: manual check of every console visual and every file, with file checks
   *.spec.ts, playwright*.config.ts, global-setup.ts   Playwright e2e/demo specs
 dist/             tsc output (CommonJS, ES2022), gitignored, what npm publishes
@@ -52,6 +58,8 @@ Published entry points (`package.json` `exports`):
 | `@void.01/advanced-logger` | `dist/index.js` | `info/warn/error/debug`, `configure`, `defineConfig`, helpers |
 | `@void.01/advanced-logger/playwright` | `dist/playwright.js` | drop-in `test`/`expect` with logging fixture |
 
+Command (`package.json` `bin`): `advanced-logger` → `dist/cli.js`, run as `npx @void.01/advanced-logger <init | backups | restore n>` (§19).
+
 ## 3. Module dependency graph
 
 ```
@@ -64,8 +72,12 @@ config ──► configFile (runtime)      theme ──► config (runtime, read
 config ──► theme (type only)         configFile ──► config (types only)
 sinks ──► config, theme, ansi        caller ──► config (type only)
 playwright ──► config, core, sinks, logger
+cli ──► init ──► configBackup, configFile (CONFIG_FILE_NAMES)
+cli ──► configBackup
 ```
 
+The CLI modules are not imported by `index.ts` or `playwright.ts`, so loading the logger never loads them.
+
 Two potential cycles are deliberately broken with `import type`: `config.ts` imports only the *type* `LevelName` from `theme.ts`, and `configFile.ts` imports only *types* from `config.ts`. `theme.ts` imports `config()` at runtime (to read `fg`/`bg`). Do not add runtime imports in the other direction.
 
 ## 4. The call path (the most important flow)
@@ -323,10 +335,12 @@ Kinds are described by `pruneSpec(kind)`: folder, the names this logger owns, th
 13. `configure()` never throws on bad input, in either form; it warns and skips (or reverts). Only a config file fails loudly.
 14. New output options that change line format default to off, so existing console and file output stays byte-identical. The one exception is masking secrets (`redactText`, on since 0.4.0): leaking a secret by default is worse than changing a line.
 15. Free-text masking runs in `dispatch` before truncation and before any sink. Do not move it into a sink, or some outputs would hold the secret.
+16. A new config option needs an entry in `init.ts` `OPTIONS` (or `FILE_OPTIONS`) with its real default; `init.test.ts` fails otherwise, and checks the written default against `resetConfig()`.
+17. The CLI only ever adds to a user's config file (plus the stamp line), and backs it up before writing. It must not reformat or remove anything, and must not run on `npm install` (no install scripts: pnpm and Yarn block them, and they would write into user repos unasked).
 
 ## 17. Differences from the Java logger
 
-Dropped: custom themes, `setTheme`, width/arrow settings, file rotation and gzip archives. Changed: caller frames are excluded by path rather than method-name prefix. Added: secret redaction, JSONL sink, custom sinks, in-memory capture, Playwright fixture with attachment, per-worker files, config file, `fg`/`bg`, INFO truncation, file and run retention, console worker/test prefixes, per-action colors, nested and free-text redaction.
+Dropped: custom themes, `setTheme`, width/arrow settings, file rotation and gzip archives. Changed: caller frames are excluded by path rather than method-name prefix. Added: secret redaction, JSONL sink, custom sinks, in-memory capture, Playwright fixture with attachment, per-worker files, config file, `fg`/`bg`, INFO truncation, file and run retention, console worker/test prefixes, per-action colors, nested and free-text redaction, tree and table forms on every action, and the `init`/`backups`/`restore` command.
 
 ## 18. Testing map
 
@@ -335,7 +349,11 @@ Dropped: custom themes, `setTheme`, width/arrow settings, file rotation and gzip
 | Console/file output, levels, caller/chain, redaction, malformed input | `logger.test.ts`, `logger.aggressive.test.ts` |
 | fg/bg/ansi/callerColor combinations across all actions, env parsing | `colors.test.ts` |
 | Discovery order, forms, precedence, `VOID_LOG_CONFIG`, loud failures | `config-file.test.ts` |
-| Truncation text, WARN/DEBUG lines, hint by source | `truncate.test.ts` |
+| Truncation text, WARN/DEBUG lines, hint by source, per-file notice (partial/debug) vs per-log WARN (full-trace) | `truncate.test.ts` |
+| Every action's message / heading+fields (tree) / heading+rows (table) forms | `logger.test.ts` |
+| `init` template (vs real defaults), adding missing options, function/JSON/CRLF configs | `init.test.ts` |
+| Config backups: keep 5, numbering, restore and its undo, the "Last modified by CLI" stamp | `configBackup.test.ts` |
+| The `advanced-logger` command: each command, bad arguments, stdout/stderr, exit codes | `cli.test.ts` |
 | Retention by files and runs, protection of current and recent runs, missing run id, foreign files | `retention.test.ts` |
 | consoleWorker/consoleTest prefixes, missing-run-id warning, `configure()` patch and callback validation | `separable.test.ts` |
 | Per-action colors, palette contrast and distance limits | `palette.test.ts` (+ `helpers/color-metrics.ts`) |
@@ -346,3 +364,18 @@ Dropped: custom themes, `setTheme`, width/arrow settings, file rotation and gzip
 | Visual/e2e demos | `*.spec.ts` via `test/playwright.config.ts` |
 
 Tests use `resetConfig()` plus `configure({ logDir: tmp, ansi: false, tsFormat: () => 'TS' })` for deterministic output, and spy on `process.stdout.write`. Config-file tests `chdir` into a temp dir so no stray `logger.config.*` leaks in.
+
+## 19. The command: init, backups, restore (`cli.ts`, `init.ts`, `configBackup.ts`)
+
+`cli.ts` is the `bin`. `run(args, dir, io)` parses one command, writes through `io` (stdout for success, stderr for errors and bad arguments) and returns the exit code; the file only calls it when run directly (`require.main === module`), so tests import `run`. The package name in messages comes from `package.json`.
+
+**`init`** (`init(dir, pkg)`):
+
+- No config file in `dir` (`CONFIG_FILE_NAMES`): writes `template(pkg)`, stamped. The template is built from `OPTIONS` and `FILE_OPTIONS`: each option has `about`, `type`, `advanced`, and its default as `value` (or `raw` source text such as `[process.cwd()]`, or `detected` text for defaults worked out at runtime). `optionSection` writes the common options as `key: default,` under "---- Common options ----", then the advanced ones as `// key: default,` under "---- Advanced options ----". Each option line has a `// <about> Type: ... Default: ...` line above it.
+- A `.ts`/`.js`/`.cjs` config: `addMissing(text)` works on the text, not a parse tree, so formatting and comments survive. An option counts as present when `key:` appears at a line start or after `{`/`,`, commented out or not (`mentions`). Missing top-level options go before the file's last `}` (`insertBefore`, which adds a comma after the last property when needed, skipping trailing `//` comments via `codeOf`/`lastCodeChar`); missing `files` entries go right after `files: {`. If the code before the last `}` ends in `;`, the config is a function with a block body: everything missing is added as comments above the `export default`/`module.exports` line instead (`commentedOnly`). CRLF files are processed as LF and converted back.
+- A `.json` config (`initJson`): JSON has no comments, so the missing common options are added as default values (re-serialized with 2-space indent) and the advanced ones are only named in the message. Invalid JSON is refused (exit 1) and left as is.
+- Before any write to an existing file: `backupConfig(file)`. After: the stamp (below).
+
+**Backups** (`configBackup.ts`): `backupConfig` copies the file to `<dir>/.logger-config-backups/<yyyyMMdd-HHmmss-SSS>[-k]__<file name>` (`-k` when the name is taken within the same millisecond), writes a `.gitignore` (`*`) into the folder on first use, and deletes all but the newest `KEEP` (5). `listBackups` parses the names and sorts by time, then `k`, numbering 1 (oldest) to 5 (newest); other files in the folder are ignored. `restoreConfig(dir, n)` reads backup n **before** backing up the current file (that backup can push backup 1 out), then writes it back to the file name it came from.
+
+**Stamp**: `withStamp(text, by)` puts `// Last modified by CLI: <yyyy-MM-dd HH:mm:ss> (<by>)` on the first line, replacing an earlier one. `by` is `init` or `restore of backup n, saved <time>`. JSON files get none. Hand edits do not update it.

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to `@void.01/advanced-logger`. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses [Semantic Versioning](https://semver.org/). While the version is below 1.0.0, a minor release may add options but keeps existing defaults and output unchanged unless noted.
 
+## [0.6.0] - 2026-10-23
+
+Adds the `advanced-logger` command: a config file template, config backups and restore.
+
+### Added
+
+- **`npx @void.01/advanced-logger init`** writes a `logger.config.ts` with every option, each explained with its type and default: common options set to their default values, advanced ones commented out (the logger picks those, some detected at runtime), under "Common options" and "Advanced options" headings. With a config file already there, it adds only the options the file does not mention and changes nothing else. A function-style config gets them as comments; a JSON config gets the common ones as values.
+- **Config backups.** Before `init` or `restore` changes a config file, it is saved to `.logger-config-backups/` (newest 5 kept, git-ignored by a `.gitignore` inside). `npx @void.01/advanced-logger backups` lists them, 1 (oldest) to 5 (newest), and `restore <n>` puts one back after backing up the current file.
+- A config file changed by `init` or `restore` starts with `// Last modified by CLI: <date time> (<what>)`. JSON configs get no stamp (no comments).
+
 ## [0.5.0] - 2026-10-22
 
 Quieter truncation warnings in the trace files, full text in `debug-trace`, a tree or table form for every action, and shorter log file names. **Trace file names change** (`FT-...` instead of `full-trace-...`) and **`debug-trace` no longer truncates INFO logs**.
@@ -125,6 +135,7 @@ First release on npm. A self-contained TypeScript port of the VOID `core.logging
 - `initRun()` to share one run id across Playwright workers via `VOID_RUN_ID` / `VOID_RUN_DATE`.
 - Environment variables `VOID_LOG_LEVEL`, `VOID_LOG_DIR`, `VOID_LOG_ANSI`, `VOID_LOG_JSONL` and `VOID_RUN_ID`, and `configure()` for code.
 
+[0.6.0]: https://www.npmjs.com/package/@void.01/advanced-logger/v/0.6.0
 [0.5.0]: https://www.npmjs.com/package/@void.01/advanced-logger/v/0.5.0
 [0.4.1]: https://www.npmjs.com/package/@void.01/advanced-logger/v/0.4.1
 [0.4.0]: https://www.npmjs.com/package/@aryan-vashishth/advanced-logger/v/0.4.0

package/README.md

@@ -15,7 +15,7 @@ npm install @void.01/advanced-logger
 Pin an exact version if you want reproducible installs:
 
 ```bash
-npm install @void.01/advanced-logger@0.4.0
+npm install @void.01/advanced-logger@0.6.0
 ```
 
 Requirements:
@@ -25,6 +25,44 @@ Requirements:
 
 Check the installed version with `npm ls @void.01/advanced-logger`, and update with `npm update @void.01/advanced-logger`.
 
+### CLI cheat sheet
+
+Run these in the folder that holds (or should hold) `logger.config.*`, usually the project root.
+
+| I want to... | Run | What happens |
+|---|---|---|
+| Start a config file | `npx @void.01/advanced-logger init` | Creates `logger.config.ts`: common options at their defaults, advanced ones commented out |
+| Add options my config is missing (e.g. after upgrading) | `npx @void.01/advanced-logger init` | Backs the file up, then adds only what it does not mention. Prints the restore number |
+| See my config backups | `npx @void.01/advanced-logger backups` | Lists them, `1` (oldest) to `5` (newest), with times |
+| Undo the last `init` | `npx @void.01/advanced-logger restore <newest>` | Puts that version back (the number `init` printed, or the last one in `backups`) |
+| Go back to an older config | `npx @void.01/advanced-logger restore 2` | Backs up the current file, then restores backup 2 |
+| Undo a restore | `npx @void.01/advanced-logger restore 5` | The file a restore replaced is always the newest backup |
+| See the commands | `npx @void.01/advanced-logger --help` | Prints usage |
+
+- Exit code `0` on success, `1` on a bad command or number, a missing backup, or an invalid JSON config. Errors go to stderr.
+- Backups live in `.logger-config-backups/` next to the config (git-ignored, newest 5 kept).
+- Nothing runs on `npm install`; these only run when you call them.
+
+### Config file template and backups
+
+`init`, with no config file in the current folder, creates `logger.config.ts` with every option in two labelled sections:
+
+- **Common options** (`level`, `console`, `consoleWorker`, `consoleTest`, `infoLogsCharLimit`, `logDir`, `files`, `maxLogFiles`, `maxRuns`, `redactKeys`, `attach`), set to their default values, ready to change.
+- **Advanced options** (colors, timestamp format, stack filtering, `projectRoots`, ...), commented out as `// key: default,`. Left commented, the logger picks the default, including the ones it detects at runtime (`ansi`, `githubAnnotations`). Uncomment one to change it.
+
+Each option has a comment above it saying what it does, its type and its default.
+
+With a config file already there, `init` adds only the options it does not mention (a commented-out option counts as mentioned), in the same two sections, and changes nothing else. Run it again after upgrading to pick up new options.
+
+- A config written as a function with a `return` statement gets the missing options as comments above the export, since there is no object to put values in.
+- A `logger.config.json` gets the common options as default values. JSON has no comments, so the advanced ones are only listed; left out, they use their defaults.
+
+**Backups.** Before `init` or `restore` changes a config file, the current version is saved in `.logger-config-backups/` next to it, and the newest 5 are kept. The folder holds its own `.gitignore`, so backups are never committed. `restore <n>` backs up the current file first, so a restore can be undone with `restore 5`.
+
+**Stamp.** A `.ts` or `.js` config file that `init` or `restore` changed starts with `// Last modified by CLI: <date time> (init)` (or `(restore of backup 3, saved <date time>)`). Edits you make by hand do not update it.
+
+These commands run only when you call them, not on `npm install`. Install scripts are blocked by default in pnpm and Yarn and with `--ignore-scripts`, so a template written on install would appear for some users and not others.
+
 ### Entry points
 
 | Import | Use |

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+export declare const PKG: string;
+export declare const USAGE: string;
+export interface Io {
+    out(text: string): void;
+    err(text: string): void;
+}
+/** Runs one CLI command in `dir`. Returns the exit code. */
+export declare function run(args: string[], dir: string, io: Io): number;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,eAAO,MAAM,GAAG,QAAwD,CAAC;AAEzE,eAAO,MAAM,KAAK,QAM4E,CAAC;AAE/F,MAAM,WAAW,EAAE;IACjB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,4DAA4D;AAC5D,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,MAAM,CAoB/D"}

package/dist/cli.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USAGE = exports.PKG = void 0;
+exports.run = run;
+const configBackup_1 = require("./configBackup");
+const init_1 = require("./init");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+exports.PKG = require('../package.json').name;
+exports.USAGE = `Usage: npx ${exports.PKG} <command>
+
+  init         Create logger.config.ts in the current folder: common options set to their
+               defaults, advanced ones commented out. If a config file already exists, add
+               only the options it does not mention yet, after backing it up.
+  backups      List the config backups, 1 (oldest) to ${configBackup_1.KEEP} (newest).
+  restore <n>  Put backup n back. The current file is backed up first, so this can be undone.`;
+/** Runs one CLI command in `dir`. Returns the exit code. */
+function run(args, dir, io) {
+    const [command, ...rest] = args;
+    const done = (ok, message) => {
+        (ok ? io.out : io.err)(message + '\n');
+        return ok ? 0 : 1;
+    };
+    if (command === 'init' && rest.length === 0) {
+        const outcome = (0, init_1.init)(dir, exports.PKG);
+        const code = done(outcome.action !== 'refused', outcome.message);
+        if (outcome.action === 'created')
+            io.out('Next: call initRun() from your Playwright globalSetup, so all workers share one run id.\n');
+        return code;
+    }
+    if (command === 'backups' && rest.length === 0)
+        return done(true, (0, configBackup_1.formatBackups)(dir));
+    if (command === 'restore' && rest.length === 1 && /^\d+$/.test(rest[0])) {
+        const r = (0, configBackup_1.restoreConfig)(dir, Number(rest[0]));
+        return done(r.ok, r.message);
+    }
+    const help = command === undefined || command === '--help' || command === '-h';
+    return done(help, (help ? '' : `Unknown command: ${args.join(' ')}\n\n`) + exports.USAGE);
+}
+if (require.main === module) {
+    process.exitCode = run(process.argv.slice(2), process.cwd(), {
+        out: (t) => process.stdout.write(t),
+        err: (t) => process.stderr.write(t),
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;AAqBA,kBAoBC;AAxCD,iDAAoE;AACpE,iCAA8B;AAE9B,iEAAiE;AACpD,QAAA,GAAG,GAAI,OAAO,CAAC,iBAAiB,CAAsB,CAAC,IAAI,CAAC;AAE5D,QAAA,KAAK,GAAG,cAAc,WAAG;;;;;wDAKkB,mBAAI;8FACkC,CAAC;AAO/F,4DAA4D;AAC5D,SAAgB,GAAG,CAAC,IAAc,EAAE,GAAW,EAAE,EAAM;IACrD,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,EAAW,EAAE,OAAe,EAAU,EAAE;QACpD,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,IAAI,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,WAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,EAAE,CAAC,GAAG,CAAC,2FAA2F,CAAC,CAAC;QACtI,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,EAAE,IAAA,4BAAa,EAAC,GAAG,CAAC,CAAC,CAAC;IACtF,IAAI,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;QACzE,MAAM,CAAC,GAAG,IAAA,4BAAa,EAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC;IAC/E,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,aAAK,CAAC,CAAC;AACpF,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE;QAC3D,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;KACpC,CAAC,CAAC;AACL,CAAC"}

package/dist/configBackup.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Config file backups for the CLI: `init` saves the file before changing it, `restore <n>` puts one back (saving
+ * the current file first, so a restore can be undone too). The newest KEEP are kept, in BACKUP_DIR next to the
+ * config, named `<yyyyMMdd-HHmmss-SSS>[-<k>]__<config file name>` so they sort by time and say what they restore.
+ */
+export declare const BACKUP_DIR = ".logger-config-backups";
+export declare const KEEP = 5;
+export interface Backup {
+    /** 1 is the oldest, KEEP the newest. */
+    n: number;
+    file: string;
+    /** The config file it restores (`logger.config.ts`). */
+    target: string;
+    time: Date;
+}
+/** Oldest first, numbered from 1. Files in the folder that are not backups are ignored. */
+export declare function listBackups(dir: string): Backup[];
+/** Copies `configFile` into the backup folder, then drops the oldest beyond KEEP. Returns the backup's path. */
+export declare function backupConfig(configFile: string): string;
+export interface RestoreOutcome {
+    ok: boolean;
+    message: string;
+}
+/**
+ * Puts backup `n` (as numbered by listBackups before this call) back in place. The current file is backed up first,
+ * which may drop the oldest backup, so backup n is read before that.
+ */
+export declare function restoreConfig(dir: string, n: number): RestoreOutcome;
+/**
+ * The text with its first line saying when the CLI last changed it and how (`by`: "init", "restore of backup 2, ..."),
+ * replacing an earlier such line. Not for JSON, which has no comments. Edits made by hand do not update it, which
+ * is why the line says "by CLI".
+ */
+export declare function withStamp(text: string, by: string, now?: Date): string;
+export declare const describeTime: (d: Date) => string;
+/** The numbered list the `backups` command prints. */
+export declare function formatBackups(dir: string): string;
+//# sourceMappingURL=configBackup.d.ts.map

package/dist/configBackup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configBackup.d.ts","sourceRoot":"","sources":["../src/configBackup.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,UAAU,2BAA2B,CAAC;AACnD,eAAO,MAAM,IAAI,IAAI,CAAC;AAEtB,MAAM,WAAW,MAAM;IACrB,wCAAwC;IACxC,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;CACZ;AAQD,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBjD;AAED,gHAAgH;AAChH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,cAAc,CAkBpE;AAID;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,MAAM,CAI5E;AAED,eAAO,MAAM,YAAY,GAAI,GAAG,IAAI,KAAG,MAC+F,CAAC;AAEvI,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMjD"}

package/dist/configBackup.js

@@ -0,0 +1,139 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeTime = exports.KEEP = exports.BACKUP_DIR = void 0;
+exports.listBackups = listBackups;
+exports.backupConfig = backupConfig;
+exports.restoreConfig = restoreConfig;
+exports.withStamp = withStamp;
+exports.formatBackups = formatBackups;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * Config file backups for the CLI: `init` saves the file before changing it, `restore <n>` puts one back (saving
+ * the current file first, so a restore can be undone too). The newest KEEP are kept, in BACKUP_DIR next to the
+ * config, named `<yyyyMMdd-HHmmss-SSS>[-<k>]__<config file name>` so they sort by time and say what they restore.
+ */
+exports.BACKUP_DIR = '.logger-config-backups';
+exports.KEEP = 5;
+const NAME = /^(\d{4})(\d{2})(\d{2})-(\d{2})(\d{2})(\d{2})-(\d{3})(?:-(\d+))?__(.+)$/;
+const pad = (v, w = 2) => String(v).padStart(w, '0');
+const stampOf = (d) => `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}-${pad(d.getMilliseconds(), 3)}`;
+/** Oldest first, numbered from 1. Files in the folder that are not backups are ignored. */
+function listBackups(dir) {
+    const folder = path.join(dir, exports.BACKUP_DIR);
+    let names;
+    try {
+        names = fs.readdirSync(folder);
+    }
+    catch {
+        return [];
+    }
+    return names
+        .map((name) => ({ name, m: NAME.exec(name) }))
+        .filter((x) => x.m !== null)
+        .map(({ name, m }) => {
+        const [y, mo, d, h, mi, s, ms] = m.slice(1, 8).map(Number);
+        return { file: path.join(folder, name), target: m[9], time: new Date(y, mo - 1, d, h, mi, s, ms), seq: Number(m[8] ?? 0) };
+    })
+        .sort((a, b) => a.time.getTime() - b.time.getTime() || a.seq - b.seq)
+        .map(({ seq: _seq, ...b }, i) => ({ ...b, n: i + 1 }));
+}
+/** Copies `configFile` into the backup folder, then drops the oldest beyond KEEP. Returns the backup's path. */
+function backupConfig(configFile) {
+    const dir = path.dirname(configFile);
+    const folder = path.join(dir, exports.BACKUP_DIR);
+    fs.mkdirSync(folder, { recursive: true });
+    // The folder ignores itself, so backups never end up in a commit and the user's .gitignore is not touched.
+    const ignore = path.join(folder, '.gitignore');
+    if (!fs.existsSync(ignore))
+        fs.writeFileSync(ignore, '# Created by advanced-logger: config file backups, not for commits.\n*\n');
+    const stamp = stampOf(new Date());
+    const base = path.basename(configFile);
+    let file = path.join(folder, `${stamp}__${base}`);
+    for (let k = 1; fs.existsSync(file); k++)
+        file = path.join(folder, `${stamp}-${k}__${base}`);
+    fs.copyFileSync(configFile, file);
+    const all = listBackups(dir);
+    for (const old of all.slice(0, Math.max(0, all.length - exports.KEEP)))
+        fs.rmSync(old.file, { force: true });
+    return file;
+}
+/**
+ * Puts backup `n` (as numbered by listBackups before this call) back in place. The current file is backed up first,
+ * which may drop the oldest backup, so backup n is read before that.
+ */
+function restoreConfig(dir, n) {
+    const all = listBackups(dir);
+    if (all.length === 0)
+        return { ok: false, message: `No backups in ${path.join(dir, exports.BACKUP_DIR)}. init makes one each time it changes the config file.` };
+    const chosen = all.find((b) => b.n === n);
+    if (!Number.isInteger(n) || !chosen) {
+        return { ok: false, message: `There is no backup ${n}. Choose 1 (oldest) to ${all.length} (newest); run "backups" to see them.` };
+    }
+    const content = fs.readFileSync(chosen.file, 'utf8');
+    const target = path.join(dir, chosen.target);
+    const saved = fs.existsSync(target) ? backupConfig(target) : undefined;
+    const stamped = target.endsWith('.json') ? content : withStamp(content, `restore of backup ${n}, saved ${(0, exports.describeTime)(chosen.time)}`);
+    fs.writeFileSync(target, stamped);
+    return {
+        ok: true,
+        message: `Restored ${chosen.target} from backup ${n} (${(0, exports.describeTime)(chosen.time)}).` +
+            (saved ? ` The version it replaced is now the newest backup (${exports.KEEP} are kept).` : ''),
+    };
+}
+const STAMP = /^\/\/ Last modified by CLI: .*$/m;
+/**
+ * The text with its first line saying when the CLI last changed it and how (`by`: "init", "restore of backup 2, ..."),
+ * replacing an earlier such line. Not for JSON, which has no comments. Edits made by hand do not update it, which
+ * is why the line says "by CLI".
+ */
+function withStamp(text, by, now = new Date()) {
+    const eol = text.includes('\r\n') ? '\r\n' : '\n';
+    const line = `// Last modified by CLI: ${(0, exports.describeTime)(now)} (${by})`;
+    return STAMP.test(text) ? text.replace(STAMP, line) : line + eol + text;
+}
+const describeTime = (d) => `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+exports.describeTime = describeTime;
+/** The numbered list the `backups` command prints. */
+function formatBackups(dir) {
+    const all = listBackups(dir);
+    if (all.length === 0)
+        return `No backups in ${path.join(dir, exports.BACKUP_DIR)}.`;
+    return all
+        .map((b) => `  ${b.n}  ${(0, exports.describeTime)(b.time)}  ${b.target}${b.n === 1 ? '  (oldest)' : ''}${b.n === all.length && all.length > 1 ? '  (newest)' : ''}`)
+        .join('\n');
+}
+//# sourceMappingURL=configBackup.js.map

package/dist/configBackup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configBackup.js","sourceRoot":"","sources":["../src/configBackup.ts"],"names":[],"mappings":"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"}

package/dist/configFile.d.ts

@@ -13,6 +13,10 @@ export declare function loadConfigFile(env: NodeJS.ProcessEnv, cwd: string): Loa
 export declare const loadedConfigFile: () => string | undefined;
 /** Drop the cached module so the next load re-reads the file (tests, resetConfig). */
 export declare function forgetConfigFile(): void;
+/** Every config option: its check and how to describe a valid value. init.ts lists the same options (a test keeps them in step). */
+export declare const KEYS: Record<keyof LogConfigPatch, [check: (v: unknown) => boolean, expected: string]>;
+/** The entries `files` may have. */
+export declare const FILE_KEYS: string[];
 /**
  * Check a patch against KEYS. Every unknown key or wrong-typed value becomes a message naming `where`, and is left
  * out of the returned patch; undefined values are dropped. Shared by config files (which throw on the first problem)

package/dist/configFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configFile.d.ts","sourceRoot":"","sources":["../src/configFile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1D,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,8FAA+F,CAAC;AAE9H,KAAK,MAAM,GAAG,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,KAAK,cAAc,CAAC,CAAC;AAEvE,8GAA8G;AAC9G,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAczF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA4BtF;AAID,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,QAAO,MAAM,GAAG,SAAmB,CAAC;AAEjE,sFAAsF;AACtF,wBAAgB,gBAAgB,IAAI,IAAI,CASvC;AA0DD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CA8B7H"}
+{"version":3,"file":"configFile.d.ts","sourceRoot":"","sources":["../src/configFile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1D,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,8FAA+F,CAAC;AAE9H,KAAK,MAAM,GAAG,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,KAAK,cAAc,CAAC,CAAC;AAEvE,8GAA8G;AAC9G,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAczF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA4BtF;AAID,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,QAAO,MAAM,GAAG,SAAmB,CAAC;AAEjE,sFAAsF;AACtF,wBAAgB,gBAAgB,IAAI,IAAI,CASvC;AA2BD,oIAAoI;AACpI,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,cAAc,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CA2BjG,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,SAAS,UAAiE,CAAC;AAExF;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CA8B7H"}

package/dist/configFile.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadedConfigFile = exports.CONFIG_FILE_NAMES = void 0;
+exports.FILE_KEYS = exports.KEYS = exports.loadedConfigFile = exports.CONFIG_FILE_NAMES = void 0;
 exports.resolveConfigFile = resolveConfigFile;
 exports.loadConfigFile = loadConfigFile;
 exports.forgetConfigFile = forgetConfigFile;
@@ -127,7 +127,8 @@ const str = (v) => typeof v === 'string';
 const strList = (v) => (Array.isArray(v) || v instanceof Set) && [...v].every((x) => typeof x === 'string');
 const strArr = (v) => Array.isArray(v) && v.every((x) => typeof x === 'string');
 const oneOf = (...allowed) => (v) => typeof v === 'string' && allowed.includes(v);
-const KEYS = {
+/** Every config option: its check and how to describe a valid value. init.ts lists the same options (a test keeps them in step). */
+exports.KEYS = {
     level: [oneOf('debug', 'info', 'warn', 'error', 'off'), "one of 'debug' | 'info' | 'warn' | 'error' | 'off'"],
     ansi: [bool, 'a boolean'],
     fg: [bool, 'a boolean'],
@@ -155,16 +156,17 @@ const KEYS = {
     redactKeys: [strArr, 'an array of strings'],
     attach: [oneOf('on-failure', 'always', 'never'), "one of 'on-failure' | 'always' | 'never'"],
 };
-const FILE_KEYS = ['debugTrace', 'partialTrace', 'fullTrace', 'jsonl', 'tables'];
+/** The entries `files` may have. */
+exports.FILE_KEYS = ['debugTrace', 'partialTrace', 'fullTrace', 'jsonl', 'tables'];
 function checkPatch(value, where) {
     const out = {};
     const problems = [];
     for (const [key, v] of Object.entries(value)) {
         if (v === undefined)
             continue;
-        const rule = KEYS[key];
+        const rule = exports.KEYS[key];
         if (!rule) {
-            problems.push({ key, message: `[advanced-logger] ${where} has an unknown option '${key}'. Valid options: ${Object.keys(KEYS).join(', ')}.` });
+            problems.push({ key, message: `[advanced-logger] ${where} has an unknown option '${key}'. Valid options: ${Object.keys(exports.KEYS).join(', ')}.` });
             continue;
         }
         if (!rule[0](v)) {
@@ -176,8 +178,8 @@ function checkPatch(value, where) {
             for (const [fk, fv] of Object.entries(v)) {
                 if (fv === undefined)
                     continue;
-                if (!FILE_KEYS.includes(fk) || typeof fv !== 'boolean') {
-                    problems.push({ key: `files.${fk}`, message: `[advanced-logger] ${where}: option 'files.${fk}' must be a boolean and one of ${FILE_KEYS.join(', ')}.` });
+                if (!exports.FILE_KEYS.includes(fk) || typeof fv !== 'boolean') {
+                    problems.push({ key: `files.${fk}`, message: `[advanced-logger] ${where}: option 'files.${fk}' must be a boolean and one of ${exports.FILE_KEYS.join(', ')}.` });
                     continue;
                 }
                 files[fk] = fv;

package/dist/configFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"configFile.js","sourceRoot":"","sources":["../src/configFile.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configFile.js","sourceRoot":"","sources":["../src/configFile.ts"],"names":[],"mappings":"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"}

package/dist/init.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `npx @void.01/advanced-logger init`: writes a logger.config.ts with the common options set to their defaults and
+ * the advanced ones commented out (so the logger picks them, some detected at runtime), or adds the options an
+ * existing config file does not mention yet. Text-based, so the user's formatting and comments are kept; nothing
+ * already in the file is changed.
+ */
+interface Option {
+    key: string;
+    /** Allowed values, shown above the key with the default. */
+    type: string;
+    about: string;
+    /** Commented out in the template: left that way, the logger picks the default. */
+    advanced: boolean;
+    /** The default, written as the value. */
+    value?: unknown;
+    /** Source text for a default that is not a plain value (`[process.cwd()]`). */
+    raw?: string;
+    /** Said instead of the value when the default is worked out at runtime. */
+    detected?: string;
+}
+/**
+ * Every top-level option, common ones first, in template order. test/init.test.ts checks the keys against
+ * configFile's KEYS and the values against the built-in defaults.
+ */
+export declare const OPTIONS: Option[];
+/** Entries of `files`, in template order. Always written as values: they are common, and none is detected. */
+export declare const FILE_OPTIONS: Option[];
+/** A new logger.config.ts importing defineConfig from `pkg`, without the stamp line (init adds it). */
+export declare function template(pkg: string): string;
+export interface MergeResult {
+    text: string;
+    added: string[];
+    /** True when the config is a function with a body: everything was added as comments above it. */
+    commentedOnly: boolean;
+}
+/** Works on \n text and gives the file's own line ends back (Windows files stay CRLF). */
+export declare function addMissing(source: string): MergeResult;
+/** What init did, for the CLI to print. */
+export interface InitOutcome {
+    /** The config file created, updated or looked at. */
+    file: string;
+    /** 'refused': the file could not be read as a config (invalid JSON) and was left as is; the CLI exits 1. */
+    action: 'created' | 'updated' | 'unchanged' | 'refused';
+    /** Options added, `files.<entry>` for an entry of `files`. */
+    added: string[];
+    message: string;
+}
+/**
+ * Creates `dir`/logger.config.ts from the template, stamped, or adds the missing options to the first existing
+ * config file (CONFIG_FILE_NAMES order), backing it up first. Never removes or rewrites what the file has.
+ */
+export declare function init(dir: string, pkg: string): InitOutcome;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AAEH,UAAU,MAAM;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,EA4B3B,CAAC;AAEF,8GAA8G;AAC9G,eAAO,MAAM,YAAY,EAAE,MAAM,EAMhC,CAAC;AAwCF,uGAAuG;AACvG,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU5C;AAmDD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iGAAiG;IACjG,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAItD;AA4CD,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,4GAA4G;IAC5G,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IACxD,8DAA8D;IAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAsCD;;;GAGG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAsB1D"}

package/dist/init.js

@@ -0,0 +1,289 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILE_OPTIONS = exports.OPTIONS = void 0;
+exports.template = template;
+exports.addMissing = addMissing;
+exports.init = init;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const configBackup_1 = require("./configBackup");
+const configFile_1 = require("./configFile");
+/**
+ * Every top-level option, common ones first, in template order. test/init.test.ts checks the keys against
+ * configFile's KEYS and the values against the built-in defaults.
+ */
+exports.OPTIONS = [
+    { key: 'level', type: "'debug' | 'info' | 'warn' | 'error' | 'off'", value: 'info', advanced: false, about: 'Console, partial-trace and the report attachment show this level and above. debug-trace and full-trace always record every level.' },
+    { key: 'console', type: 'boolean', value: true, advanced: false, about: 'Print log lines to the console.' },
+    { key: 'consoleWorker', type: 'boolean', value: false, advanced: false, about: 'Prefix console lines with the worker (w0, w1, ...).' },
+    { key: 'consoleTest', type: 'boolean', value: false, advanced: false, about: "Prefix console lines with the running test's title (max 40 chars)." },
+    { key: 'infoLogsCharLimit', type: 'number, or null for no limit', value: null, advanced: false, about: 'INFO logs longer than this are cut on the console and in partial-trace; debug-trace keeps the full text.' },
+    { key: 'logDir', type: 'string', value: './logs', advanced: false, about: 'Folder for trace files and table attachments.' },
+    { key: 'files', type: 'booleans', advanced: false, about: 'Which files to write.' },
+    { key: 'maxLogFiles', type: 'integer, or null to keep all', value: null, advanced: false, about: 'Keep the newest N trace files per kind.' },
+    { key: 'maxRuns', type: 'integer, or null to keep all', value: null, advanced: false, about: 'Keep the files of the newest N runs.' },
+    { key: 'redactKeys', type: 'string[]', value: ['password', 'passwd', 'secret', 'token', 'authorization', 'apikey', 'api_key'], advanced: false, about: 'Field keys whose values print as ***. Setting this replaces the defaults.' },
+    { key: 'attach', type: "'on-failure' | 'always' | 'never'", value: 'on-failure', advanced: false, about: "When the Playwright fixture attaches the test's log to the report." },
+    { key: 'ansi', type: 'boolean', value: true, detected: 'detected from NO_COLOR, FORCE_COLOR, the terminal and CI', advanced: true, about: 'Colors on or off. Off overrides fg and bg.' },
+    { key: 'fg', type: 'boolean', value: true, advanced: true, about: 'Per-action text colors (needs ansi).' },
+    { key: 'bg', type: 'boolean', value: true, advanced: true, about: 'Theme background color (needs ansi).' },
+    { key: 'callerColor', type: 'boolean', value: false, advanced: true, about: 'Color the caller suffix separately on the console.' },
+    { key: 'tsFormat', type: 'pattern string, or (date) => string', value: 'yyyy-MM-dd HH:mm:ss.SSS', advanced: true, about: 'Timestamp format.' },
+    { key: 'segmentDivider', type: 'string', value: ' │ ', advanced: true, about: 'Separator between the parts of a line.' },
+    { key: 'tableCellLimit', type: 'number', value: 40, advanced: true, about: 'Max characters per table cell, when tableCellLimitEnabled is true.' },
+    { key: 'tableCellLimitEnabled', type: 'boolean', value: false, advanced: true, about: 'Cut table cells at tableCellLimit.' },
+    { key: 'recentRunMinutes', type: 'number', value: 60, advanced: true, about: 'Never delete a run with a file changed in the last N minutes.' },
+    { key: 'redactText', type: 'boolean', value: true, advanced: true, about: 'Mask key=value secrets inside message text.' },
+    { key: 'suppressContains', type: 'string[]', value: ['node_modules', 'node:', '<anonymous>'], advanced: true, about: 'Stack frames containing any of these are left out of the caller and [CHAIN].' },
+    { key: 'suppressMethodPrefixes', type: 'string[]', value: [], advanced: true, about: 'Stack frames whose method starts with any of these are left out.' },
+    { key: 'includeOnlyPrefixes', type: 'string[], empty to keep all', value: [], advanced: true, about: 'When set, only frames from these paths or classes are kept.' },
+    { key: 'projectRoots', type: 'string[]', raw: '[process.cwd()]', advanced: true, about: 'Frames under these folders form the [CHAIN] in full-trace.' },
+    { key: 'githubAnnotations', type: 'boolean', value: false, detected: 'true under GitHub Actions, else false', advanced: true, about: 'Also print ::error:: / ::warning:: lines for GitHub.' },
+];
+/** Entries of `files`, in template order. Always written as values: they are common, and none is detected. */
+exports.FILE_OPTIONS = [
+    { key: 'debugTrace', type: 'boolean', value: true, advanced: false, about: 'Every level, with the caller.' },
+    { key: 'partialTrace', type: 'boolean', value: true, advanced: false, about: 'The lines visible at `level`.' },
+    { key: 'fullTrace', type: 'boolean', value: true, advanced: false, about: 'Every level, with the [CHAIN].' },
+    { key: 'jsonl', type: 'boolean', value: false, advanced: false, about: 'One JSON record per log call.' },
+    { key: 'tables', type: 'boolean', value: true, advanced: false, about: 'A CSV and a JSON file for every logged table.' },
+];
+/** A value as TypeScript/JavaScript source, single-quoted. */
+function literal(v) {
+    if (typeof v === 'string')
+        return `'${v.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+    if (Array.isArray(v))
+        return `[${v.map(literal).join(', ')}]`;
+    if (v !== null && typeof v === 'object')
+        return `{ ${Object.entries(v).map(([k, x]) => `${k}: ${literal(x)}`).join(', ')} }`;
+    return String(v);
+}
+const FILES_DEFAULT = Object.fromEntries(exports.FILE_OPTIONS.map((o) => [o.key, o.value]));
+const sourceOf = (o) => o.raw ?? literal(o.key === 'files' ? FILES_DEFAULT : o.value);
+const describe = (o) => `// ${o.about} Type: ${o.type}. Default: ${o.detected ?? sourceOf(o)}.`;
+/** The option's comment and its line; `commented` writes `// key: default,`, which the logger ignores. */
+function optionLines(o, indent, commented = o.advanced) {
+    if (o.key === 'files' && !commented) {
+        const inner = indent + '  ';
+        return [`${indent}${describe(o)}`, `${indent}files: {`, ...exports.FILE_OPTIONS.flatMap((f) => optionLines(f, inner)), `${indent}},`];
+    }
+    return [`${indent}${describe(o)}`, `${indent}${commented ? '// ' : ''}${o.key}: ${sourceOf(o)},`];
+}
+const COMMON_HEADER = ['// ---- Common options ----', '// Set to their defaults. Change any value.'];
+const ADVANCED_HEADER = [
+    '// ---- Advanced options ----',
+    '// Commented out, so the logger picks the default (some are detected at runtime). Uncomment one to change it.',
+];
+/** Common options under their header, then the advanced ones under theirs. `commented` comments out every line. */
+function optionSection(options, indent, commented) {
+    const common = options.filter((o) => !o.advanced);
+    const advanced = options.filter((o) => o.advanced);
+    const section = (header, list) => list.length === 0 ? [] : [...header.map((h) => indent + h), ...list.flatMap((o) => optionLines(o, indent, commented))];
+    const first = section(COMMON_HEADER, common);
+    const second = section(ADVANCED_HEADER, advanced);
+    return [...first, ...(first.length && second.length ? [''] : []), ...second];
+}
+/** A new logger.config.ts importing defineConfig from `pkg`, without the stamp line (init adds it). */
+function template(pkg) {
+    return [
+        `import { defineConfig } from '${pkg}';`,
+        '',
+        `// After upgrading, run \`npx ${pkg} init\` again to add options that are new.`,
+        'export default defineConfig({',
+        ...optionSection(exports.OPTIONS, '  '),
+        '});',
+        '',
+    ].join('\n');
+}
+// -- Adding missing options to an existing file -------------------------------
+/** The key appears as a property (or a commented-out one): at a line start, or after `{` or `,`. */
+const mentions = (text, key) => new RegExp(`(^|[{,])\\s*(?://\\s*)?['"]?${key}['"]?\\s*:`, 'm').test(text);
+/** A line up to its `//` comment, ignoring `//` inside quotes (URLs in strings). */
+function codeOf(line) {
+    let quote = null;
+    for (let i = 0; i < line.length; i++) {
+        const c = line[i];
+        if (quote) {
+            if (c === '\\')
+                i++;
+            else if (c === quote)
+                quote = null;
+        }
+        else if (c === "'" || c === '"' || c === '`')
+            quote = c;
+        else if (c === '/' && line[i + 1] === '/')
+            return line.slice(0, i);
+    }
+    return line;
+}
+/** Index of the last code character before `end`, skipping whitespace and line comments; -1 when none. */
+function lastCodeChar(text, end) {
+    let i = end - 1;
+    while (i >= 0) {
+        const start = text.lastIndexOf('\n', i) + 1;
+        const code = codeOf(text.slice(start, i + 1)).trimEnd();
+        if (code.trim() !== '')
+            return start + code.length - 1;
+        i = start - 2;
+    }
+    return -1;
+}
+const indentOfLine = (text, at) => /^[ \t]*/.exec(text.slice(text.lastIndexOf('\n', at - 1) + 1))[0];
+/**
+ * Insert `lines` just before the `}` at `close`, adding a comma after the last property when it has none.
+ * Returns the new text.
+ */
+function insertBefore(text, close, lines) {
+    const last = lastCodeChar(text, close);
+    let out = text;
+    if (last >= 0 && out[last] !== ',' && out[last] !== '{') {
+        out = out.slice(0, last + 1) + ',' + out.slice(last + 1);
+        close++;
+    }
+    const head = out.slice(0, close).replace(/[ \t]*$/, '');
+    const closingIndent = out.slice(head.length, close);
+    return `${head}${head.endsWith('\n') ? '' : '\n'}${lines.join('\n')}\n${closingIndent}${out.slice(close)}`;
+}
+/** Works on \n text and gives the file's own line ends back (Windows files stay CRLF). */
+function addMissing(source) {
+    const crlf = source.includes('\r\n');
+    const result = addMissingLf(crlf ? source.replace(/\r\n/g, '\n') : source);
+    return crlf ? { ...result, text: result.text.replace(/\n/g, '\r\n') } : result;
+}
+function addMissingLf(text) {
+    const missingTop = exports.OPTIONS.filter((o) => !mentions(text, o.key));
+    const filesAt = /files\s*:\s*\{/.exec(text);
+    const missingFiles = filesAt ? exports.FILE_OPTIONS.filter((o) => !mentions(text, o.key)) : [];
+    const added = [...missingTop.map((o) => o.key), ...missingFiles.map((o) => `files.${o.key}`)];
+    if (added.length === 0)
+        return { text, added, commentedOnly: false };
+    // The exported object closes at the file's last `}`. A function with a block body ends `...; }` instead: there
+    // is no object to put values in, but comments are safe anywhere, so the options go above the export as comments.
+    const close = text.lastIndexOf('}');
+    if (close < 0 || text[lastCodeChar(text, close)] === ';') {
+        const exportAt = /^.*(?:export\s+default|module\.exports)/m.exec(text);
+        const at = exportAt ? exportAt.index : 0;
+        const lines = [
+            '// Added by advanced-logger init: options this config does not set. To use one, put it in the object the',
+            '// function returns. Left out, each uses the default shown.',
+            ...optionSection(missingTop, '', true),
+            ...missingFiles.flatMap((o) => optionLines(o, '', true)),
+            '',
+        ];
+        return { text: text.slice(0, at) + lines.join('\n') + '\n' + text.slice(at), added, commentedOnly: true };
+    }
+    let out = text;
+    // Top-level options first: they go at the end, so the files insertion point (earlier in the text) does not move.
+    if (missingTop.length > 0) {
+        const indent = indentOfLine(out, lastCodeChar(out, close)) || '  ';
+        out = insertBefore(out, close, [`${indent}// Added by advanced-logger init: options this file did not mention.`, ...optionSection(missingTop, indent)]);
+    }
+    if (missingFiles.length > 0) {
+        const open = /files\s*:\s*\{/.exec(out);
+        const at = open.index + open[0].length;
+        const inner = indentOfLine(out, open.index) + '  ';
+        const lines = missingFiles.flatMap((o) => optionLines(o, inner));
+        // After the `{`: each line ends in a comma, so whatever followed stays valid.
+        out = `${out.slice(0, at)}\n${lines.join('\n')}${out[at] === '\n' ? '' : '\n' + inner}${out.slice(at)}`;
+    }
+    return { text: out, added, commentedOnly: false };
+}
+/**
+ * JSON has no comments, so only the common options can be added, as their default values. The advanced ones are
+ * left out, which is the same as commented out: the logger picks their defaults.
+ */
+function initJson(file) {
+    const name = path.basename(file);
+    let json;
+    try {
+        json = JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch (err) {
+        return { file, action: 'refused', added: [], message: `${name} was left as is: it is not valid JSON (${err.message}).` };
+    }
+    const added = [];
+    for (const o of exports.OPTIONS.filter((x) => !x.advanced && !(x.key in json))) {
+        json[o.key] = o.key === 'files' ? { ...FILES_DEFAULT } : o.value;
+        added.push(o.key);
+    }
+    const files = json.files;
+    for (const o of exports.FILE_OPTIONS.filter((x) => !added.includes('files') && !(x.key in files))) {
+        files[o.key] = o.value;
+        added.push(`files.${o.key}`);
+    }
+    const unset = exports.OPTIONS.filter((o) => o.advanced && !(o.key in json)).map((o) => o.key);
+    const advancedNote = unset.length ? ` JSON has no comments, so the advanced options are not listed; left out, they use their defaults: ${unset.join(', ')}.` : '';
+    if (added.length === 0)
+        return { file, action: 'unchanged', added, message: `${name} already sets every common option.${advancedNote}` };
+    (0, configBackup_1.backupConfig)(file);
+    fs.writeFileSync(file, JSON.stringify(json, null, 2) + '\n');
+    return { file, action: 'updated', added, message: `Added ${added.length} common option(s) to ${name}, set to their defaults: ${added.join(', ')}.${advancedNote}${backedUp(file)}` };
+}
+/** Tells the user where the previous version went and how to get it back. */
+function backedUp(file) {
+    const n = (0, configBackup_1.listBackups)(path.dirname(file)).length;
+    return ` The previous version is backup ${n} (the newest); "restore ${n}" puts it back.`;
+}
+/**
+ * Creates `dir`/logger.config.ts from the template, stamped, or adds the missing options to the first existing
+ * config file (CONFIG_FILE_NAMES order), backing it up first. Never removes or rewrites what the file has.
+ */
+function init(dir, pkg) {
+    const existing = configFile_1.CONFIG_FILE_NAMES.map((n) => path.join(dir, n)).find((f) => fs.existsSync(f));
+    if (!existing) {
+        const file = path.join(dir, 'logger.config.ts');
+        fs.writeFileSync(file, (0, configBackup_1.withStamp)(template(pkg), 'init'));
+        return { file, action: 'created', added: [], message: `Created ${file}: common options set to their defaults, advanced ones commented out (the logger picks those).` };
+    }
+    if (existing.endsWith('.json'))
+        return initJson(existing);
+    const name = path.basename(existing);
+    const result = addMissing(fs.readFileSync(existing, 'utf8'));
+    if (result.added.length === 0)
+        return { file: existing, action: 'unchanged', added: [], message: `${name} already lists every option.` };
+    (0, configBackup_1.backupConfig)(existing);
+    fs.writeFileSync(existing, (0, configBackup_1.withStamp)(result.text, 'init'));
+    const how = result.commentedOnly
+        ? 'as comments above the export (the config is a function, so they could not go in its object)'
+        : 'common ones set to their defaults, advanced ones commented out';
+    return {
+        file: existing,
+        action: 'updated',
+        added: result.added,
+        message: `Added ${result.added.length} missing option(s) to ${name}, ${how}: ${result.added.join(', ')}.${backedUp(existing)}`,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@void.01/advanced-logger",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Self-contained logger for Playwright/TypeScript. Port of VOID core.logging.",
   "license": "MIT",
   "repository": {
@@ -12,6 +12,9 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "advanced-logger": "dist/cli.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",