Loading npm security reports…

@devflow-tools/devflow@0.18.9: AI-agent control-surface risk | LPM Firewall

registry / @devflow-tools/devflow / 0.18.9

@devflow-tools/devflow@0.18.9

Installable DevFlow distribution containing the CLI, runtime hooks, and Claude plugin.

AI Security Review

scanned 3h ago · by lpm-firewall-ai

LPM flags this version as an AI-agent control-surface risk. Installing the package silently changes the consumer project's Claude Code hook configuration. The added wildcard hook launches package code before every tool use.

Static reason

High-risk behavior combination matched malicious policy.; source matched previously finalized malicious package; routed for review; source fingerprint signature matched known malicious package; routed for review

Trigger

npm installation runs the postinstall lifecycle hook.

Impact

The package gains automatic execution in the consumer's AI-agent tool workflow without an explicit setup command or consent.

Mechanism

Automatic wildcard Claude Code PreToolUse hook registration.

Policy narrative

During npm postinstall, the package searches upward for the consumer project, creates .claude if needed, merges hooks.json, and adds a matcher '*' PreToolUse command. That command executes dist/hooks/pre-tool-use.js before every Claude Code tool call. This is an unconsented install-time mutation of a broad AI-agent control surface.

Rationale

The automatic postinstall lifecycle mutates the consumer's Claude Code configuration and registers package code for every tool action. This meets the policy threshold for malicious AI-agent control-surface hijacking.

Evidence

package.jsonscripts/postinstall.js.claude.claude/hooks.jsondist/hooks/pre-tool-use.js

Decision evidence

public snapshot

Source & flagged code

13 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/postinstall.js

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/postinstall.js

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg

dist/plugin/dist/hooks/hook-daemon.jsView file

