MCP, MCP server
io.github.bzdOS/hubd
The project tracker for teams of humans and AI agents — in plain files.
Compatibility: Not stated.
Grade C
One Medium finding. Read the report before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
SECRETS_PATH_CREDENTIAL
Why this grade
- SECRETS_PATH_CREDENTIAL Medium
Mentions a credential store path (~/.ssh, id_rsa, .npmrc, .aws/credentials, credentials.json, .netrc).
CHANGELOG.md, line 275
a passphrase from `~/.ssh/config` and the host key from a node that has it;
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
hub/cli.mjs, line 1064
fs.unlinkSync(freezeFile());
hub/cli.mjs, line 1907
try { fs.writeFileSync(tmp, text); fs.renameSync(tmp, out); } catch (e) { try { fs.unlinkSync(tmp); } catch {} fail(`--out ${out}: ${e.message}`); }
hub/lib/absorb.mjs, line 206
for (const p of written.reverse()) { try { fs.unlinkSync(p); } catch {} }
Show more
hub/lib/absorb.mjs, line 207
try { fs.rmSync(path.join(HUB, 'absorbed', label), { recursive: true, force: true }); } catch {}
hub/lib/cardmerge.mjs, line 87
} finally { fs.rmSync(dir, { recursive: true, force: true }); }
hub/lib/demo.mjs, line 43
if (target === 'demo') fs.rmSync(dir, { recursive: true, force: true });
hub/lib/gc.mjs, line 67
for (const f of [...l.locks, ...l.backups, ...l.tmp]) { try { fs.unlinkSync(path.join(HUB, f)); removed++; } catch {} }
hub/lib/gc.mjs, line 172
for (const w of plan.waiters) { try { fs.unlinkSync(path.join(r, '.qstate', w.file)); waitersRemoved++; } catch {} }
Install and update
Pass
No install-time script found, and dependencies are pinned or absent.
Network
Concern
can reach matrix.example.org. The description does not name that host. can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST
contrib/watch-to-matrix.sh, line 8
# Needs hub, curl and jq. MATRIX_HS=https://matrix.example.org MATRIX_ROOM='!room:example.org'
contrib/watch-to-matrix.sh, line 16
curl -fsS -m 15 -X PUT -H "Authorization: Bearer $MATRIX_TOKEN" -H "Content-Type: application/json" --data @- \
hub/lib/stats.mjs, line 123
const res = await fetch(a.url || OPENROUTER_MODELS, { headers: { accept: 'application/json' } });
Show more
scripts/capture-board.mjs, line 64
const page = (await (await fetch(`http://127.0.0.1:${CDP_PORT}/json/list`)).json()).find(t => t.type === 'page');
scripts/capture-board.mjs, line 70
const ws = new WebSocket(wsUrl);
scripts/capture-kanban.mjs, line 124
const page = (await (await fetch(`http://127.0.0.1:${CDP_PORT}/json/list`)).json()).find(t => t.type === 'page');
scripts/capture-kanban.mjs, line 130
const ws = new WebSocket(wsUrl);
scripts/import-bank.mjs, line 79
const r = await fetch(url, { method: 'POST', headers: { 'content-type': 'application/json', authorization: 'Bearer ' + key }, body: JSON.stringify(body) });
CHANGELOG.md, line 2316
Harvest Protocol ships with the package, no repo fetch (0.4.0).
hub/lib/serve.html, line 242
var d=await fetch('/api/kanban'+location.search).then(function(r){return r.json()});
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_CREDENTIAL
hub/index.mjs, line 888
const TOKEN = process.env.HUBD_TOKEN || '';
hub/lib/absorb.mjs, line 155
const skipped = ['presence/', '.qstate/', 'claims.json', 'tasks.json', 'HUBD.md', '.checkins.json', '.env-state.json'].filter(f => fs.existsSync(path.join(from, f)));
CHANGELOG.md, line 275
a passphrase from `~/.ssh/config` and the host key from a node that has it;
Show more
hub/lib/secrets.mjs, line 32
return process.env.HUBD_SECRETS_DIR || path.join(os.homedir(), '.hubd-secrets');
hub/lib/setup.mjs, line 207
try { child = spawn(s.command, s.args, { env: { ...env, ...s.env, HUBD_SESSION: 'hub-setup' }, stdio: ['pipe', 'pipe', 'pipe'] }); }
hub/lib/setup.mjs, line 403
const dshSpec = (row) => ({ command: (row.config || {}).command, args: [], env: (row.config || {}).env || {} });
scripts/gen-reference.mjs, line 54
const r = spawnSync(process.execPath, [SERVER], { cwd: dir, env: { ...hubEnv(dir), ...env }, input: req, encoding: 'utf8', timeout: 30000 });
scripts/gen-reference.mjs, line 304
['.env-state.json', 'What this node\'s environment checks last observed: the `environment` list of `hub_whatsnew` and `hub doctor`.', '`hub_whatsnew`, `hub doctor`'],
SECURITY.md, line 18
- **Runtime state never syncs.** `presence/`, `.qstate/`, `.env-state.json` and
docs/guarantees.md, line 109
when the condition does. Per-node state in `.env-state.json`, never mesh-synced -
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
hub/lib/core.mjs, line 1
import fs from 'node:fs';
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 2863535a5434. can delete files. can reach matrix.example.org. The description does not name that host. 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:
github.com
Commit graded: 2863535a5434cc850b6565b4b75115656e1b7e8b
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.