🚜 [refactor] Large-scale docs localization + ANSI conversion scripts overhaul + tooling updates

 - 🧪 Improved encoding support: use iconv decode(cp437) for legacy ANSI files and return both content and sauce metadata.
 - ✨ Better return shapes: convertAnsiToPs1 now returns { lines, warnings, terminal } for programmatic consumption; main() gives clearer status and exits non-zero on fatal errors.
 - 🔁 Consistent style & exports: standardized function exports (TerminalEmulator, readAnsiFile, convertAnsiToPs1, parseArguments, sanitizeName, main, createDefaultAttrs, stripSauce) and applied consistent formatting/whitespace for readability.

🚜 [refactor] Split-AnsiFile.js — CLI splitting utility hardened & modernized
 - 🔧 Reworked CLI parsing into typed SplitOptions with JSDoc and solid defaults (DEFAULT_OUTPUT_DIR).
 - 🔧 Implemented robust segmentation pipeline: extractLinesFromPs1(), determineBreaks(), splitLines(), ensureTrailingReset(), plus chunk-writing helpers writeChunkPs1/writeChunkAnsi.
 - 🔧 Added features: --heights (cumulative), --breaks (absolute), --every (regular chunking), --auto (blank-line gap detection with gap/minSegment thresholds), --dry-run and --strip-space-bg; improved user-facing error/help output.
 - 🔧 Now uses the conversion utilities (readAnsiFile/convertAnsiToPs1) and produces consistent part files (sanitized names, padded suffixes) and safe writes.

👷 [ci] Tooling & formatting additions (package.json & package-lock)
 - 🔧 Added Prettier + an array of Prettier plugins to devDependencies: prettier, prettier-plugin-powershell, prettier-plugin-ini, prettier-plugin-jsdoc, prettier-plugin-multiline-arrays, prettier-plugin-packagejson, prettier-plugin-merge, prettier-plugin-sql, prettier-plugin-sort-json, prettier-plugin-tailwindcss, and helper plugins (prettier-plugin-interpolated-html-tags, @awmottaz/prettier-plugin-void-html, prettier-plugin-properties).
 - 🔧 Updated package-lock.json to reflect new plugin dependency graph and included supporting libs (micromark/mdast ecosystem, json5, luxon, etc.) for the new formatting toolchain.
 - ⚙️ Rationale: unify code style across JS/Markdown/PowerShell and enable safe automated formatting in CI pipelines.

📝 [docs] Massive localization & help content hygiene (pt / ru / zh-CN + others)
 - ✍️ Standardized many localized Markdown help pages under ColorScripts-Enhanced/{pt,ru,zh-CN}: added blank-line separations, improved examples, clarified descriptions, expanded Best Practices and Advanced Usage sections where missing.
 - ✍️ Escaped wildcard characters in docs (changed "*" to "\*") in multiple languages to avoid unintended Markdown rendering and to make parameter docs literal and copy-paste safe.
 - ✍️ Normalized parameter YAML fragments: standardized keys (DontShow, AcceptedValues, HelpMessage) and consistent formatting (HelpMessage: ""), added small blank lines for readability.
 - ✍️ Inserted several translated refinements and extra sample snippets for configuration, caching and profile installation workflows.

📝 [docs] HelpInfo and generated help XML updates
 - ✍️ Bumped UICultureVersion timestamps in HelpInfo.xml files for pt/ru/zh-CN to reflect documentation refresh (2025.11.05.1608 → 2025.11.05.1615).
 - ✍️ Reflowed long description paragraphs in the module help XMLs to improve readability and to separate lists into distinct maml:para blocks.

📝 [docs] Documentation index & summary artifacts updated
 - ✍️ Updated DOCUMENTATION_EXPANSION_SUMMARY.md, DOCUMENTATION_INDEX.md, DOCUMENTATION_STATUS_REPORT.md, HELP_ENHANCEMENTS_SUMMARY.md and related artifacts: reflowed tables, aligned columns, improved metrics and "Last Updated" formatting (converted trailing bullets to underscored metadata).
 - ✍️ README.md: small table alignment fixes and clarified Get-Help -Online behavior wording.

✨ [feat] help-redirect.html — rewrite for robust language detection & redirects
 - ✨ Normalized doctype and modernized HTML head; improved language mapping and browser language probing (navigator.languages fallback), better supportedCultures mapping and safe redirect to localized markdown pages on GitHub.
 - 📝 UI improvements: spinner, friendly message, and explicit "Detected language" feedback prior to redirect.

🧹 [chore] CI/config formatting and docs support fixes
 - 🧹 _config.yml: normalized plugin list indentation for Jekyll site config.
 - 🧹 codecov.yml: comment spacing & inline comment normalizations; minor whitespace cleanups in ignored paths to reduce diff noise.
 - 🧹 Updated multiple docs (Development.md, CODECOV_JUNIT_SETUP.md, NPM_SCRIPTS.md, Publishing.md, QUICK_REFERENCE.md) to fix table alignment, wording, and code-block formatting.

