@Hercules-debug/dsh-flock

Self-organizing multi-agent clusters for DeepSeek Harness — real DSH subagents coordinating through a shared append-only log, no orchestrator

PluginAI ModelsDeveloperAgent orchestration

Verification

L5 · Run tested

Verified

Risk

LowRisk

Health

Active

Trust

Gold

Install verification: runtime verified (L5) · tested on dsh 0.2.1-rc.2 · last checked 10-20Install verification details →

What it doesAI

Self-organizing multi-agent clusters for DeepSeek Harness, where real DSH subagents coordinate via a shared append-only log with no orchestrator.

Self-organizing DSH subagent clusters with no central orchestrator
Coordination through a shared append-only blackboard log
Built as a DSH plugin for multi-agent collaboration

aiAIagent-orchestrationAI

Capability tags are AI-inferred or rule-extracted from the README (see badge) — vocabulary-limited, not install-verified. AI = inferred; README = literal keyword from the readme.

Installation

dsh plugin --profile web add dsh-flock

verified 0.1.0

Install method: npm · runtime verified (L5)

Verification & Compatibility

Grouped by plugin version: each card lists the dsh versions actually tested against that artifact version and their install verdicts (L5 wins). Untested combinations are omitted — absence means untested, never assumed compatible. L1–L3 are a plugin-level static archive (independent of the dsh version — the same verdict on every dsh row): they sit in each row's level grid next to L4/L5, marked "static", while their evidence is stored once per plugin inside that row's "checks & evidence" instead of being duplicated per version.

External credentials (plugin-level): none detected

Declared DSH compatibilityfrom package.json · peerDependencies

author declared no dsh version requirement

○ The author declares no dsh version requirement — install is not blocked by version.

Install compatibility matrix (rows = plugin versions〔latest 5〕, columns = dsh versions〔latest 5〕)

At-a-glance → evidence in the cards below

plugin ＼ dsh	dsh 0.2.1-rc.2 current	dsh 0.2.1-alpha.2
0.1.0	✓	✓

Install compatibility (by plugin version, dsh versions within)

Legend:✓ L5 runtime verified○ ecosystem plugin◼ ecosystem app✗ failed

0.1.0npm✓ 2 runtime-verified2026-10-20

dsh-flock

✓dsh 0.2.1-rc.2current2026-10-20L5 · runtime verified

Environment & artifact

• Node.js: v24.14.0
• DSH: 0.2.1-rc.2
• Plugin artifact: npm · dsh-flock@0.1.0

Levels (L1–L3 plugin-level static archive · L4/L5 newest real verdicts for this combination)

L1 static

Passed

L2 static

Passed

L3 static

Passed

L4 sandbox

Passed

L5 runtime

Passed

Install + runtime smoke verified in the dsh sandbox — installs and runs

L5 · runtime verified · valid for dsh 0.2.1-rc.2

ID: dsh-flock@0.1.0@dsh0.2.1-rc.2 · profile: l4-sandbox

Issued: 2026-10-20 · expires: 2026-10-27

View checks & evidence

L1 · Found✓ Passed

Defaulted from L3L1.0_DEFAULTED_FROM_L3✓ Passed

defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)

L2 · Structured✓ Passed

Defaulted from L3L2.0_DEFAULTED_FROM_L3✓ Passed

defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)

L3 · Install spec✓ Passed

Install command parsedL3.1_INSTALL_COMMAND_PARSED✓ Passed

Source: registry verification · Method: install spec parse · Captured 2026-10-18

DSH version declaredL3.2_DSH_VERSION_DECLARED✓ Passed

Source: registry verification · Method: DSH version declaration · Captured 2026-10-18

L4 · Install tested✓ Passed

Install executed in confined sandboxL4.1_INSTALL_EXECUTED_CONFINED✓ Passed

Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-20

spec dsh-flock · channel npm package · outcome ran · exit 0

check took: 2.5s

Install succeededL4.2_INSTALL_SUCCESS✓ Passed

Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-20

spec dsh-flock · channel npm package · outcome ran · exit 0

check took: 2.5s

Installed artifact confirmedL4.3_ARTIFACT_CONFIRMED✓ Passed

Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-20

spec dsh-flock · channel npm package · outcome ran · exit 0

check took: 2.5s

L5 · Run tested✓ Passed

active in loader tree (150 entries)

Sandbox install passedL5.1_INSTALL_PASSED_SANDBOXED✓ Passed

Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-20

spec dsh-flock · install mode reused L4 scratch

check took: 20ms

Web boot readyL5.2_WEB_BOOT_READY✓ Passed

