registry / @nalvietnam/avatar-cli / 3.24.1

@nalvietnam/avatar-cli@3.24.1

AI harness CLI for NAL Vietnam engineering

AI Security Review

scanned 2mo ago · by lpm-firewall-ai

The package presents a real first-party AI-extension lifecycle risk through remotely supplied, softly verified packs. Source inspection found no concrete malware behavior, covert exfiltration, or unconsented install-time control-surface mutation.

Static reason

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

Trigger

User runs avatar init, avatar sync, or tools enable.

Impact

A compromised or changed pack service could influence enabled workspace AI hooks/settings.

Mechanism

Remote pack installation and first-party Claude workspace configuration.

AI rationale

Evidence

package.jsonbin/postinstall.jsdist/index.jsREADME.md.claude/pack/.claude/settings.jsonCLAUDE.md.claude/avatar-tools.json

Network endpoints2

qpdbkewtpkkbcrptnlos.supabase.co/functions/v1/get-packqpdbkewtpkkbcrptnlos.supabase.co/functions/v1/auth-device

Decision evidence

public snapshot

AI called this Suspicious at 88.0% confidence as Dangerous Capability with medium false-positive risk.

Evidence for warning

Explicit avatar init/sync downloads a remote team pack into .claude/pack/; the documented digest check is soft and permits installation without a digest.
Runtime commands merge pack-provided settings/hooks and manage Claude workspace files, creating an agent-extension supply-chain capability.
The install-time postinstall only imports and prints a welcome screen; no install-time agent-config mutation was found.

Evidence against

No credential harvesting or unrelated command-output exfiltration was established.
Remote endpoints are package-aligned Supabase auth/pack services, not covert third-party collectors.
AI-control-surface writes are user-invoked CLI behavior, not preinstall/install/postinstall behavior.

Behavioral surface

Source

ChildProcessEnvironmentVarsFilesystemNetwork

Supply chain

HighEntropyStringsMinifiedUrlStrings

Manifest

Source & flagged code

7 flagged

package.jsonView file

Lines 12-52json

12 "src/templates",

13 "README.md"

14 ],

15 "engines": {

16 "node": ">=18.17.0"

17 },

18 "scripts": {

19 "build": "tsup",

20 "dev": "tsup --watch",

21 "test": "vitest run --passWithNoTests --exclude 'test/integration/**' --testTimeout=15000",

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

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

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

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

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

27 "typecheck": "tsc --noEmit",

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

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

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

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

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

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L32

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L32

33 },

34 "dependencies": {

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

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

37 "boxen": "^8.0.0",

38 "chalk": "^5.3.0",

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

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

41 "clipboardy": "^5.3.1",

42 "commander": "^15.0.0",

43 "diff": "^9.0.0",

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

45 "open": "^11.0.0",

46 "ora": "^9.4.0",

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

48 "zod": "^4.4.3"

49 },

50 "devDependencies": {

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

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

dist/index.jsView file

Lines 1-27javascript

1// @nalvietnam/avatar-cli — built with tsup

2var ou=Object.defineProperty;var R=(t,e)=>()=>(t&&(e=t(t=0)),e);var

Source & flagged code

7 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

•matchType = previous_version_dangerous_delta matchedPackage = @nalvietnam/avatar-cli@3.23.1 matchedIdentity = npm:QG5hbHZpZXRuYW0vYXZhdGFyLWNsaQ:3.23.1 similarity = 0.750 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.

Findings

1 Critical5 High4 Medium6 Low

CriticalPrevious Version Dangerous Deltadist/index.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/index.js

HighSame File Env Network Executiondist/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

LowScripts Present

LowFilesystem

LowHigh Entropy Strings

Affected versions and remediation

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

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

Review the evidence and your use of @nalvietnam/avatar-cli@3.24.1 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-08-22 06:56:39.342Z (UTC).

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