registry / @decocms/blocks-cli / 7.17.1

@decocms/blocks-cli@7.17.1

Deco codegen (generate-blocks, generate-schema, generate-invoke) and Fresh-to-TanStack migration tooling

AI Security Review

scanned 2h ago · by lpm-firewall-ai

Review flagged AI-agent configuration or capability changes. This remains warn-only unless evidence shows foreign-agent hijack through preinstall/install/postinstall, hidden persistence, exfiltration, remote code execution, or other concrete malicious behavior.

Static reason

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

Trigger

User runs `deco-migrate` without `--dry-run`.

Impact

Future Cursor sessions in the migrated project load the package-authored policy pointer.

Mechanism

Scaffolds a persistent always-applied Cursor policy pointer.

Rationale

The package is not malicious by the blocking standard, but it has a real explicit-command AI-agent control-surface mutation. Flag as warn so users can review the migration's persistent Cursor rule.

Evidence

package.jsonscripts/migrate.tsscripts/migrate/phase-scaffold.tsscripts/migrate/templates/cursor-rules.tsscripts/sync-blocks-to-kv.tsscripts/lib/cf-kv-rest.ts.cursor/rules/migration-tooling-policy.mdcwrangler.jsonc

Decision evidence

public snapshot

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

Evidence for warning

`scripts/migrate/phase-scaffold.ts` writes `.cursor/rules/migration-tooling-policy.mdc` during migration.
`scripts/migrate/templates/cursor-rules.ts` marks that Cursor rule `alwaysApply: true` and points agents to upstream policy.
`scripts/migrate.ts` runs the scaffold after an explicit `deco-migrate` invocation; default mode writes project files.

Evidence against

`package.json` has no preinstall, install, postinstall, or prepare lifecycle hook.
The Cursor rule is created only by the user-invoked migration CLI and supports `--dry-run`.
No credential harvesting, remote payload loading, eval/vm use, or unconsented package-install execution was found.
KV and purge networking in `scripts/sync-blocks-to-kv.ts` requires explicit CLI options and configured credentials.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShell

Supply chain

HighEntropyStringsUrlStrings

Manifest

NoLicense

scanned 108 file(s), 1.13 MB of source, external domains: analytics.tiktok.com, api.cloudflare.com, bat.bing.com, cdn.example.com, connect.facebook.net, deco-otel-ingest.deco-cx.workers.dev, deco-otel-ingest.example, decoims.com, github.com, graph.instagram.com, ingest.example, ingest.example.com, s.lilstts.com, script.hotjar.com, scripts.clarity.ms, sp.vtex.com, static.hotjar.com, storage.googleapis.com, tailwindcss.com, www.clarity.ms, www.googletagmanager.com

Source & flagged code

5 flagged

scripts/audit-observability-config.test.tsView file

Lines 289-329typescript

289});

290