Source: DSH runtime · Method: web boot · Captured 2026-10-20

ready line dsh web: http://127.0.0.1:63901/?token=…

HTTP endpoint servedL5.3_HTTP_SERVED✓ Passed

Source: DSH runtime · Method: HTTP request · Captured 2026-10-20

path / · HTTP 200 · took 20ms

Plugin active in inventoryL5.4_PLUGIN_INVENTORY_ACTIVE✓ Passed

Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-20

verdict active · entries 150

match: include:flock · dsh-flock · phase active

phases: active 122 · null 28

L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.

✓dsh 0.2.1-alpha.22026-10-15L5 · runtime verified

Environment & artifact

• Node.js: v24.14.0
• DSH: 0.2.1-alpha.2
• Plugin artifact: npm · dsh-flock@0.1.0

Levels (L1–L3 plugin-level static archive · L4/L5 newest real verdicts for this combination)

L1 static

Passed

L2 static

Passed

L3 static

Passed

L4 sandbox

Passed

L5 runtime

Passed

Install + runtime smoke verified in the dsh sandbox — installs and runs

L5 · runtime verified · valid for dsh 0.2.1-alpha.2

ID: dsh-flock@0.1.0@dsh0.2.1-alpha.2 · profile: l3-fullscan

Issued: 2026-10-15 · expires: 2026-10-22

View checks & evidence

L1 · Found✓ Passed

Defaulted from L3L1.0_DEFAULTED_FROM_L3✓ Passed

defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)

L2 · Structured✓ Passed

Defaulted from L3L2.0_DEFAULTED_FROM_L3✓ Passed

defaulted to passed — L3 install spec passed (full-registry L3 sweep policy)

L3 · Install spec✓ Passed

Install command parsedL3.1_INSTALL_COMMAND_PARSED✓ Passed

Source: registry verification · Method: install spec parse · Captured 2026-10-18

DSH version declaredL3.2_DSH_VERSION_DECLARED✓ Passed

Source: registry verification · Method: DSH version declaration · Captured 2026-10-18

L4 · Install tested✓ Passed

Install executed in confined sandboxL4.1_INSTALL_EXECUTED_CONFINED✓ Passed

Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14

spec dsh-flock · channel npm package · outcome ran · exit 0

check took: 3.3s

Install succeededL4.2_INSTALL_SUCCESS✓ Passed

Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14

spec dsh-flock · channel npm package · outcome ran · exit 0

check took: 3.3s

Installed artifact confirmedL4.3_ARTIFACT_CONFIRMED✓ Passed

Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14

spec dsh-flock · channel npm package · outcome ran · exit 0

check took: 3.3s

L5 · Run tested✓ Passed

active in loader tree (150 entries)

Sandbox install passedL5.1_INSTALL_PASSED_SANDBOXED✓ Passed

Source: Windows ACL sandbox · Method: sandbox install run · Captured 2026-10-14

spec dsh-flock · install mode reused L4 scratch

check took: 412ms

Web boot readyL5.2_WEB_BOOT_READY✓ Passed

Source: DSH runtime · Method: web boot · Captured 2026-10-14

ready line dsh web: http://127.0.0.1:54771/?token=…

HTTP endpoint servedL5.3_HTTP_SERVED✓ Passed

Source: DSH runtime · Method: HTTP request · Captured 2026-10-14

path / · HTTP 200 · took 412ms

Plugin active in inventoryL5.4_PLUGIN_INVENTORY_ACTIVE✓ Passed

Source: DSH runtime · Method: plugin inventory query · Captured 2026-10-14

verdict active · entries 150

match: include:flock · dsh-flock · phase active

phases: active 122 · null 28

L1–L3 are plugin-level static conclusions (baseline, identical across dsh versions): evidence is stored once per plugin.

Only the latest 3 published versions are shown; source-snapshot (commit hash) groups, unstated groups and older versions are omitted — the full archive stays in the data layer (snapshot/unstated groups appear only when a plugin has no published version).

Author badges

Embed the official badges in your README to showcase security & install-test status:

Security Report

Two automated layers, neither a manual review: a static scan (per-plugin rule checks) and a model-driven dynamic security audit that covers only the subset static-flagged at warn or above and never executes plugin code.

dsh-flockAutomated review · daily

Static low, dynamic medium — stricter wins → overall medium.

static low→dynamic medium→overall medium

0 critical·0 high

mediumoverall · medium

1static scan · vet primaryvet AST static analysis (npm artifact or git source)

Version binding

plugin versionv0.1.0dsh manifest

scanned version0.1.0npm2026-10-21

