up

docs/modules/scanner/cli-node.md

@@ -0,0 +1,18 @@
+# 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).