node-ansi-logger 3.3.2-dev-20260913-3c6325b → 3.3.2-dev-20260929-e6adf07

package/CHANGELOG.md

@@ -23,6 +23,25 @@ If you like this project and find it useful, please consider giving it a star on
 
 ## [3.3.2] - Dev branch
 
+### Added
+
+- [devcontainer]: Add [`Dev Container`](.devcontainer/README.md) v.2.2.0 with dual Node and Bun runtime support.
+- [agents]: Add a [`shared setup`](.agents/README.md) for all agents: OpenAI Codex, Claude Code, GitHub Copilot and Google Gemini / Antigravity.
+- [agents]: Add [`commit message instructions`](.github/commit-message-instructions.md) v.1.0.0 for the VS Code Copilot "Generate Commit Message" button (Conventional Commits).
+
+### Changed
+
+- [vscode]: Update `.vscode/settings.json` to v.1.0.13: point the Copilot "Generate Commit Message" button to `.github/commit-message-instructions.md`.
+- [styleguide]: Update [`STYLEGUIDE.md`](STYLEGUIDE.md) to v.1.1.0: align it with the lint and format config and add the Commit Messages and Changelog sections.
+- [scripts]: Update `scripts/clean.mjs` and `scripts/deep-clean.mjs` to v.1.3.0: log every removed path, add `--help` and `--version` and reject unknown arguments.
+- [package]: Upgrade package.
+- [package]: Bump `oxfmt` to v.0.71.0.
+- [package]: Bump `oxlint` to v.1.86.0.
+- [package]: Bump `oxlint-tsgolint` to v.7.0.2003.
+- [package]: Bump `vitest` to v.5.0.2.
+- [package]: Bump `@vitest/coverage-v8` to v.5.0.2.
+- [package]: Bump `@types/node` to v.26.6.3.
+
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
 
 ## [3.3.1] - 2026-08-29

package/README.md

