How noob-stupid/dsh-plugin-gating-hub works
DSH Plugin Gating Hub is a web/desktop plugin console focused on safe framework upgrades and plugin compatibility, with discovery and installation as a secondary layer. The main user flow runs from the console through the local HTTP route dispatcher to upgrade or compatibility logic, which manages framework state and rollback; discovery flows through market and install routes into configurable sources and install jobs. The README also documents AI-assisted deployment and server-component controls. Some feature wiring is documented but its implementation was not sampled, so those links use only supported route or enclosing-directory paths.
Main entry points: routes/index.js HTTP route dispatcher · lib/index.js Plugin entry · framework-upgrade.js Framework upgrade · install-job.js Install jobs
Components 22
Console entry
- Console client
lib/client.js - Plugin entry
lib/index.js - HTTP route dispatcher
lib/server/routes/index.js - Runtime state
lib/server/state.js
Upgrade safety
- Framework upgrade
lib/server/routes/framework-upgrade.js - Framework lifecycle
lib/server/domain/framework.js - Compatibility gate
lib/server/domain/compat.js - Failure quarantine
lib/server/domain/quarantine.js - Filesystem operations
lib/server/infra/fsx.js
Plugin management
- Plugin routes
lib/server/routes/plugins.js - Patch and gating
lib/server/domain/patch.js
Discovery and install
- Market routes
lib/server/routes/market.js - Market discovery
lib/server/domain/market.js - Configurable sources
lib/server/domain/sources.js - Install routes
lib/server/routes/install.js - Install jobs
lib/server/domain/install-job.js - Repository handling
lib/server/domain/repoland.js
AI and components
- AI deployment
lib/server/domain/ai-run.js - Server components
lib/server/domain/components.js
Other components
- Console user
- DSH host
- Package and Git sources
Connections 24
- Console user → Console client: uses
- Console client → Plugin entry: requests
- Plugin entry → DSH host: registers with
- Plugin entry → HTTP route dispatcher: dispatches to
- HTTP route dispatcher → Runtime state: reads and updates
- HTTP route dispatcher → Framework upgrade: dispatches upgrade
- Framework upgrade → Framework lifecycle: preflights
- Framework upgrade → Compatibility gate: checks compatibility
- Framework upgrade → Filesystem operations: checkpoints and restores
- Framework lifecycle → Failure quarantine: records failures
- HTTP route dispatcher → Plugin routes: dispatches plugin actions
- Plugin routes → Patch and gating: changes plugin state
- Plugin routes → Compatibility gate: checks adapt status
- HTTP route dispatcher → Market routes: dispatches search
- Market routes → Market discovery: queries
- Market discovery → Configurable sources: uses source settings
- HTTP route dispatcher → Install routes: dispatches installs
- Install routes → Install jobs: starts job
- Install jobs → Configurable sources: selects source
- Install jobs → Repository handling: lands repositories
- Install jobs → Package and Git sources: fetches packages or Git
- HTTP route dispatcher → AI deployment: dispatches AI actions
- AI deployment → Package and Git sources: reads package documentation
- Plugin entry → Server components: autostarts components