@n42/cli 0.2.90 → 0.2.95

package/.github/workflows/audit-check.yaml

@@ -0,0 +1,20 @@
+name: Dependency audit (informational)
+
+on:
+  schedule:
+    - cron: '30 14 * * 3'
+  workflow_dispatch:
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm install
+      # xmldom has known critical advisories with no upstream fix.
+      # This audit is informational only.
+      - run: npm audit --omit=dev --audit-level=critical || true

package/ISSUE_TEMPLATE.md

@@ -0,0 +1,22 @@
+### Summary
+Clear description of the problem and what you expected to happen.
+
+### Reproduction
+Exact `n42` command(s) and option(s) used:
+```
+n42 <command> [options]
+```
+
+### Environment
+- n42 version:
+- Node.js version:
+- OS:
+- Install type: global (`npm install -g`) or local (`npx`)
+
+### Output / Logs
+```text
+(paste full output here)
+```
+
+### Notes
+Any additional context that may be relevant (CI environment, shell, PATH issues, etc.).

package/README.md

@@ -27,6 +27,17 @@ and testing — not for production message exchange.
 - Interactive diagrams with clickable links
 - Local artefact history inspection
 
+## Architecture
+
+The Node42 CLI `n42` is a Node.js-based diagnostic tool designed for fast, deterministic execution.
+
+Core command logic lives in `src/`, with each command implemented as a focused module (e.g. `discover`, `validate`). Shared concerns such as configuration, output formatting, persistence, and utilities are isolated in dedicated helpers.
+
+Static assets and shell completions are bundled at build time and distributed with the CLI. Tests mirror the source structure and exercise both command behavior and internal helpers.
+
+Each CLI invocation performs a bounded set of operations and exits; the tool does not run background services or maintain long-lived runtime state beyond persisted history and configuration stored in `~/.node42`.
+
+
 ## Installation
 
 ### Requirements

package/SECURITY.md

@@ -0,0 +1,9 @@
+## Dependency advisories
+
+This project depends on `xmldom`.
+
+Upstream advisories exist related to malformed XML handling.
+There is currently no patched version available.
+
+The CLI does not treat XML input as untrusted network data.
+This risk is accepted until an upstream fix is available.

package/dist/completion/bash.sh

@@ -0,0 +1,32 @@
+_n42_completions()
+{
+  local cur prev words cword
+  _init_completion || return
+
+  local commands="login logout apikey me usage clean history discover validate"
+
+  if [[ $cword -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "$commands" -- "$cur") )
+    return
+  fi
+
+  # discover peppol
+  if [[ ${words[1]} == "discover" && $cword -eq 2 ]]; then
+    COMPREPLY=( $(compgen -W "peppol" -- "$cur") )
+    return
+  fi
+
+  # validate peppol
+  if [[ ${words[1]} == "validate" && $cword -eq 2 ]]; then
+    COMPREPLY=( $(compgen -W "peppol" -- "$cur") )
+    return
+  fi
+
+  # usage discovery|validation|transactions
+  if [[ ${words[1]} == "usage" && $cword -eq 2 ]]; then
+    COMPREPLY=( $(compgen -W "discovery validation transactions" -- "$cur") )
+    return
+  fi
+}
+
+complete -F _n42_completions n42