@@ -175,17 +175,73 @@ log.debug(`State changed: ${green`on`} → ${red`off`}`);
 
 ![Example Image](https://github.com/Luligu/node-ansi-logger/blob/main/screenshots/Screenshot.png)
 
-# Repository setup
+## Repository toolchain
 
-> **Note:** This repository uses a new toolchain. It replaces the traditional TypeScript / ESLint / Prettier / Jest stack with a faster, lighter setup.
+> **Note:** This repository uses a new toolchain. It replaces the traditional TypeScript / ESLint / Prettier / Jest stack with a faster and lighter setup.
 
-- **No `typescript` package** — replaced by [TypeScript Native](https://github.com/microsoft/typescript-go). The `typescript` package is kept only as a publish-time dependency while tsgo is still in preview.
+- **No `typescript 6.x` package** — replaced by [TypeScript Native 7.x](https://github.com/microsoft/typescript-go).
 - **No ESLint, no Prettier** — replaced by the [oxc](https://oxc.rs) stack: [oxlint](https://oxc.rs/docs/guide/usage/linter.html) for linting and [oxfmt](https://oxc.rs/docs/guide/usage/formatter.html) for formatting.
 - **No Jest** — replaced by [Vitest](https://vitest.dev), which is much faster and natively supports ESM without extra configuration.
 - **Far fewer development dependencies** — the number of installed packages drops from **~600** to **~75**. A clean install is much faster.
 - **Much faster linting and formatting** — oxlint and oxfmt run in a fraction of the time required by the ESLint / Prettier pipeline.
 - **Much faster builds** — tsgo compiles the project in a fraction of the time required by the standard `tsc` build.
-- **Editor support** — uses the VS Code extensions for tsgo and oxc to get the same experience in the editor.
+- **Editor support** — use the VS Code extensions for tsgo and oxc to get the same experience in the editor.
+
+## Shared agent instructions
+
+All coding agents read the same guidance. [AGENTS.md](./AGENTS.md) and [.agents/](./.agents/) are the **single source of truth**; everything under `.github/`, `.claude/`, `.codex/` and `.antigravity/` are pointers and mirrors. Edit `.agents/` (or `AGENTS.md`), never the copies. See [.agents/README.md](./.agents/README.md) for the full layout.
+
+| File                                           | Notes                                                                                                        |
+| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| `AGENTS.md`                                    | Main project instructions — shared by every agent                                                            |
+| `.agents/README.md`                            | Layout and versioning of the shared instructions                                                             |
+| `.agents/rules/testing.instructions.md`        | Testing standards for unit tests                                                                             |
+| `.agents/skills/verify-agent-context/SKILL.md` | Verify the agent loaded this context — `$verify-agent-context` (Codex), `/verify-agent-context` (all others) |
+
+Content lives only in `.agents/`. The per-agent folders exist because each tool discovers rules and skills from its own hardcoded location, so they hold stubs that point back here — except where the tool reads `.agents/` natively.
+
+| Tool                               | Instructions                                    | Rules                                                 | Skills                                              |
+| ---------------------------------- | ----------------------------------------------- | ----------------------------------------------------- | --------------------------------------------------- |
+| Codex                              | `AGENTS.md` — read natively                     | `.agents/rules/` — linked from `AGENTS.md`, on demand | `.agents/skills/` — native, `$verify-agent-context` |
+| Copilot (VS Code and coding agent) | `.github/copilot-instructions.md` → `AGENTS.md` | stubs in `.github/instructions/` — `applyTo` globs    | stub in `.github/skills/` — `/verify-agent-context` |
+| Claude Code                        | `CLAUDE.md` imports `AGENTS.md`                 | stubs in `.claude/rules/` — `paths` globs             | stub in `.claude/skills/` — `/verify-agent-context` |
+| Gemini / Antigravity               | `GEMINI.md` imports `AGENTS.md`                 | `.agents/rules/` — on demand                          | `.agents/skills/` — native, `/verify-agent-context` |
+
+### Copilot instructions
+
+| File                                                   | Notes                                        |
+| ------------------------------------------------------ | -------------------------------------------- |
+| `.github/copilot-instructions.md`                      | Pointer to AGENTS.md — always loaded         |
+| `.github/instructions/testing/testing.instructions.md` | Testing standards — scoped to `**/*.test.ts` |
+| `.github/skills/verify-agent-context/SKILL.md`         | Skill invocable as `/verify-agent-context`   |
+
+### Claude instructions
+
+| File                                            | Notes                                         |
+| ----------------------------------------------- | --------------------------------------------- |
+| `CLAUDE.md`                                     | Pointer to AGENTS.md — always loaded          |
+| `.claude/settings.json`                         | Claude permissions: allow, ask and deny rules |
+| `.claude/rules/testing/testing.instructions.md` | Testing standards — scoped to `**/*.test.ts`  |
+| `.claude/skills/verify-agent-context/SKILL.md`  | Skill invocable as `/verify-agent-context`    |
+
+### Codex instructions
+
+| File                         | Notes                                                             |
+| ---------------------------- | ----------------------------------------------------------------- |
+| `AGENTS.md`                  | Main project instructions — read directly, no pointer file needed |
+| `.codex/config.toml`         | Codex project permissions, approvals, and profile                 |
+| `.codex/rules/default.rules` | Codex command allow, prompt, and deny rules                       |
+
+Codex reads the shared rules and skills from `.agents/` directly; the skill is invoked as `$verify-agent-context`.
+
+### Gemini / Antigravity instructions
+
+| File                         | Notes                                                 |
+| ---------------------------- | ----------------------------------------------------- |
+| `GEMINI.md`                  | Pointer to AGENTS.md — always loaded                  |
+| `.antigravity/settings.json` | Sandboxing and permissions: allow, ask and deny rules |
+
+The shared rules under `.agents/rules/` apply on demand for the relevant tasks, and `.agents/skills/` is discovered automatically as `/verify-agent-context`.
 
 # Contributing
 

package/dist/ansi.js

@@ -196,9 +196,9 @@ function isStyleName(prop) {
  * @returns {AnsiTag} Chainable ANSI tag.
  */
 function createTag(styles = []) {
-    // oxlint-disable-next-line typescript/no-unsafe-type-assertion
     const tag = ((strings, ...values) => {
         return applyStyles(joinTemplate(strings, values), styles);
+        // oxlint-disable-next-line typescript/no-unsafe-type-assertion
     });
     return new Proxy(tag, {
         get(target, prop) {

package/dist/logger.js

@@ -743,7 +743,7 @@ export class AnsiLogger {
                 const size = this.logToFile(this.logFilePath, level, message, ...parameters);
                 this.#logFileSize += size;
                 if (this.#logFileSize >= this.#maxFileSize) {
-                    // istanbul ignore next
+                    /* v8 ignore next */
                     appendFileSync(this.logFilePath, `Logging on file has been stoppped because the file size is greater then ${this.#maxFileSize}B.\n`);
                 }
             }
@@ -761,7 +761,7 @@ export class AnsiLogger {
                 const size = this.logToFile(__AnsiLoggerFilePath__, level, message, ...parameters);
                 __AnsiLoggerFileLogSize__ += size;
                 if (__AnsiLoggerFileLogSize__ >= this.#maxFileSize) {
-                    // istanbul ignore next
+                    /* v8 ignore next */
                     appendFileSync(__AnsiLoggerFilePath__, `Logging on file has been stoppped because the file size is greater then ${this.#maxFileSize}B.\n`);
                 }
             }

package/dist/stringify.js

@@ -123,7 +123,7 @@ export function stringify(payload, enableColors = false, colorPayload = 252, col
                 return `${clr(colorUndefined)}(function)${reset()}`;
             // No Default
         }
-        /* istanbul ignore next */
+        /* v8 ignore next */
         return `${clr(colorUndefined)}${String(value)}${reset()}`;
     };
     const isTrackable = typeof payload === 'object' && payload !== null;
@@ -156,7 +156,7 @@ export function stringify(payload, enableColors = false, colorPayload = 252, col
         // @ts-expect-error -- The type of value is unknown, but we will handle it in the code below
         newValue = value;
         // console.log(typeof newValue, key, value);
-        // istanbul ignore next cause is unreachable code for typeof, but included for completeness
+        /* v8 ignore next cause is unreachable code for typeof, but included for completeness */
         if (value === null) {
             newValue = `${clr(colorUndefined)}null${reset()}`;
         }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "node-ansi-logger",
-  "version": "3.3.2-dev-20260913-3c6325b",
+  "version": "3.3.2-dev-20260929-e6adf07",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "node-ansi-logger",
-      "version": "3.3.2-dev-20260913-3c6325b",
+      "version": "3.3.2-dev-20260929-e6adf07",
       "license": "Apache-2.0",
       "engines": {
         "node": ">=20.19.0 <21.0.0 || >=22.13.0 <23.0.0 || >=24.0.0 <25.0.0 || >=26.0.0 <27.0.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-ansi-logger",
-  "version": "3.3.2-dev-20260913-3c6325b",
+  "version": "3.3.2-dev-20260929-e6adf07",
   "description": "Enhanced Ansi Color Logging and Stringify for Node.js in type script",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",