registry / @nalvietnam/avatar-cli / 3.36.2

@nalvietnam/avatar-cli@3.36.2

AI harness CLI for NAL Vietnam engineering

AI Security Review

scanned 9d ago · by lpm-firewall-ai

The flagged credential and execution signals correspond to provider setup and a user-run diagnostic probe, with their destinations and behavior visible in the CLI flow. The install hook only displays welcome content, and the inspected source establishes no concrete malicious behavior.

Static reason

One or more suspicious static signals were detected.; previous stored version diff introduced dangerous source

Trigger

Package installation triggers the welcome screen; AI setup and the doctor probe require running their CLI commands.

Impact

No unauthorized credential transfer, persistence, or destructive effect was established.

Mechanism

AI setup verifies a supplied key with the chosen provider endpoint and saves that provider configuration. The doctor probe sends an account token with a diagnostic request to the package's telemetry endpoint.

AI rationale

Evidence

package.jsonbin/postinstall.jsdist/index.js

Network endpoints3

ai.nal.vnapi.anthropic.comtelemetry.nal.vn

Decision evidence

public snapshot

AI called this Clean at 92.0% confidence as Benign with low false-positive risk.

Evidence for AI clean decision

The install hook invokes a separate script that prints a welcome screen and exits when CI or its skip flag is set.
The hinted workspace location defines Avatar marker paths and checks for those markers.
AI setup presents the NAL gateway and Anthropic direct API as provider choices. The NAL flow accepts a base URL and sends the supplied key there for verification, then saves the chosen settings to the workspace's Claude settings file.
The doctor probe runs through an explicit CLI diagnostic, can be skipped, and sends an account token with a probe request to the package's telemetry endpoint.

Evidence against

Behavioral surface

Source

ChildProcessEnvironmentVarsFilesystemNetworkShell

Supply chain

HighEntropyStringsMinifiedPossibleObfuscationUrlStrings

Manifest

NoLicense

Source & flagged code

9 flagged

package.jsonView file

Lines 21-61json

21 "README.md"

22 ],

23 "engines": {

24 "node": ">=18.17.0"

25 },

26 "scripts": {

27 "build": "tsup && tsc -p tsconfig.core-dts.json",

28 "dev": "tsup --watch",

29 "test": "AUTOPILOT_PACK_FIXTURES_DIR=\"${AUTOPILOT_PACK_FIXTURES_DIR:-$PWD/../team-ai-pack/tests/fixtures}\" vitest run --passWithNoTests --exclude 'test/integration/**' --testTimeout=15000",

30 "test:watch": "vitest --exclude 'test/integration/**'",

31 "test:e2e": "npm run build && vitest run --passWithNoTests test/integration --testTimeout=60000",

32 "test:all": "npm run test && npm run test:e2e",

33 "lint": "biome check src test scripts",

34 "format": "biome format --write src test scripts",

35 "typecheck": "tsc --noEmit",

36 "check:release-docs": "node scripts/check-unreleased-version-notice-removed.mjs",

37 "schemas:generate": "tsx scripts/autopilot-schemas/generate-json-schemas.ts",

38 "hooks:install": "git config core.hooksPath githooks",

39 "prepare": "git config core.hooksPath githooks || true",

40 "prepublishOnly": "npm run check:release-docs && npm run lint && npm run typecheck && npm run build && npm run test:all",

41 "postinstall": "node ./bin/postinstall.js"

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L41

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg · L41

42 },

43 "dependencies": {

44 "@inquirer/prompts": "^8.5.2",

45 "@napi-rs/keyring": "^1.1.0",

46 "boxen": "^8.0.0",

47 "chalk": "^5.3.0",

48 "cli-highlight": "^2.1.11",

49 "cli-table3": "^0.6.3",

50 "clipboardy": "^5.3.1",

51 "commander": "^15.0.0",

52 "diff": "^9.0.0",

53 "fast-glob": "^3.3.2",

54 "open": "^11.0.0",

55 "ora": "^9.4.0",

56 "simple-git": "^3.22.0",

57 "zod": "4.4.3"

58 },

59 "devDependencies": {

60 "@biomejs/biome": "2.5.0",

61 "@types/diff": "^7.0.2",

dist/index.jsView file

•matchType = previous_version_dangerous_delta matchedPackage = @nalvietnam/avatar-cli@3.36.1 matchedIdentity = npm:QG5hbHZpZXRuYW0vYXZhdGFyLWNsaQ:3.36.1 similarity = 0.875 summary = stored previous version shares package body but lacks this dangerous source file

Critical

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version; route for source-aware review.

dist/index.jsView on unpkg

10`),plain:e=>Xo(`${e} L11: `)}});var Fn={};Oe(Fn,{atomicSwapDir:()=>Zo,computeFileSha256:()=>ei,copyDirRecursive:()=>Qo,downloadFile:()=>Xd,ensureDir:()=>b,extractTarballToDir:()=>Qd,pathExists:()=>g,readJso... L12: `,n)}async function Qo(e,t,n=[]){await b(t);let r=await ge.readdir(e,{withFileTypes:!0});for(let o of r){if(n.includes(o.name))continue;let i=qs(e,o.name),s=qs(t,o.name);if(o.isDir...

High

Child Process

Package source references child process execution.

dist/index.jsView on unpkg · L10

319`),t&&process.stdout.write(` D\u1EF1 ki\u1EBFn: ${w.cyan(t)} L320: `),process.exit(0)}}function ND(e){e.command("mcp-run <tool-id>",{hidden:!0}).description("[internal] Spawn MCP v\u1EDBi secrets injected (M09)").action(Dn("mcp-run","Milestone 09"... L321: `),0;t.spawnDetached(n.command,n.args)}catch(n){if(e.verbose){let r=n instanceof Error?n.message:String(n);t.stderr(`avatar notify: l\u1ED7i \u2014 ${r}

High

Shell

Package source references shell execution.

dist/index.jsView on unpkg · L319

Source & flagged code

9 flagged · loading source

package.jsonView file

•scripts.postinstall = node ./bin/postinstall.js

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node ./bin/postinstall.js

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg

dist/index.jsView file

Critical

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version; route for source-aware review.

Findings

1 Critical7 High4 Medium6 Low

CriticalPrevious Version Dangerous Deltadist/index.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/index.js

HighShelldist/index.js

HighSame File Env Network Executiondist/index.js

HighCredential Redirect Persistencedist/index.js

HighCommand Output Exfiltrationdist/index.js

HighTrigger Reachable Command Output Exfiltrationdist/index.js

MediumAmbiguous Install Lifecycle Scriptpackage.json

MediumNetwork

MediumEnvironment Vars

MediumStructural Risk Force Deep Review

LowNon Install Lifecycle Scripts

Affected versions and remediation

This report applies to @nalvietnam/avatar-cli@3.36.2.

See all versions of @nalvietnam/avatar-cli for other recorded verdicts.

Review the evidence and your use of @nalvietnam/avatar-cli@3.36.2 before allowing it. Restrict the permissions described in this report.
Choose an independently verified alternative or release. This report does not establish that other versions are safe.

Evidence last updated: 2026-10-14 14:42:08.275Z (UTC).

Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.