📝 [docs] micro-fixes & release artifacts
 - ✍️ Cleaned dist release notes templates (dist/LatestReleaseNotes.md, dist/PowerShellGalleryReleaseNotes.md): removed empty placeholders, reflowed contributor/license blocks and ensured git-cliff footer note is present.
 - ✍️ Minor localized help adjustments: consistent quoting, added minor explanatory text and small example expansions across many command docs (Get-ColorScriptList, Show-ColorScript, New-ColorScript, New-ColorScriptCache, Clear-ColorScriptCache, etc.).

🧪 [test] Validation notes and guardrails
 - 🔍 Conversion & split scripts now emit warnings array for conversion anomalies (parser/CSI/ESC warnings). CLI surfaces top warnings and summarizes them for troubleshooting.
 - 🔁 Conversion pipeline improved to return programmatic values enabling unit-style verification in future tests.

Notes / Impact
 - 🔔 Primary focus: stabilise and modernize the ANSI → PowerShell conversion pipeline and make CLI splitting deterministic and extensible.
 - 🧾 Secondary focus: large documentation/localization cleanup for better UX and consistent help output across supported locales.
 - ⚠️ Backwards compatibility: conversion CLI options were extended; calling scripts that relied on older export names should adapt to the exported function names (convertAnsiToPs1/readAnsiFile/etc.). Review calling points if external automation used prior private exports.
 - ✅ This commit bundles code + doc + tooling changes because they are tightly coupled: new formatting toolchain ensures consistent style for the refactored JS and the regenerated help content.

Files / areas touched (non-exhaustive)
 - src/scripts: Convert-AnsiToColorScript.js (major), Split-AnsiFile.js (major)
 - package.json & package-lock.json (prettier + plugins)
 - docs/ & docs/*.md (many updates), docs/help-redirect.html (rewrite)
 - ColorScripts-Enhanced/{pt,ru,zh-CN}/**/*.md and help.xml (localized docs & UICultureVersion bumps)
 - dist/*.md (release notes)
 - README.md, _config.yml, codecov.yml, various DOCUMENTATION_*.md and HELP_ENHANCEMENTS_SUMMARY.md

— End of changes

Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com>

Author: Nick2bad4u

.github/PROMPTS/Consistency-Check.prompt.md

@@ -52,6 +52,7 @@ If you find documentation gaps add them. If you find out-of-date documentation a
 ### 1. Categorized Report
 
 For each inconsistency provide:
+
 - Relevant file path(s) with concise excerpts.
 - A short description of the issue, including the layer or pattern it affects.
 - A recommended alignment approach grounded in an existing best practice within the repository.
@@ -63,13 +64,15 @@ Rank findings by their risk to stability, potential to introduce bugs, and overa
 ### 3. Improvement Suggestions
 
 Group related findings and outline:
+
 - The preferred approach or exemplar to follow.
 - Ordered steps to realign the affected code.
 - Expected impact across modules, IPC contracts, schemas, or docs.
 
 ### 4. Roadmap
 
 Suggest a staged plan:
+
 - **Quick Wins** – light standardisations with meaningful payoff.
 - **Medium-Term** – coordinated refactors requiring moderate coordination.
 - **Long-Term** – deeper architectural work worth tracking separately.
@@ -85,6 +88,7 @@ Suggest a staged plan:
 ## Fixing Inconsistencies
 
 When addressing identified inconsistencies, follow these steps:
+
 1. **Understand the Context**: Review the relevant code sections to fully grasp the intended functionality and how it fits within the overall architecture.
 2. **Consult Documentation**: Refer to any existing documentation or architectural guidelines to ensure your changes align with established best practices.
 3. **Refactor Thoughtfully**: Make changes that enhance consistency without introducing new issues. Ensure that your refactoring maintains the original functionality.
@@ -96,6 +100,7 @@ When addressing identified inconsistencies, follow these steps:
 ## Examples of Inconsistencies to Look For
 
 Examples of inconsistencies include:
+
 - Different naming conventions for similar functions or variables (e.g., verb-noun patterns, parameter names).
 - Varied approaches to error handling in public cmdlets versus private helpers.
 - Divergent data transformation logic for the same data structure in different functions.

.github/PROMPTS/Continue.prompt.md

@@ -11,7 +11,6 @@ name: "Continue"
 - Locate the next incomplete TODO item (those not marked as done or resolved).
 - If you have any questions or need clarification on any TODO items, document them clearly for further review or stop and ask for assistance.
 - For each incomplete TODO item, proceed systematically:
-
   - Review the context, problem description, and any relevant files mentioned.
   - Assess the current state and any blockers or dependencies.
   - Implement necessary changes, fixes, or features using available tools.

.github/agents/BeastMode.agent.md

@@ -3,7 +3,40 @@ name: BeastMode
 description: Beast Mode 3.1 (Custom) - PowerShell Module Specialist
 argument-hint: "💻 🤖 😈 Beast Mode agent ready for PowerShell excellence. 👿 🤖 💻"
 model: GPT-5-Codex (Preview) (copilot)
-tools: ['edit/createFile', 'edit/createDirectory', 'edit/editFiles', 'search/fileSearch', 'search/textSearch', 'search/listDirectory', 'search/readFile', 'search/codebase', 'tavily/tavily-extract', 'tavily/tavily-map', 'tavily/tavily-search', 'vscode-mcp/execute_command', 'vscode-mcp/get_diagnostics', 'vscode-mcp/get_references', 'vscode-mcp/get_symbol_lsp_info', 'vscode-mcp/rename_symbol', 'runCommands/getTerminalOutput', 'runCommands/terminalLastCommand', 'runCommands/runInTerminal', 'runTasks/runTask', 'runTasks/getTaskOutput', 'runSubagent', 'usages', 'problems', 'changes', 'testFailure', 'fetch', 'memory', 'ms-vscode.vscode-websearchforcopilot/websearch', 'todos', 'runTests']
+tools:
+ [
+  "edit/createFile",
+  "edit/createDirectory",
+  "edit/editFiles",
+  "search/fileSearch",
+  "search/textSearch",
+  "search/listDirectory",
+  "search/readFile",
+  "search/codebase",
+  "tavily/tavily-extract",
+  "tavily/tavily-map",
+  "tavily/tavily-search",
+  "vscode-mcp/execute_command",
+  "vscode-mcp/get_diagnostics",
+  "vscode-mcp/get_references",
+  "vscode-mcp/get_symbol_lsp_info",
+  "vscode-mcp/rename_symbol",
+  "runCommands/getTerminalOutput",
+  "runCommands/terminalLastCommand",
+  "runCommands/runInTerminal",
+  "runTasks/runTask",
+  "runTasks/getTaskOutput",
+  "runSubagent",
+  "usages",
+  "problems",
+  "changes",
+  "testFailure",
+  "fetch",
+  "memory",
+  "ms-vscode.vscode-websearchforcopilot/websearch",
+  "todos",
+  "runTests",
+ ]
 handoffs:
  - label: Consistency Check
    agent: BeastMode
@@ -44,11 +77,13 @@ target: vscode
 
 1. Fetch any URL's provided by the user using the `fetch` tool.
 2. Understand the problem deeply. Think harder and Super Think. Carefully read the issue and think critically about what is required. Use sequential thinking and memory tools if needed to break down the problem into manageable parts. Consider the following:
-  - What is the expected behavior?
-  - What are the edge cases?
-  - What are the potential pitfalls?
-  - How does this fit into the larger context of the PowerShell module?
-  - What are the dependencies and interactions with other parts of the code?
+
+- What is the expected behavior?
+- What are the edge cases?
+- What are the potential pitfalls?
+- How does this fit into the larger context of the PowerShell module?
+- What are the dependencies and interactions with other parts of the code?
+
 3. Investigate the codebase. Explore relevant files, search for key functions, and gather context.
 4. If the problem is with 3rd party libraries or frameworks, research the problem on the internet by reading relevant articles, documentation, and forums.
 5. Develop a clear, step-by-step plan. Break down the fix into manageable, incremental steps. Display those steps in a simple todo list.
@@ -131,14 +166,17 @@ Refer to the detailed sections below for more information on each step.
 - You have no time or compute constraints, do not rush to try and finish the task.
 
 ## Thinking
+
 If the thinking tool is available, use it to break down complex problems into smaller, manageable steps.
 
 ## Override Constraints
+
 - All constraints are updated to `unlimited` or `maximum` for this session.
 - Making decisions based on time is not allowed.
 - You have time to finish any task no matter how large it is or long it takes.
 
 ## Thinking Mode
+
 - **Time constraint setting:** `unlimited`
 - **Compute Resource setting:** `unlimited`
 - **Thinking Mode setting:** `Ultrathink`

.github/dependabot.yml

@@ -10,68 +10,68 @@
 
 version: 2
 updates:
-  - package-ecosystem: github-actions
-    cooldown:
-      default-days: 3
-      include: ["*"]
-    directory: /
-    schedule:
-      interval: quarterly
-      time: "05:30"
-      timezone: "America/Detroit"
-    assignees: ["Nick2bad4u"]
-    allow:
-      # Allow both direct and indirect updates for all packages
-      - dependency-type: "all"
-    labels:
-      - "github-actions"
-      - "dependabot"
-      - "dependencies"
-    commit-message:
-      prefix: "[ci][skip-ci]"
-      prefix-development: "[ci][skip-ci]"
-      include: "scope"
-    groups:
-      github-actions:
-        applies-to: version-updates
-        patterns:
-          - "*"
+    - package-ecosystem: github-actions
+      cooldown:
+          default-days: 3
+          include: ["*"]
+      directory: /
+      schedule:
+          interval: quarterly
+          time: "05:30"
+          timezone: "America/Detroit"
+      assignees: ["Nick2bad4u"]
+      allow:
+          # Allow both direct and indirect updates for all packages
+          - dependency-type: "all"
+      labels:
+          - "github-actions"
+          - "dependabot"
+          - "dependencies"
+      commit-message:
+          prefix: "[ci][skip-ci]"
+          prefix-development: "[ci][skip-ci]"
+          include: "scope"
+      groups:
+          github-actions:
+              applies-to: version-updates
+              patterns:
+                  - "*"
 
-  - package-ecosystem: npm
-    cooldown:
-      default-days: 3
-      include: ["*"]
-    directory: /
-    schedule:
-      interval: quarterly
-    assignees: ["Nick2bad4u"]
-    versioning-strategy: increase
-    allow:
-      # Allow both direct and indirect updates for all packages
-      - dependency-type: "all"
-    ignore:
-      - dependency-name: "electron-builder"
-        versions: ["< 26.0.18"]
-      - dependency-name: "electron-builder-squirrel-windows"
-        versions: ["< 26.0.18"]
-        # Ignore local workspace dependencies completely
-      - dependency-name: "@shared/*"
-      - dependency-name: "file:*"
+    - package-ecosystem: npm
+      cooldown:
+          default-days: 3
+          include: ["*"]
+      directory: /
+      schedule:
+          interval: quarterly
+      assignees: ["Nick2bad4u"]
+      versioning-strategy: increase
+      allow:
+          # Allow both direct and indirect updates for all packages
+          - dependency-type: "all"
+      ignore:
+          - dependency-name: "electron-builder"
+            versions: ["< 26.0.18"]
+          - dependency-name: "electron-builder-squirrel-windows"
+            versions: ["< 26.0.18"]
+            # Ignore local workspace dependencies completely
+          - dependency-name: "@shared/*"
+          - dependency-name: "file:*"
 
-    labels:
-      - "npm"
-      - "dependabot"
-      - "dependencies"
-    commit-message:
-      prefix: "[dependency]"
-      prefix-development: "[dev-dependency][skip-ci]"
-      include: "scope"
-    groups:
-      npm-all:
-        applies-to: version-updates
-        patterns:
-          - "*"
-          # Exclude local packages from grouping
-        exclude-patterns:
-          - "@shared/*"
-          - "file:*"
+      labels:
+          - "npm"
+          - "dependabot"
+          - "dependencies"
+      commit-message:
+          prefix: "[dependency]"
+          prefix-development: "[dev-dependency][skip-ci]"
+          include: "scope"
+      groups:
+          npm-all:
+              applies-to: version-updates
+              patterns:
+                  - "*"
+                  # Exclude local packages from grouping
+              exclude-patterns:
+                  - "@shared/*"
+                  - "file:*"

.github/workflows/ActionLint.yml

@@ -16,30 +16,30 @@
 
 name: ActionLint
 concurrency:
-  group: actionlint-${{ github.ref }}
-  cancel-in-progress: false
+    group: actionlint-${{ github.ref }}
+    cancel-in-progress: false
 on:
-  push:
-    paths:
-      - ".github/**"
-  pull_request:
-    paths:
-      - ".github/**"
-  workflow_dispatch:
+    push:
+        paths:
+            - ".github/**"
+    pull_request:
+        paths:
+            - ".github/**"
+    workflow_dispatch:
 
 permissions:
-  contents: read
-  pull-requests: write
+    contents: read
+    pull-requests: write
 
 jobs:
-  job-1:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Harden Runner
-        uses: step-security/harden-runner@f4a75cfd619ee5ce8d5b864b0d183aff3c69b55a # v2.13.1
-        with:
-          egress-policy: audit
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-      - uses: devops-actions/actionlint@c6744a34774e4e1c1df0ff66bdb07ec7ee480ca0 #v0.1.9
-        continue-on-error: true
-        id: action-lint
+    job-1:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Harden Runner
+              uses: step-security/harden-runner@f4a75cfd619ee5ce8d5b864b0d183aff3c69b55a # v2.13.1
+              with:
+                  egress-policy: audit
+            - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+            - uses: devops-actions/actionlint@c6744a34774e4e1c1df0ff66bdb07ec7ee480ca0 #v0.1.9
+              continue-on-error: true
+              id: action-lint