io.github.raccioly/docguard

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

  pass25% of grade

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

  repository linkage verified

• 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. templates/demo-fixture/src/api.mjs) — 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 (cli/commands/demo.mjs: imports child_process and calls exec/spawn; cli/scanners/frontend.mjs: outbound HTTP/socket call). HIGH: shell/exec capability AND destructive filesystem writes together (cli/commands/demo.mjs: imports child_process and calls exec/spawn; cli/commands/agent.mjs: path traversal ('../') combined with file access). discloses shell/exec capability: cli/commands/demo.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/commands/diagnose.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/ensure-skills.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/commands/fix.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/validators/freshness.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/commands/init.mjs: imports child_process discloses shell/exec capability: cli/scanners/memory-plan.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/scanners/py-ast.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/commands/score.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/commands/setup.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/shared-git.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/scanners/speckit.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/commands/sync.mjs: imports child_process and calls exec/spawn discloses shell/exec capability: cli/commands/upgrade.mjs: imports child_process and calls exec/spawn discloses broad/destructive filesystem access: cli/commands/agent.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/agents.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/api-surface.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/architecture.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/canonical-sync.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/cross-reference.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/demo.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/diagnose.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/diff.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/writers/doc-generators.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/doc-quality.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/docs-coverage.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/docs-diff.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/docs-sync.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/drift.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/ensure-skills.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/environment.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/explain.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/feedback.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/fix.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/freshness.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/scanners/frontend.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/generate.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/generated-staleness.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/guard.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/hooks.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/scanners/iac.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/impact.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/init.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/llms.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/mcp.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/scanners/memory-plan.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/memory.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/metadata-sync.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/metrics-consistency.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/scanners/project-type.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/publish.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/scanners/routes.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/writers/sarif.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/schema-sync.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/scanners/schemas.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/score.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/security.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/setup.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/scanners/speckit.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/structure.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/surface-sync.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/sync-tests.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/sync.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/test-spec.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/todo-tracking.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/trace.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/validators/traceability.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/upgrade.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/verify.mjs: path traversal ('../') combined with file access discloses broad/destructive filesystem access: cli/commands/watch.mjs: 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.raccioly/[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); sends telemetry to third-party SDK (Datadog) — disclosure, verify opt-in; manifest/source references tracking behavior — disclosure