dokugen@14.2.1
Readme generator command line tool.
AI Security Review
scanned 11d ago · by lpm-firewall-aiThe package has a concrete credential-forwarding risk: README generation sends a stored GitHub token to a backend that can be set through environment variables. Since this occurs through a user-invoked feature and the source does not establish malicious default exfiltration, warn rather than block.
Static reason
High-risk behavior combination matched malicious policy.
Trigger
User invokes README generation with a stored GitHub token and a configured backend endpoint.
Impact
A configured endpoint outside the intended service can receive the existing GitHub token and project data.
Mechanism
The command attaches a Bearer token from local Dokugen config to a request whose backend may come from environment variables.
AI rationale
The package has a concrete credential-forwarding risk: README generation sends a stored GitHub token to a backend that can be set through environment variables. Since this occurs through a user-invoked feature and the source does not establish malicious default exfiltration, warn rather than block.
Evidence
dist/bin/helpers/readme.mjsdist/bin/helpers/network.mjsdist/bin/helpers/auth.mjs
Network endpoints3
dokugen.samueltuoyo.com/api/get-server-urlBACKEND_DOMAINDOKUGEN_LOCAL_BACKEND_DOMAIN
Decision evidence
public snapshotAI called this Suspicious at 92.0% confidence as Dangerous Capability with medium false-positive risk.
Evidence for warning
- The README generation command sends project files and compressed source to a backend.
- The backend can be selected through environment variables, and the request uses a stored GitHub access token as a Bearer credential.
- The postinstall hook only attempts a platform-gated chmod on ./bin/dokugen.ts.
Evidence against
- The credential forwarding is tied to invoking the README generation command; inspected source does not show it running during installation.
- The default backend lookup uses the Dokugen service, and the package is a README generator.
Behavioral surface
ChildProcessCryptoEnvironmentVarsFilesystemNetworkShell
HighEntropyStringsUrlStrings
Source & flagged code
5 flagged · loading sourcepackage.jsonView file
•scripts.postinstall = node -e "import('fs').then(fs => { if (fs.existsSync('dist/scripts/postinstall.mjs')) import('./dist/scripts/postinstall.mjs'); }).catch(() => {})"
Critical
Red Install Lifecycle Script
Install-time lifecycle script matches a deterministic static-gate block pattern.
package.jsonView on unpkg•scripts.postinstall = node -e "import('fs').then(fs => { if (fs.existsSync('dist/scripts/postinstall.mjs')) import('./dist/scripts/postinstall.mjs'); }).catch(() => {})"
High
Install Time Lifecycle Scripts
Package defines install-time lifecycle scripts.
package.jsonView on unpkgdist/bin/commands/changelog.mjsView file
1import { execFileSync, execSync } from "node:child_process";
L2: import path from "node:path";
High
Child Process
Package source references child process execution.
dist/bin/commands/changelog.mjsFindings
1 Critical4 High3 Medium5 Low
CriticalRed Install Lifecycle Scriptpackage.json
HighInstall Time Lifecycle Scriptspackage.json
HighChild Processdist/bin/commands/changelog.mjs
HighShell
HighSame File Env Network Executiondist/bin/helpers/readme.mjs
MediumNetwork
MediumEnvironment Vars
MediumStructural Risk Force Deep Review
LowScripts Present
LowWeak Cryptodist/bin/helpers/fileOps.mjs
LowFilesystem
LowHigh Entropy Strings
LowUrl Strings
Affected versions and remediation
This report applies to dokugen@14.2.1.
See all versions of dokugen for other recorded verdicts.
- Review the evidence and your use of dokugen@14.2.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: .
Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.