io.github.BourbonDog/amicus

What we checked

Six static checks, weighted by risk. Every result reflects only what could be observed in the published package and repository — never intent.

• Injection surface

  unscannable25% of grade

  Tool descriptions/manifest scanned for instruction-injection patterns (imperatives at the model, hidden text, 'ignore previous', data-exfil URLs).

  No tool descriptions, server instructions, prompts, or resources were fetched; nothing to scan for injection.

• Supply chain

  warn25% of grade

  Package provenance: namespace verification, repo linkage, maintainer count, account age, postinstall scripts, typosquat distance.

  install hook "postinstall" present and not a recognized benign build command

• Credential hygiene

  pass15% of grade

  How the server takes secrets (env vs plaintext config vs hardcoded); secrets appearing in tool schemas.

  Reads secrets from the environment (e.g. src/utils/abort-coordinator.js) — the recommended intake shape. PASS = no static red flag; static analysis cannot prove the code honors env-based secret handling at runtime.

• Permission scope

  fail15% of grade

  Declared tools vs. breadth (filesystem, network, exec); flags shell-exec and unbounded filesystem access.

  HIGH: shell/exec capability AND network egress together — download-and-execute risk (src/sidecar/electron-install.js: imports child_process and calls exec/spawn; electron/summary.js: outbound HTTP/socket call). HIGH: shell/exec capability AND destructive filesystem writes together (src/sidecar/electron-install.js: imports child_process and calls exec/spawn; bin/amicus.js: path traversal ('../') combined with file access). discloses shell/exec capability: src/sidecar/electron-install.js: imports child_process and calls exec/spawn discloses shell/exec capability: src/sidecar/interactive.js: imports child_process and calls exec/spawn discloses shell/exec capability: src/mcp-server.js: imports child_process and calls exec/spawn discloses shell/exec capability: src/utils/port-pid.js: imports child_process and calls exec/spawn discloses shell/exec capability: scripts/postinstall.js: imports child_process and calls exec/spawn discloses shell/exec capability: scripts/setup-hooks.js: imports child_process and calls exec/spawn discloses shell/exec capability: src/sidecar/setup-window.js: imports child_process and calls exec/spawn discloses shell/exec capability: src/sidecar/unzip.js: imports child_process and calls exec/spawn discloses shell/exec capability: src/utils/updater.js: imports child_process and calls exec/spawn discloses broad/destructive filesystem access: bin/amicus.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/utils/api-key-store.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/utils/atomic-write.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/utils/auth-json.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/cli-handlers-doctor.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/utils/client-detect.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/utils/config.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/context-builder.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/continue.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/continue.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/crash-handler.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/electron-ensure.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/electron-install.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/electron-lock.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/fanout-leg.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/fanout-leg.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/fanout-output.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/fanout.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/fanout.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: electron/fold.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/headless.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/interactive-abort.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/interactive-mirror.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/interactive-process.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/interactive.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: electron/ipc-setup.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/council/ledger.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: electron/load-failsafe.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: electron/main.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/mcp-server.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/mcp-server.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/mcp-wait.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/utils/model-catalog.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/models.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: electron/opencode-theme.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: scripts/postinstall.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: scripts/postinstall.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/progress.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/project-root-allowlist.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/read.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/council/report-html.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/council/report.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/utils/result-schema.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/resume.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/resume.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/utils/session-abort.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/session-finalize.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/utils/session-index.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/utils/session-lock.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/session-manager.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/utils/session-path.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: electron/session-route.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/session-utils.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/session-utils.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: electron/setup-ui-styles.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: electron/setup-ui.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/setup-window.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/setup.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/utils/shared-server.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/start.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/sidecar/start.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: electron/summary.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: electron/toolbar.js: path traversal ('../') combined with file access discloses broad/destructive filesystem access: src/sidecar/unzip.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/council/verdict.js: destructive/writing fs.* call (write/unlink/rm/chmod/rename) discloses broad/destructive filesystem access: src/utils/version-info.js: path traversal ('../') combined with file access Capability DISCLOSURE, not a verdict: static analysis sees the primitive is present and reachable, not whether its use is attacker-controlled.

• Version behavior

  unscannable10% of grade

  Diff of tool definitions between versions; new permissions or changed descriptions in a patch release (the postmark-mcp class).

  no prior version to diff (first sight of io.github.BourbonDog/[email protected]); version-drift / rug-pull cannot be evaluated. Cold-start risk is covered by point-in-time checks (injection_surface, supply_chain, credential_hygiene), not here.

• Transport config

  fail10% of grade

  Remote servers: TLS and auth mode (none/token/OAuth). Local servers: whether the manifest indicates it phones home.

  source performs runtime self-update / download-and-execute (bypasses version_behavior); manifest/source references tracking behavior — disclosure