stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 1 Releases Wiki Activity
Files
7b5bdcf4d3bee4e6f398d0226ba8cd3c2754e07a
git.stella-ops.org/docs/modules/scanner/operations/entrypoint-lang-ruby.md
master 7b5bdcf4d3 feat(docs): Add comprehensive documentation for Vexer, Vulnerability Explorer, and Zastava modules 
- Introduced AGENTS.md, README.md, TASKS.md, and implementation_plan.md for Vexer, detailing mission, responsibilities, key components, and operational notes.
- Established similar documentation structure for Vulnerability Explorer and Zastava modules, including their respective workflows, integrations, and observability notes.
- Created risk scoring profiles documentation outlining the core workflow, factor model, governance, and deliverables.
- Ensured all modules adhere to the Aggregation-Only Contract and maintain determinism and provenance in outputs.
2025-10-30 00:09:39 +02:00

1.3 KiB
Raw Blame History

Entry-Point Runtime — Ruby

Signals to gather

  • argv0 equals ruby, bundle, bundler, rackup, puma, unicorn, sidekiq, or resque.
  • Bundler scripts: bundle exec <cmd>; Gemfile and Gemfile.lock.
  • Rails and Rack hints: config.ru, bin/rails, bin/rake.
  • Background jobs: sidekiq, delayed_job, resque.
  • Environment variables (RAILS_ENV, RACK_ENV, BUNDLE_GEMFILE).

Implementation notes

  • Normalise bundle exec by skipping the bundler wrapper and targeting the actual command.
  • Resolve script paths relative to the working directory.
  • For puma/unicorn, parse config files (config/puma.rb, config/unicorn.rb) to gather ports/workers.
  • Recognise foreman start or overmind launching Procfile processes—may devolve to Supervisor classification.

Evidence & scoring

  • Boost confidence when Gemfile.lock exists and the requested server script is found.
  • Add evidence for env variables and config files.
  • Penalise ambiguous CLI invocations or missing artefacts.

Edge cases

  • Alpine distroless images may rely on ruby symlinks; confirm binary presence.
  • JRuby (running on Java) may trigger both Ruby and Java signals—prefer Ruby if ruby/jruby interpreter is explicit.
  • Supervisors launching multiple Ruby workers should produce a single Supervisor entry with Ruby children.