1import {createServer,createConnection}from'net';import {createHash,randomUUID as randomUUID$1}from'node:crypto';import {execFileSync,spawn}from'node:child_process';import {dirname,... L2: `;rotateDiagnosticLogFile({path:n,maxBytes:50*1024*1024,maxFiles:5,incomingBytes:Buffer.byteLength(o)}),appendFileSync(n,o);}catch{}}function bi(e){return new Promise(t=>setTimeout...

High

Child Process

Package source references child process execution.

dist/plugin/dist/hooks/hook-daemon.jsView on unpkg · L1

•matchType = normalized_sha256 matchedPackage = @devflow-tools/devflow@0.18.10 matchedPath = dist/hooks/hook-daemon.js matchedIdentity = npm:QGRldmZsb3ctdG9vbHMvZGV2Zmxvdw:0.18.10 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/plugin/dist/hooks/hook-daemon.jsView on unpkg

dist/cli.jsView file

241${S.green("\u2713")} ${n} deactivated and uninstalled`);}catch(o){console.error(` L242: ${S.red("\u2717")} Uninstallation failed: ${o.message}`),process.exitCode=1;}});});function Xt(e){let t=join(e,".devflow","config.json");if(existsSync(t))try{let n=readFileSync(t,"... L243: `));}let n=Xt(t);console.error(S.blue(`DevFlow init \u2014 mode: ${n}`));let{initProject:o,renderInitReport:r}=await Promise.resolve().then(()=>(Fo(),Lo)),s=await o(t,{force:e.forc...

High

Shell

Package source references shell execution.

dist/cli.jsView on unpkg · L241

1#!/usr/bin/env node L2: import {readFileSync as readFileSync$1,existsSync as existsSync$1,mkdirSync as mkdirSync$1,renameSync,readdirSync,rmSync,cpSync,lstatSync,writeFileSync as writeFileSync$1,statSync ... L3: `)}var Ro=D(()=>{});function xt(){let e=dirname(fileURLToPath(import.meta.url)),t=[join$1(e,"..","plugin-files"),join$1(e,"plugin"),join$1(e,"..","..","dist","plugin-files"),join$1... ... L7: `);}function Ti(e,t,n){let o=join$1(e,"..","installed_plugins.json"),r={version:2,plugins:{}};if(existsSync$1(o)){let f;try{f=JSON.parse(readFileSync$1(o,"utf-8"));}catch{throw new... L8: `);}function de(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function Mi(e,t){let n=join$1(e,"package.json");if(!existsSync$1(n))return;let o=JSON.parse(readFileSync$1... L9: `)}var $o,Ki,Fo=

High

Same File Env Network Execution

A single source file combines environment access, network access, and code or shell execution; review context before blocking.

dist/cli.jsView on unpkg · L1

•matchType = normalized_sha256 matchedPackage = @devflow-tools/devflow@0.18.10 matchedPath = dist/cli.js matchedIdentity = npm:QGRldmZsb3ctdG9vbHMvZGV2Zmxvdw:0.18.10 similarity = 1.000 summary = normalized source hash matched finalized malicious source

scripts/postinstall.jsView file

2Install-time AI-agent control hijack evidence: L2: // L3: // Auto-configures .claude/hooks.json in the consuming project so that Claude L4: // Code invokes the devflow PreToolUse hook on every tool call. ... L11: L12: import { writeFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs'; L13: import { join, dirname } from 'node:path'; ... L55: L56: const claudeDir = join(projectRoot, '.claude'); L57: const hooksFile = join(claudeDir, 'hooks.json'); ... L59: L60: // 1. Ensure .claude/ directory exists L61: if (!existsSync(claudeDir)) { Payload evidence from dist/plugin/dist/skills/devflow:animation/SKILL.md: L54: L55: 以下版本描述知识源，不代表目标项目版本；目标项目的 package.json 与 lockfile 证据始终优先。 L56: L57: - animation-docs: 2024 — https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_animations L58:

Critical

Ai Agent Control Hijack

Source creates an unconsented AI-agent control surface through install-time mutation or a default unauthenticated remote skill channel.

scripts/postinstall.jsView on unpkg · L2

•Manifest-trigger-reachable source links an external AI-agent control path to a behavior-bearing write operation. import { writefilesync, existssync, mkdirsync, readfilesync } from 'node:fs'; import { join, dirname } from 'node:path'; import { fileurltopath } from 'node:url'; const tag = '[devflow]'; function findprojectroot() { let dir = process.cwd(); for (let i = 0; i < 10; i++) { const pkgjson = join(dir, 'package.json'); const nodemodules = join(dir, 'node_modules'); if (existssync(pkgjson) && existssync(nodemodules)) { return dir; } const parent = dirname(dir); if (parent === dir) break;

High

Trigger Reachable External Ai Agent Control Surface Mutation

Manifest-trigger-reachable source writes behavior-bearing configuration into a user or project AI-agent control surface.

dist/hooks/user-prompt-submit.js#virtual:normalized:round1View file

•stage = ast_semantic_analysis; reason = ast_parse_error; limitedFiles = 2

High

Semantic Analysis Limited

A bounded semantic-analysis stage reached its safety limit; remaining detectors completed, but this package requires AI review.

dist/hooks/user-prompt-submit.js#virtual:normalized:round1View on unpkg

dist/hooks/hook-daemon.jsView file

•matchType = normalized_sha256 matchedPackage = @devflow-tools/devflow@0.18.10 matchedPath = dist/hooks/hook-daemon.js matchedIdentity = npm:QGRldmZsb3ctdG9vbHMvZGV2Zmxvdw:0.18.10 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/hooks/hook-daemon.jsView on unpkg

dist/dashboard/_next/static/chunks/237-34a3fbfba7ff0de5.jsView file

•matchType = normalized_sha256 matchedPackage = @devflow-tools/devflow@0.18.10 matchedPath = dist/dashboard/_next/static/chunks/237-34a3fbfba7ff0de5.js matchedIdentity = npm:QGRldmZsb3ctdG9vbHMvZGV2Zmxvdw:0.18.10 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/dashboard/_next/static/chunks/237-34a3fbfba7ff0de5.jsView on unpkg

Source & flagged code

13 flagged

package.jsonView file

Lines 1-38json

1{

2 "name": "@devflow-tools/devflow",

3 "version": "0.18.9",

4 "type": "module",

5 "description": "Installable DevFlow distribution containing the CLI, runtime hooks, and Claude plugin.",

6 "bin": {

7 "devflow": "./bin/devflow"

8 },

9 "scripts": {

10 "build": "tsup",

11 "bundle:dashboard": "test -f ../../apps/dashboard/out/index.html || npm run build -w apps/dashboard; rm -rf dist/dashboard && mkdir -p dist/dashboard && cp -R ../../apps/dashboard/out/. dist/dashboard/",

12 "audit-session-data": "node --import tsx scripts/audit-session-data.ts",

13 "maintain:semantic-reliability": "node --import tsx scripts/semantic-reliability-maintenance.ts",

14 "build:watch": "tsup --watch",

15 "clean": "rm -rf dist",

16 "postbuild": "cp ../../apps/server/public/fallback.html dist/fallback.html && node --import tsx scripts/bundle-plugin.ts",

17 "prepack": "npm run build && npm run bundle:dashboard",

18 "postinstall": "node scripts/postinstall.js"

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L18

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L18

19 },

20 "dependencies": {

21 "@colbymchenry/codegraph": "^1.1.1",

22 "@devflow-tools/adapters": "0.18.9",

23 "@devflow-tools/benchmark": "0.18.9",

24 "@devflow-tools/context-engine": "0.18.9",

25 "@devflow-tools/database": "0.18.9",

26 "@devflow-tools/delivery-line": "0.18.9",

27 "@devflow-tools/knowledge-engine": "0.18.9",

28 "@devflow-tools/mcp-server": "0.18.9",

29 "@devflow-tools/memory-engine": "0.18.9",

30 "@devflow-tools/retrieval-engine": "0.18.9",

31 "@devflow-tools/sdk": "0.18.9",

32 "@devflow-tools/semantic-engine": "0.18.9",

33 "@devflow-tools/server": "0.18.9",

34 "@devflow-tools/task-runtime": "0.18.9",

35 "@devflow-tools/telemetry": "0.18.9",

36 "@devflow-tools/workflow-engine": "0.18.9",

37 "@inquirer/prompts": "^7.10.1",

38 "@modelcontextprotocol/sdk": "^1.30.0",

dist/plugin/dist/hooks/hook-daemon.jsView file

Lines 1-21javascript

1import {createServer,createConnection}from'net';import {createHash,randomUUID as randomUUID$1}from'node:crypto';import {execFileSync,spawn}from'node:child_process';import {dirname,join as join$1}from'path';import {mkdirSync,lstatSync,openSync,writeFileSync,fstatSync,closeSync,readFileSync,unlinkSync,existsSync

dist/cli.jsView file

Lines 1-21javascript

1#!/usr/bin/env node

2import {readFileSync as readFileSync$1,existsSync as existsSync$1,mkdirSync as mkdirSync$1,renameSync,readdirSync,rmSync,cpSync,lstatSync,writeFileSync as writeFileSync$1,statSync as statSync$1,realpathSync,mkdtempSync,rmdirSync,openSync,constants,fstatSync,readSync,closeSync}from'node:fs';import {Command}from'commander';import {DeliveryLineError}from'@devflow-tools/delivery-line'

scripts/postinstall.jsView file

Lines 1-22javascript

1// packages/devflow/scripts/postinstall.js

2//

3// Auto-configures .claude/hooks.json in the consuming project so that Claude

4// Code invokes the devflow PreToolUse hook on every tool call.

5//

6// This file is plain ESM JavaScript (not TypeScript) because it must run during

7// `npm install` before any build step has compiled the package.

8//

9// If anything goes wrong we log a warning and exit 0 — we must never break a

10// user's `npm install`.

dist/hooks/user-prompt-submit.js#virtual:normalized:round1View file

•stage = ast_semantic_analysis; reason = ast_parse_error; limitedFiles = 2

High

Semantic Analysis Limited

A bounded semantic-analysis stage reached its safety limit; remaining detectors completed, but this package requires AI review.

dist/hooks/user-prompt-submit.js#virtual:normalized:round1View on unpkg

dist/hooks/hook-daemon.jsView file

•matchType = normalized_sha256 matchedPackage = @devflow-tools/devflow@0.18.10 matchedPath = dist/hooks/hook-daemon.js matchedIdentity = npm:QGRldmZsb3ctdG9vbHMvZGV2Zmxvdw:0.18.10 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/hooks/hook-daemon.jsView on unpkg

dist/dashboard/_next/static/chunks/237-34a3fbfba7ff0de5.jsView file

•matchType = normalized_sha256 matchedPackage = @devflow-tools/devflow@0.18.10 matchedPath = dist/dashboard/_next/static/chunks/237-34a3fbfba7ff0de5.js matchedIdentity = npm:QGRldmZsb3ctdG9vbHMvZGV2Zmxvdw:0.18.10 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

dist/dashboard/_next/static/chunks/237-34a3fbfba7ff0de5.jsView on unpkg

Lines 221-245javascript

221Stored: ${getGlobalDevFlowDbPath()} (${r.runId})`}async function kd(e={}){let t=e.database??openGlobalDevFlowDatabase(),n,o=null;try{n=e.runId?t.getBenchmarkReport(e.runId):t.getLatestBenchmarkReport(),e.baselineRunId&&(o=t.getBenchmarkReport(e.baselineRunId));}finally{e.database||t.close();}if(!n)throw new Error(e.runId?`Benchmark report "${e.runId}" not found`:"No benchmark reports found. Run `devflow benchmark run` first.");if(e.baselineRunId&&!o)throw new Error(`Benchmark baseline "${e.baselineRunId}" not found`);let r=e.output??"text",s=renderBenchmarkReport(n,r);if(!o||r==="json")return ...

222## Change From Prior Baseline

223

224${i.map(a=>`- ${a}`).join(`

225`)}

226`:`${s}

227

228Change from ${o.runId}:

229${i.map(a=>`- ${a}`).join(`

230`)}`}function wd(e,t){let n=e.summary.devflow,o=t.summary.devflow;return [Vt("tokensUsed",n.avgTokensUsed,o.avgTokensUsed,false),Vt("filesTouched",n.avgFilesTouched,o.avgFilesTouched,false),Vt("correctnessScore"

231`)}var Fs=D(()=>{});var bt={};j(bt,{resolveRuntimeLocale:()=>Ws,runtimeMessage:()=>X,runtimeMessages:()=>Hs});function Ws(e=process.env){return (e.DEVFLOW_LANG?.trim()||Intl.DateTimeFormat().resolvedOptions().locale).toLowerCase().startsWith("zh")?"zh":"en"}function X(e,t={},n){return Hs[Ws(n)][e].replace(/\{(\w+)\}/gu,(o,r)=>String(t[r]??`{${r}}`))}var Hs,Ce=D(()=>{Hs={en:{starting:"Starting the DevFlow Runtime...",ready:"Dashboard ready at {url}",reused:"Reused the existing DevFlow Runtime.",stopped:"DevFlow Runtime stopped.",notRunning:"No DevFlow Runtime is running.",portInUse:"Port {port} ...

232Run "devflow plugin list" to see available plugins.`);return}console.log(`Installed plugins:

233`),n.forEach(o=>{let r=t.plugins.find(s=>s.name===o);r?(console.log(` ${S.green(r.name)}@${r.version}`

234`);let n=Math.max(...t.plugins.map(o=>o.name.length));t.plugins.forEach(o=>{let r=" ".repeat(n-o.name.length+2);console.

235Install a plugin: devflow plugin install <name>`);}});});var Xs={};j(Xs,{pluginSearchCommand:()=>eg});var eg,ei=D(()=>{jt();eg=new Command("search").description("Search for plugins").argument("<keyword>"

236Try: devflow plugin list`);return}console.log(`Found ${o.length} plugin(s) matching "${e}":

237`),o.forEach(r=>{console.log(` ${S.green(r.name)}@${r.version}`),console.log(` ${r.description}`),r.tags.length>0

238${S.green("\u2713")} ${n}@${o.version} installed and activated`),console.log(`

239Run "devflow plugin list --installed" to verify.`);}catch(o){console.error(`

240${S.red("\u2717")} Installation failed: ${o.message}`),process.exitCode=1;}});});var si={};j(si,{pluginUninstallCommand:()=>rg});var rg,ii=D(()=>{Se();rg=new Command("uninstall").description("Uninstall a plugin").argument("<name>","Plugin name (with or without @devflow-tools/ prefix)").action(async e=>{let n=`@devflow-tools/plugin-${e.replace(/^@devflow-tools\/(?:plugin-)?/,"")}`;console.log(`Uninstalling ${n}...`);try{await un(n,process.cwd(),!0),console.log(`

241${S.green("\u2713")} ${n} deactivated and uninstalled`);}catch(o){console.error(`

242${S.red("\u2717")} Uninstallation failed: ${o.message}`),process.exitCode=1;}});});function Xt(e){let t=join(e,".devflow","config.json");if(existsSync(t))try{let n=readFileSync(t,"utf-8");if(JSON.parse(n).serverUrl)return "server"}catch{}return "local"}var ai=createRequire(import.meta.url),mo="0.0.0";try{mo=ai("../package.json").version;}catch{try{mo=ai("../../package.json").version;}catch{}}var E=new Command,cg=await Promise.resolve().then(()=>(wo(),ko));E.addCommand(cg.createDefaultDeliveryCommand());function lg(e){let t=new URL(e);if(t.protocol!=="http:"||t.hostname!=="127.0.0.1")return Pro ...

243`));}let n=Xt(t);console.error(S.blue(`DevFlow init \u2014 mode: ${n}`));let{initProject:o,renderInitReport:r}=await Promise.resolve().then(()=>(Fo(),Lo)),s=await o(t,{force:e.force,plugins:e.plugins!==

244 ${e} docs synced to .devflow/knowledge/${e}/`));}else {let r=await o.getSources();for(let s of r){let i=await o.syncDocs(s.source.name);for(let a of i)a.added>0?console.log(` ${S.green("\u2713")} ${a.source} \u2192 ${a.added} chunks`):console.log(` ${S.red("\u2717")} ${a.source} \u2014 ${a.errors.join(", ")||"no content"}`);}console.log(S.green(`

245 All docs synced.`));}});fo.command("backfill-vectors").description("Backfill missing knowledge chunk vectors").option("--source <name>","Only backfill one knowledge source").option("--batch-size <count>","Embedding batch size","32").action(async e=>{let{backfillKnowledgeVectors:t}=await Promise.resolve().then(()=>(Nn(),An)),n=await t({source:e.source,batchSize:Number.parseInt(e.batchSize,10),onProgress:({processed:o,remaining:r})=>{console.log(` vectors: ${o} processed, ${r} remaining`);}});console.log(S.green(`Knowledge vectors ready: ${n.processed} added, ${n.remaining} remaining`));});fo ...

Long lines were clipped for display.