291describe("CLI gate hardness (D-16) — --mode warn|block + --github", () => {

292 let tmpdir: string;

293 const cliPath = path.resolve(__dirname, "audit-observability-config.ts");

294

295 beforeEach(() => {

296 tmpdir = fs.mkdtempSync(path.join(os.tmpdir(), "audit-mode-"));

297 });

298 afterEach(() => {

299 fs.rmSync(tmpdir, { recursive: true, force: true });

300 });

301

302 // Spawn the script via tsx in a child process so we exercise the real

303 // `process.exit()` paths instead of monkey-patching them. This is the

304 // contract storefront CI consumes, so it's the contract under test.

305 function runCli(args: string[]): {

306 status: number | null;

307 stdout: string;

308 stderr: string;

309 } {

310 const { spawnSync } = require("node:child_process") as typeof import(

311 "node:child_process"

High

Child Process

Package source references child process execution.

scripts/audit-observability-config.test.tsView on unpkg · L309

Medium

Dynamic Require

Package source references dynamic require/import behavior.

scripts/audit-observability-config.test.tsView on unpkg · L309

312 );

313 const result = spawnSync(

314 process.execPath,

315 [

316 require.resolve("tsx/cli"),

317 cliPath,

318 "--source",

319 tmpdir,

320 ...args,

321 ],

322 { encoding: "utf8" },

323 );

324 return {

325 status: result.status,

326 stdout: result.stdout,

327 stderr: result.stderr,

328 };

329 }

scripts/sync-blocks-to-kv.tsView file

Lines 57-97typescript

57import { readDecofileFromDir } from "./lib/read-decofile";

58import { changedBlockFiles, changedBlockKeys, purgePathsForChangedKeys } from "./lib/sync-helpers";

60const DEFAULT_RETAIN = 10;

62function parseArgs(argv: string

scripts/generate-invoke.test.tsView file

Lines 200-240typescript

200 // `--apps-dir node_modules/@decocms/apps-vtex/src` by hand (granadobr's

201 // migration workaround). The default must probe <pkg>/invoke.ts first,

202 // then <pkg>/src/invoke.ts.

203

204 function makeSite(layout: "root" | "src"): { siteDir: string; cleanup:

scripts/generate-schema.test.tsView file

•matchType = previous_version_dangerous_delta matchedPackage = @decocms/blocks-cli@7.16.8 matchedIdentity = npm:QGRlY29jbXMvYmxvY2tzLWNsaQ:7.16.8 similarity = 0.981 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.

scripts/generate-schema.test.tsView on unpkg

Source & flagged code

5 flagged · loading source

scripts/audit-observability-config.test.tsView file

309} { L310: const { spawnSync } = require("node:child_process") as typeof import( L311: "node:child_process"

High

Child Process

Package source references child process execution.

scripts/audit-observability-config.test.tsView on unpkg · L309

309} { L310: const { spawnSync } = require("node:child_process") as typeof import( L311: "node:child_process"

Medium

Dynamic Require

Package source references dynamic require/import behavior.

scripts/audit-observability-config.test.tsView on unpkg · L309

scripts/sync-blocks-to-kv.tsView file

77purgeUrl: val("--purge-url", ""), L78: purgeToken: val("--purge-token", process.env.PURGE_TOKEN ?? ""), L79: }; ... L82: function gitChangedFiles(since: string, blocksDir: string): string[] { L83: const out = execSync(`git diff --name-only ${since} HEAD`, { encoding: "utf-8" }); L84: return changedBlockFiles(out, blocksDir); ... L87: async function purgeCache(origin: string, token: string, paths: string[]): Promise<void> { L88: const res = await fetch(new URL("/_cache/purge", origin).toString(), { L89: method: "POST",

High

Same File Env Network Execution

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

scripts/sync-blocks-to-kv.tsView on unpkg · L77

scripts/generate-invoke.test.tsView file

220const outFile = path.join(siteDir, "src", "server", "invoke.gen.ts"); L221: const result = spawnSync("npx", ["tsx", GENERATOR, "--out-file", outFile], { L222: cwd: siteDir,

High

Runtime Package Install

Package source invokes a package manager install command at runtime.

scripts/generate-invoke.test.tsView on unpkg · L220

scripts/generate-schema.test.tsView 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.

scripts/generate-schema.test.tsView on unpkg

Findings

1 Critical4 High4 Medium5 Low

CriticalPrevious Version Dangerous Deltascripts/generate-schema.test.ts

HighChild Processscripts/audit-observability-config.test.ts

HighShell

HighSame File Env Network Executionscripts/sync-blocks-to-kv.ts

HighRuntime Package Installscripts/generate-invoke.test.ts

MediumDynamic Requirescripts/audit-observability-config.test.ts

MediumNetwork

MediumEnvironment Vars

MediumStructural Risk Force Deep Review

LowScripts Present

LowFilesystem

LowHigh Entropy Strings

LowUrl Strings

LowNo License

94%Warn

Verdict confidence

IntentDangerous Capability

TypeAI-agent capability abuse

False-positive riskLow

Review stagesource_first_review

Firewall policyWarn-only AI-agent capability risk

Package metadata

npm

Maintainerscamudo, nicacioliveira, gimenes-decocx +4

Version7.19.0

PublishedJul 15, 2026

Licensenone

Dependencies3

Integrityverified

Package size305 KB

Files110

LinksRepository Homepage Issues

Runtime surface

package.json

Entrypointsmain → ./scripts/generate.tsexports mapbin → deco-audit-observability, deco-cf-observability, deco-htmx-analyze +4

RuntimeNo engine / OS / CPU constraints

Artifact1.13 MB · 110 files1 signature(s) · provenance

Install lifecycleNo install hooks · other: build, lint:unused, test, typecheck

Behavioral surface

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShellHighEntropyStringsUrlStringsNoLicense

Source & flagged code

5 flagged

scripts/audit-observability-config.test.tsView file

Lines 289-329typescript

289});

290

291describe("CLI gate hardness (D-16) — --mode warn|block + --github", () => {

292 let tmpdir: string;

293 const cliPath = path.resolve(__dirname, "audit-observability-config.ts");

294

295 beforeEach(() => {

296 tmpdir = fs.mkdtempSync(path.join(os.tmpdir(), "audit-mode-"));

297 });

298 afterEach(() => {

299 fs.rmSync(tmpdir, { recursive: true, force: true });

300 });

301

302 // Spawn the script via tsx in a child process so we exercise the real

303 // `process.exit()` paths instead of monkey-patching them. This is the

304 // contract storefront CI consumes, so it's the contract under test.

305 function runCli(args: string[]): {

306 status: number | null;

307 stdout: string;

308 stderr: string;

309 } {

310 const { spawnSync } = require("node:child_process") as typeof import(

311 "node:child_process"

High

Child Process

Package source references child process execution.

scripts/audit-observability-config.test.tsView on unpkg · L309

Medium

Dynamic Require

Package source references dynamic require/import behavior.

scripts/audit-observability-config.test.tsView on unpkg · L309

312 );

313 const result = spawnSync(

314 process.execPath,

315 [

316 require.resolve("tsx/cli"),

317 cliPath,

318 "--source",

319 tmpdir,

320 ...args,

321 ],

322 { encoding: "utf8" },

323 );

324 return {

325 status: result.status,

326 stdout: result.stdout,

327 stderr: result.stderr,

328 };

329 }

scripts/sync-blocks-to-kv.tsView file

Lines 57-97typescript

57import { readDecofileFromDir } from "./lib/read-decofile";

58import { changedBlockFiles, changedBlockKeys, purgePathsForChangedKeys } from "./lib/sync-helpers";

60const DEFAULT_RETAIN = 10;

62function parseArgs(argv: string

scripts/generate-invoke.test.tsView file

Lines 200-240typescript

200 // `--apps-dir node_modules/@decocms/apps-vtex/src` by hand (granadobr's

201 // migration workaround). The default must probe <pkg>/invoke.ts first,

202 // then <pkg>/src/invoke.ts.

203

204 function makeSite(layout: "root" | "src"): { siteDir: string; cleanup:

scripts/generate-schema.test.tsView 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.

scripts/generate-schema.test.tsView on unpkg