registry / Persistence / @indigoai-us/hq-cli / 5.345.107

@indigoai-us/hq-cli@5.345.107

HQ by Indigo management CLI — modules and cloud sync

AI Security Review

scanned 10d ago · by lpm-firewall-ai

The postinstall hook can create and activate a persistent user-level service when no daemon version is recorded, so this merits a warning for automatic persistence. The inspected behavior installs the package’s own daemon and does not establish a concrete malicious payload or credential transfer.

Static reason

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

Trigger

Installing the package through npm, which runs its postinstall hook.

Impact

Package installation can create persistent background execution for the package’s mesh daemon without a separate explicit CLI command.

Mechanism

The hook launches the CLI with the mesh daemon install command and the if-stale option. A missing recorded daemon version is considered stale, and the installer writes daemon state and installs a platform service.

AI rationale

Evidence

package.jsonscripts/mesh-daemon-if-stale.mjsdist/commands/mesh.jsdist/lib/mesh/live/daemon/install.js

Decision evidence

public snapshot

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

Evidence for warning

The postinstall hook runs a package script that invokes the CLI’s mesh daemon install command with the if-stale option.
If no daemon version is recorded, the code treats the daemon as stale and proceeds to install it; it skips installation only when the recorded version is current and no node-path problem exists.
The daemon installer creates its private state directory and trusted-root record, then installs and can activate a user-level service.
The inspected agent-integration locations handle local session state, settings, policy paths, or credential-presence checks; they do not show an install-hook write to a foreign agent control surface.

Evidence against

The persistence behavior installs this package’s own mesh daemon, and the stale check avoids reinstalling it when its recorded version is current.
The inspected agent-integration locations do not establish a separate credential transfer or unrelated agent-configuration mutation.

Behavioral surface

Source

ChildProcessCryptoDynamicRequire

Source & flagged code

17 flagged

package.jsonView file

•scripts.postinstall = node scripts/mesh-daemon-if-stale.mjs || true

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/mesh-daemon-if-stale.mjs || true

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg

dist/startup-registration.jsView file

Lines 1-38javascript

1/**

2 * The command-registration recovery seam for the "install tree torn out from

3 * under a starting `hq`" condition (Sentry HQ-CLI-1G/1H/1J/1K).

4 *

5 * `runCli` registers commands as its last step before `program.parseAsync()` —

6 * the lazy command import or `import("./register-all.js")` and everything those

7 * pull in. That is the ONE place a module-resolution failure is provably safe to

8 * recover from: it is inside hq-cli's own graph, it runs before `parseAsync` and

9 * before the preAction hook, so no command action, telemetry, or stdin read has

10 * happened yet, and a single re-exec can therefore never run a command twice.

11 *

12 * This wraps the existing `register()` call with exactly that recovery, driven by

13 * the classifier / probe / settle wait / carrier in ./utils/install-tree-torn.ts.

14 * It changes nothing about WHICH modules are imported or in what order — only the

15 * failure handling around the existing imports. Dependency-injected in the house

16 * style of handleTopLevelError so the whole seam is unit-testable without real

17 * spawns, waits, or a real install tree.

18 */

19import { spawnSync } from "node:child_process";

20import { stringDerivedPackageRoot } from "./utils/hq-roots.js";

High

Child Process

Package source references child process execution.

dist/startup-registration.jsView on unpkg · L18

21import { updateLockPath, UPDATE_LOCK_STALE_MS } from "./utils/update-lock.js";

22import { classifyEvalThrow, classifyModuleNotFound, installRewriteInProgress, InstallTreeTornError, waitForInstallTreeSettled, } from "./utils/install-tree-torn.js";

23/**

24 * Set on the re-exec'd child so it can NEVER wait or re-exec again — distinct

25 * from self-update's HQ_RESCUE_SELF_UPDATED so the two recovery paths cannot

26 * shadow each other.

27 */

28export const INSTALL_TREE_RECOVERY_GUARD_ENV = "HQ_INSTALL_TREE_RECOVERED";

29/** Carries the writer-state observed by the parent into the guarded re-exec. */

30export const INSTALL_TREE_RECOVERY_TREE_STATE_ENV = "HQ_INSTALL_TREE_RECOVERY_TREE_STATE";

31/** Operator override for the settle wait's deadline. */

32export const INSTALL_SETTLE_TIMEOUT_ENV = "HQ_INSTALL_SETTLE_TIMEOUT_MS";

33/** Default settle deadline (ms). Overridable by {@link INSTALL_SETTLE_TIMEOUT_ENV}. */

34export const DEFAULT_INSTALL_SETTLE_TIMEOUT_MS = 90_000;

35/**

36 * The single dim, informational line emitted when — and only when — a wait

37 * actually happens. It tells a human why the command paused and is the e2e's

38 * synchronization point; it is never a remedy and never sets an error exit code.

dist/utils/staged-install.jsView file

Lines 316-346javascript

316 if (result.status !== 0)

317 return null;

318 const lines = (result.stdout ?? "").trim().

dist/utils/update-command-supervisor.cjsView file

Lines 1-22javascript

1"use strict";

3const { spawn: nativeSpawn } = require("node:child_process");

4const fs = require("node:fs");

dist/lib/daemon/sync-runner.jsView file

Lines 1-22javascript

1/** Local status and resource controls shared by the daemon and its sync runner. */

2import * as crypto from "node:crypto";

3import { spawnSync } from "node:child_process";

4import * as fs

dist/lib/mesh/live/daemon/install.jsView file

Lines 1-27javascript

