19 lines
1.2 KiB
Markdown
19 lines
1.2 KiB
Markdown
# 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).
|