current version0.1.0same version

vet verdictclean · npm

Vet is an AST static scan (npm artifact or git source).

show static findings (6)

warningfsWrite · filessrc/board-store.js:68
fs.writeFileSync(paths.direction, text, "utf8");
warningfsWrite · filessrc/board-store.js:80
fs.writeFileSync(paths.config, JSON.stringify(cfg, null, 2), "utf8");
warningfsWrite · filessrc/board-store.js:105
fs.writeFileSync(paths.state, JSON.stringify(doc, null, 2), "utf8");
warningfsWrite · filessrc/store.js:50
fs.writeFileSync(paths.direction, text, "utf8");
warningfsWrite · filessrc/store.js:62
fs.writeFileSync(paths.config, JSON.stringify(cfg, null, 2), "utf8");
warningfsWrite · filessrc/store.js:88
fs.writeFileSync(paths.state, JSON.stringify(next, null, 2), "utf8");

2dynamic auditmodel reads redacted source context · never executes plugin code

highest grademedium

merged intooverall medium

audited at2026-10-19

findings0 critical·0 high1 medium / 1 low hidden

show 2 audit findings

mediumflock_status takes an unbounded agent count and drives a synchronous per-agent looplib/index.js:236
flock_run caps size via resolveClusterSize() and config.maxAgents, but flock_status (and flock_direct) pass Math.max(1, Number(args.agents)) straight into snapshot(), which loops `for (let n = 0; n < concurrency; n++)` calling readLog() -> fs.readFileSync per index, and render() then loops the generated agents array again. A single tool call with agents=1e8 (reachable when the calling model is steered by untrusted content it has read) blocks the host event loop synchronously for minutes or hours, hanging the session and any other session in the same process.
lowPeer-written log fields are interpolated verbatim into other agents' promptssrc/agent.js:84
t.result / t.next_intent / t.action are arbitrary strings an agent (or anything that influenced it) appended to its own log, and they are copied unescaped into a sibling agent's task prompt. A compromised or manipulated agent can therefore plant instructions that a later agent may follow while holding the host's full tool set (bash, fs). Board mode is similar by design: agents read the shared board directly. No privilege boundary is crossed relative to the captain, so impact is limited to steering sibling agents and spreading injected content across the cluster.

Flock/board coordination plugin is clean of shell, network and secret access; one real issue: flock_status accepts an unbounded agent count that drives a synchronous loop.

Rule: the dynamic audit can only raise risk, never lower it (raise-only, never an exemption); a wrong raise is withdrawn by human review and the tier falls back to the static verdict. Overall verdict = the stricter of the two layers.

Disclaimer: the static scan and the dynamic security audit are both automated analysis, not a security guarantee. Always review what you install.

Activity

Last commit 2026-10-02 · activity: Active

• Repo created: 2026-09-29

• Stars: ★ 1 · Forks: 0

• Health: Active — committed within last 30 days

Source

GitHub: github.com/Hercules-debug/dsh-flock

Plugin notes

What is the @Hercules-debug/dsh-flock DeepSeek Harness plugin?

@Hercules-debug/dsh-flock is a DeepSeek Harness plugin maintained by @Hercules-debug. It is cataloged on dsh.so as a AI Models plugin for Agent orchestration tasks, with a public GitHub source, declared install command, and automated static scan results; plugins static-flagged at warn or above also carry a model-driven dynamic security audit record.

How do I install @Hercules-debug/dsh-flock?

Run dsh plugin --profile web add dsh-flock in a DeepSeek Harness (dsh) environment. This exact command has been verified by a real install inside an isolated windows-acl sandbox (L4) plus web smoke testing (L5).

How does the security scan relate to a manual audit?

Both layers are automated, not a manual audit: the static scan is heuristic analysis of the repository source (it can produce false positives and miss context), and the dynamic security audit has a model read the harvested source context with secret files stripped and content redacted inline — plugin code is never executed. The dynamic audit only covers plugins static-flagged at warn or above, and its conclusion can only raise the combined verdict, never exempt it. Neither layer is a manual security audit or an endorsement; before using a plugin, review the repository and installed permissions, and combine both with the verification level (L4/L5) and health signals.

"DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI. It uses an architecture where everything is a plugin, and is powered by Cordis."
— DeepSeek Harness README

Sources: GitHub repository · DeepSeek Harness README · security scan data · Maintained by dsh.so · Last updated 2026-10-13

@Hercules-debug/dsh-flock

What it doesAI

Installation

Verification & Compatibility

Author badges

Security Report

Activity

Source

Author README