1/**

2 * User-level service install for hq mesh daemon.

3 *

4 * - macOS: LaunchAgent ai.getindigo.hq-mesh-daemon

5 * - Linux: systemd user unit hq-mesh-daemon.service

6 * (documented fallback: root-owned unit running as ec2-user)

7 * - Windows: per-user Scheduled Task ai.getindigo.hq-mesh-daemon registered

8 * from a rendered task XML via schtasks.exe (no native dependencies)

9 *

10 * The unit embeds the hq binary resolved at install time. Logs go to

dist/commands/rescue.js#virtual:normalized:round1View file

1import { spawnSync } from "child_process"; L2: import * as fs from "fs"; ... L11: /** L12: * Resolve the source repo + ref from the user"s flags. Pure + exported for\n * tests. `latestTag` is the resolved latest release tag (prod only); ignored\n * for staging and when a... L13: if (!ref) {

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/commands/rescue.js#virtual:normalized:round1View on unpkg · L1

High

Command Output Exfiltration

Source combines command execution, command-output handling, and outbound requests; review data flow before blocking.

dist/commands/rescue.js#virtual:normalized:round1View on unpkg · L1

dist/lib/lanes/machine-identity.jsView file

11*/ L12: import { spawnSync } from "node:child_process"; L13: import * as os from "node:os"; L14: export const IMDS_HOST = "169.254.169.254"; L15: export const IMDS_TOKEN_URL = `http://${IMDS_HOST}/latest/api/token`; L16: export const IMDS_INSTANCE_ID_URL = `http://${IMDS_HOST}/latest/meta-data/instance-id`; ... L30: return null; L31: const body = (result.stdout ?? "").trim(); L32: return body.length > 0 ? body : null; ... L34: catch (err) { L35: process.stderr.write(`hq lanes: IMDS request failed for ${url}: ${err instanceof Error ? err.message : String(err)}\n`); L36: return null;

High

Cloud Metadata Access

Source reaches cloud instance metadata or link-local credential endpoints.

dist/lib/lanes/machine-identity.jsView on unpkg · L11

assets/lanes-hooks/hq-lanes-drain.shView file

•path = assets/lanes-hooks/hq-lanes-drain.sh kind = build_helper sizeBytes = 620 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

assets/lanes-hooks/hq-lanes-drain.shView on unpkg

assets/scaffold/.claude/hooks/validate-policy-frontmatter.shView file

•path = assets/scaffold/.claude/hooks/validate-policy-frontmatter.sh kind = payload_in_excluded_dir sizeBytes = 21475 magicHex = [redacted]

High

Payload In Excluded Dir

Package hides binary, compressed, or executable-looking payloads in test/fixture/hidden paths.

assets/scaffold/.claude/hooks/validate-policy-frontmatter.shView on unpkg

dist/hq-cloud-sync-runner/bin/sync-runner.jsView file

•path = dist/hq-cloud-sync-runner/bin/sync-runner.js kind = oversized_source_file sizeBytes = 6096254 magicHex = [redacted]

Medium

Oversized Source File

Package contains source files above the normal full-analysis size ceiling.

dist/hq-cloud-sync-runner/bin/sync-runner.jsView on unpkg

•path = dist/hq-cloud-sync-runner/bin/sync-runner.js kind = oversized_cli_entrypoint sizeBytes = 6096254 magicHex = [redacted]

Medium

Oversized Cli Entrypoint

Package contains an oversized executable-looking CLI entrypoint.

dist/hq-cloud-sync-runner/bin/sync-runner.jsView on unpkg

dist/commands/agent-enroll.js#virtual:normalized:round1View file

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

High

Semantic Analysis Limited

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

dist/commands/agent-enroll.js#virtual:normalized:round1View on unpkg

dist/commands/lanes.jsView file

•matchType = previous_version_dangerous_delta matchedPackage = @indigoai-us/hq-cli@5.345.106 matchedIdentity = npm:QGluZGlnb2FpLXVzL2hxLWNsaQ:5.345.106 similarity = 0.925 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.

dist/commands/lanes.jsView on unpkg

Source & flagged code

17 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/mesh-daemon-if-stale.mjs || true

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/mesh-daemon-if-stale.mjs || true

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg

dist/startup-registration.jsView file

18*/ L19: import { spawnSync } from "node:child_process"; L20: import { stringDerivedPackageRoot } from "./utils/hq-roots.js";

High

Child Process

Package source references child process execution.

dist/startup-registration.jsView on unpkg · L18

Findings

1 Critical9 High9 Medium6 Low

CriticalPrevious Version Dangerous Deltadist/commands/lanes.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/startup-registration.js

HighShelldist/utils/staged-install.js

HighSame File Env Network Executiondist/commands/rescue.js#virtual:normalized:round1

HighCommand Output Exfiltrationdist/commands/rescue.js#virtual:normalized:round1

HighCloud Metadata Accessdist/lib/lanes/machine-identity.js

HighTrigger Reachable Persistencedist/lib/mesh/live/daemon/install.js

HighPayload In Excluded Dirassets/scaffold/.claude/hooks/validate-policy-frontmatter.sh

HighSemantic Analysis Limiteddist/commands/agent-enroll.js#virtual:normalized:round1

Affected versions and remediation

This report applies to @indigoai-us/hq-cli@5.345.107.

See all versions of @indigoai-us/hq-cli for other recorded verdicts.

Review the evidence and your use of @indigoai-us/hq-cli@5.345.107 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-10-13 02:31:25.101Z (UTC).

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

AI Security Review

Decision evidence

Source & flagged code

Source & flagged code

Findings

Affected versions and remediation

Related packages

More from @indigoai-us

Behavioral surface

Related packages

More from @indigoai-us

Source & flagged code