stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 16 Releases Wiki Activity
Files
bc0762e97d251723854b9c4e482b218c8efb1e04
git.stella-ops.org/docs/modules/scanner/cli-node.md
StellaOps Bot 909d9b6220
Some checks failed
AOC Guard CI / aoc-guard (push) Has been cancelled
Details
AOC Guard CI / aoc-verify (push) Has been cancelled
Details
Docs CI / lint-and-preview (push) Has been cancelled
Details
Policy Lint & Smoke / policy-lint (push) Has been cancelled
Details
up
2025-12-01 21:16:22 +02:00

1.2 KiB
Raw Blame History

Scanner CLI: Node Analyzer Plug-in

Commands (to be exposed under stella node)

  • stella node inspect <path> — run language analyzer against a directory or bundle and emit JSON (AOC compliant).
  • stella node resolve <specifier> --root <path> — run the resolver (CJS+ESM) with condition set auto-detected.
  • stella node runtime-ingest <evidence.ndjson> — convert runtime evidence NDJSON into language records (stdout JSON).

Packaging expectations

  • Plug-in manifest: plugins/scanner/node/manifest.json (schemaVersion 1.0, id stellaops.analyzer.lang.node, version 0.1.0, capabilities: language-analyzer · node · npm · pnpm · pnp · runtime-optional).
  • Payload: StellaOps.Scanner.Analyzers.Lang.Node.dll plus runtime hooks under plugins/scanner/node/runtime-hooks/ (CJS require hook and ESM loader).
  • Restart-time activation: Scanner services must restart to load new plug-in; manifest declares requiresRestart=true.

Offline Kit

  • Include plug-in binaries + manifest + hooks + CLI shim in Offline Kit bundle.
  • Document CLI usage with no network dependency; registries are never contacted.

Determinism

  • Resolver, observation, and runtime ingestion outputs are deterministic (sorted keys, hashed loader IDs, scrubbed paths).