registry / @nalvietnam/avatar-cli / 3.25.1

@nalvietnam/avatar-cli@3.25.1

AI harness CLI for NAL Vietnam engineering

AI Security Review

scanned 2mo ago · by lpm-firewall-ai

Source inspection found no malicious postinstall behavior, harvesting, or exfiltration. The package nevertheless creates a first-party AI-agent extension surface from remotely delivered content under explicit user commands, with optional integrity verification.

Static reason

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

Trigger

User runs `avatar init` or `avatar sync`.

Impact

A compromised or unsigned remote pack could gain capabilities through the project’s Claude Code extension paths.

Mechanism

remote AI-pack download and project `.claude` symlink setup

AI rationale

Evidence

package.jsonbin/postinstall.jsdist/index.jssrc/templates/CLAUDE.md.tplsrc/templates/settings.json.tpl.claude/pack.claude/skills.claude/agents.claude/commands.claude/hooks.claude/workflows.claude/scripts

Network endpoints1

qpdbkewtpkkbcrptnlos.supabase.co/functions/v1/get-pack

Decision evidence

public snapshot

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

Evidence for warning

Explicit `avatar init`/`sync` downloads a remote team AI pack and mounts its capabilities into Claude Code paths.
The remote pack is installed even when the backend omits a SHA-256 digest, leaving a remote capability supply-chain risk.
Sync can replace project `.claude` mount directories with symlinks; `--force` first renames existing directories to backups.

Evidence against

`postinstall` only imports and prints a local welcome screen; it performs no network, shell, or file mutation.
Agent configuration occurs through explicit CLI commands, not npm install-time execution.
Pack endpoint requires HTTPS and restricts hosts to the package vendor domain/Supabase endpoint.

Behavioral surface

Source

ChildProcessEnvironmentVarsFilesystemNetwork

Supply chain

HighEntropyStringsMinifiedUrlStrings

Manifest

NoLicense

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-30javascript

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

2var Xu=Object.defineProperty;var M=(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.25.1.

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

Review the evidence and your use of @nalvietnam/avatar-cli@3.25.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:38.701Z (UTC).

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