Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Understanding Graph

A persistent medium for fluid, emergent understanding

Compatibility: Not stated.

Grade C

One Medium finding. Read the report before installing.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

INSTALL_LIFECYCLE_HOOK

Why this grade

  • INSTALL_LIFECYCLE_HOOK Medium

    A package install hook (preinstall, install, postinstall or prepare) runs a script.

    package.json, line 64 prepare

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Concern

    can delete files.

    PERMISSION_DELETE_FILES

    packages/core/src/database/sqlite-project-lifecycle.test.ts, line 17

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

    packages/core/src/services/ContextService.test.ts, line 58

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

    packages/core/src/services/DocumentCreateAtomicity.test.ts, line 22

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

    Show more

    packages/core/src/services/DocumentStructureValidation.test.ts, line 21

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

    packages/core/src/services/DocumentWriter.test.ts, line 38

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

    packages/core/src/services/DocumentWriter.ts, line 198

    fs.unlinkSync(auxPath);

    packages/core/src/services/GraphStoreEdgeValidation.test.ts, line 23

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

    packages/web-server/src/api-serialization.test.ts, line 30

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

  • Install and update

    Concern

    runs a script at install time.

    INSTALL_LIFECYCLE_HOOK

    package.json, line 64

    prepare

  • Network

    Concern

    can reach a host that is not written as a fixed address.

    NETWORK_NO_FIXED_HOST

    packages/frontend/src/components/GraphCanvas.tsx, line 1607

    const res = await fetch(

    packages/frontend/src/hooks/useApi.ts, line 70

    const res = await fetch(`${API_BASE}${url}`, {

    packages/frontend/src/hooks/useApi.ts, line 78

    const res = await fetch(`${API_BASE}${url}`, {

    Show more

    packages/frontend/src/hooks/useApi.ts, line 87

    const res = await fetch(`${API_BASE}${url}`, {

    packages/frontend/src/stores/appStore.ts, line 150

    fetchProject: ProjectFetch = (input, init) => fetch(input, init),

    packages/web-server/src/api-serialization.test.ts, line 101

    const first = fetch(`${baseUrl}/api/probe`, {

    packages/web-server/src/api-serialization.test.ts, line 105

    const second = fetch(`${baseUrl}/api/probe`, {

    packages/web-server/src/api-serialization.test.ts, line 161

    const first = fetch(`${baseUrl}/api/probe?client=first`);

    packages/web-server/src/graph-read-write-agreement.test.ts, line 105

    await fetch(`http://127.0.0.1:${port}/api/graph`)

    packages/web-server/src/graph-read-write-agreement.test.ts, line 143

    await fetch(`http://127.0.0.1:${port}/api/graph`)

    packages/web-server/src/graph-read-write-agreement.test.ts, line 194

    await fetch(`http://127.0.0.1:${port}/api/graph`)

    packages/web-server/src/mutation-firewall.test.ts, line 57

    const response = await fetch(`http://127.0.0.1:${port}/api/graph/batch`, {

    scripts/smoke-web-discovery.mjs, line 75

    const projectsResponse = await fetch(`http://127.0.0.1:${port}/api/projects`);

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    bin/cli.js, line 391

    if (/^\[mcp_servers\.understanding_graph\.env\]\s*$/m.test(content)) {

    packages/frontend/src/hooks/useApi.ts, line 30

    (import.meta as any).env?.VITE_DISPLAY_ONLY === 'true' ||

    packages/frontend/src/hooks/useApi.ts, line 32

    (import.meta as any).env?.VITE_DISPLAY_ONLY === true

    Show more

    packages/web-server/src/index.ts, line 10

    // Load .env from project root (3 levels up from dist/index.js)

    packages/web-server/src/index.ts, line 11

    dotenv.config({ path: path.resolve(__dirname, '../../../.env') });

    packages/web-server/src/index.ts, line 43

    token: process.env.UG_WORKER_TOKEN,

    .dockerignore, line 8

    paper/tmp

    .dockerignore, line 9

    .env

    .gitignore, line 29

    # Environment

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Note

    a file was over the read cap and was not fully read.

    OBFUSCATION_FILE_OVER_READ_CAP

    package-lock.json, line 1

    {

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit 1ade12359615. can delete files. runs a script at install time. can reach a host that is not written as a fixed address. reads a credential or environment file. a file was over the read cap and was not fully read.

Date and source

Date checked:

View source

github.com

Commit graded: 1ade123596156b50200be73ca6139b1d7bde23d6

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen