How taco3064/nibfin-core works
Nibfin Core is an early-stage delivery engine for controlled, staged GitHub Issue work. The principal workflow begins with an Actions/controller request, adopts and validates the host and caller, admits a bounded stage using fresh GitHub observations, executes through installed adapters, records durable evidence, and performs narrowly authorized publication or merge operations. The README documents lifecycle composition and security boundaries; source excerpts directly establish controller routing and the dedicated-engine installation path. Several capability branches are documented but their detailed runtime wiring was not sampled, so those relationships are omitted or cited to the README.
Main entry points: host-launcher.mjs Stage launcher · stage-runtime.mjs Stage runtime · shared-worker-admission.mjs Shared job admission · nibfin-controller.mjs Controller CLI
Components 24
Entry and adoption
- Controller CLI
bin/nibfin-controller.mjs - Host adoption
src/host-adoption.mjs - Stage launcher
src/host-launcher.mjs - Issue wake
src/host-issue-wake.mjs
Authorization and admission
- GitHub reader
src/github-read.mjs - Native approval
src/github-approval.mjs - Caller continuity
src/caller-source.mjs - Shared job admission
src/security/shared-worker-admission.mjs
Stage execution
- Stage runtime
src/stage-runtime.mjs - Native observer
src/native-observer.mjs - Stage handlers
src/stage-handlers.mjs - Candidate capture
src/candidate-evidence.mjs - Offline hooks
src/docker-backend.mjs
Host isolation
- Engine installer
src/engine-install.mjs - Engine host
src/engine-host.mjs - Isolation probe
src/engine-probe.mjs - Shared Runner
src/shared-runner.mjs - Source verification
src/source-package.mjs
Evidence and delivery
- Operation journal
src/operation-journal.mjs - Evidence store
src/evidence-store.mjs - Native writes
src/github-write.mjs - PR recovery
src/recover-commit-pr.mjs - Evidence identity
src/identity.mjs
Other components
- GitHub Actions
Connections 22
- GitHub Actions → Controller CLI: invokes
- Controller CLI → Stage launcher: launches stage
bin/nibfin-controller.mjs - Controller CLI → Issue wake: launches wake
bin/nibfin-controller.mjs - Stage launcher → Host adoption: validates adoption
src/host-launcher.mjs - Stage launcher → GitHub reader: reads GitHub
src/host-launcher.mjs - Stage launcher → Native approval: checks approval
src/host-launcher.mjs - Stage launcher → Stage runtime: starts lifecycle
- Stage runtime → Native observer: refreshes observations
- Stage runtime → Stage handlers: dispatches stages
- Stage runtime → Operation journal: records operations
- Stage handlers → Candidate capture: captures candidate
- Stage handlers → Offline hooks: runs offline hooks
- Shared job admission → Caller continuity: checks continuity
src/security/shared-worker-admission.mjs - Shared job admission → Shared Runner: validates workflow
src/security/shared-worker-admission.mjs - Shared job admission → GitHub reader: reads assigned job
src/security/shared-worker-admission.mjs - Engine installer → Engine host: configures host
src/engine-install.mjs - Engine installer → Isolation probe: verifies isolation
src/engine-install.mjs - Engine host → Source verification: verifies installed source
src/engine-host.mjs - Candidate capture → Evidence store: retains evidence
- Stage runtime → Native writes: authorizes writes
- Native writes → PR recovery: publishes changes
- Operation journal → Evidence identity: binds records