{"ref":"artifact:saptools-cf-live-trace","page":"/artifacts/saptools-cf-live-trace","json":"/artifacts/saptools-cf-live-trace.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"saptools-cf-live-trace","name":"@saptools/cf-live-trace","artifact_type":"cli","ecosystem":"btp","domain":"developer-experience","origin_ring":"independent","description":{"one_line":"Injects a bounded HTTP trace hook into a running [Node.js](external:nodejs) app on SAP BTP Cloud Foundry and streams each request and response to the terminal as JSON.","short":"HTTP trace hook streaming a running CF Node.js app's traffic","what_it_solves":"Shows which HTTP requests a deployed [Node.js](external:nodejs) app receives and what it answers, with no change to the app's code. `cf-live-trace` attaches to the app's Node inspector through [@saptools/cf-inspector](artifact:saptools-cf-inspector), evaluates a hook that patches the `http` and `https` server prototypes, and streams one event per request with method, URL, status and duration; full events stay on disk as private JSON files for two hours, and `session replay` re-sends a captured request to another target such as a local server. It follows the route of the Live Trace feature in the SAP Tools extension for VS Code, under its own global name so the two do not collide. If SSH is disabled on the [Cloud Foundry](artifact:btp-cloud-foundry-runtime) app, it enables SSH and restarts the app before opening the tunnel. Captured headers and bodies can hold credentials and personal data: stdout redacts common credential query values and cuts bodies at 128 characters, and if cleanup fails the hook can stay in the process until it restarts."},"links":{"npm":"https://www.npmjs.com/package/@saptools/cf-live-trace","repo":"https://github.com/dongitran/saptools","docs":"https://github.com/dongitran/saptools/blob/main/packages/cf-live-trace/README.md"},"identity":{"author":"dongitran","license":"MIT"},"compat":{"deployment":["cf"]},"type_properties":{"distribution":{"value":["npm"],"sources":[{"url":"https://github.com/dongitran/saptools","title":"@saptools/cf-live-trace — README","checked":"2026-10-18","quote":"npm install -g @saptools/cf-live-trace"}]}},"provides":["capability:debugging"],"requires":[{"ref":"artifact:saptools-cf-inspector","for":"Attaches to the app's Node inspector over the Chrome DevTools Protocol to inject the trace hook.","requirement":"required","sources":[{"url":"https://github.com/dongitran/saptools/blob/main/packages/cf-live-trace/README.md","title":"dongitran/saptools — packages/cf-live-trace/README.md","checked":"2026-10-15","quote":"Attach to the Node inspector over CDP using `@saptools/cf-inspector`."}]},{"ref":"external:nodejs","for":"Runs on Node.js 20 or newer, with the official cf CLI on the path.","requirement":"required","sources":[{"url":"https://github.com/dongitran/saptools/blob/main/packages/cf-live-trace/README.md","title":"dongitran/saptools — packages/cf-live-trace/README.md","checked":"2026-10-15","quote":"Requires Node.js >= 20 and the official `cf` CLI on `PATH`."}]},{"ref":"artifact:btp-cloud-foundry-runtime","for":"The target is a Node.js app already running on SAP BTP Cloud Foundry.","requirement":"required","sources":[{"url":"https://github.com/dongitran/saptools/blob/main/packages/cf-live-trace/README.md","title":"dongitran/saptools — packages/cf-live-trace/README.md","checked":"2026-10-15","quote":"Runtime HTTP tracing for Node.js apps already running on Cloud Foundry."}]}],"provenance":{"discovered_via":[{"source":"source:curator"}],"first_seen":"2026-10-15"},"maintainers":["actor:dong-tran"],"contributors":["actor:dong-tran"],"drafted_with_ai":true},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"good","evidence":"2 months since release"},{"label":"Continuity","tier":"fair","evidence":"2 contributors, 1 publisher"},{"label":"Repository","tier":"good","evidence":"pushed 2026-09, not archived"}],"compatibility":[{"label":"Declared for","tier":"unknown","evidence":"no BTP release lines in the atlas"},{"label":"Survived majors","tier":"unknown","evidence":"no BTP release lines in the atlas"},{"label":"Maintainer's CI","tier":"good","evidence":"CodeQL Security Scan green, 2026-09-18"}],"practice":[{"label":"Tests","tier":"good","evidence":"679 test files"},{"label":"Docs","tier":"good","evidence":"docs site, README 10 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":9,"unit":"installs/week"},{"value":3,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-26","latest_version":"0.3.1","majors":{"0.1":{"version":"0.1.0","date":"2026-06-25"},"0.2":{"version":"0.2.0","date":"2026-07-01"},"0.3":{"version":"0.3.0","date":"2026-09-02"}},"license":"MIT","first_release":"2026-06-25","last_release":"2026-09-02","releases":13,"cadence_days":1,"maintainers":1,"repository":"git+https://github.com/dongitran/saptools.git","repository_directory":"packages/cf-live-trace","peer_cds":null,"dependencies":2,"node_engine":">=20.0.0","test_script":false,"types":true,"downloads_weekly":9,"downloads_monthly":31,"stars":3,"forks":0,"open_issues":1,"archived":false,"pushed_at":"2026-09-18","license_spdx":null,"org_owned":false,"default_branch":"main","created_at":"2026-04-03T14:04:40Z","open_prs":1,"tree_truncated":false,"test_files":679,"workflows":33,"other_ci":false,"readme_bytes":10748,"docs_files":0,"changelog":false,"license_file":false,"dts_files":2,"first_commit":"2026-06-25","last_commit":"2026-09-02","commits":22,"contributors":2,"ci_status":"success","ci_run_at":"2026-09-18","ci_workflow":"CodeQL Security Scan","ci_event":"push","readme_path":"packages/cf-live-trace/README.md","readme_sha":"886aab9c2204e27af45da898790e3cffeb0f525a","months_since_release":2,"dormant":false,"repo_read":"2026-10-26"},"release_notes":{"license":"MIT","quotable":true,"versions":[{"version":"0.3.1","date":"2026-09-02"},{"version":"0.3.0","date":"2026-09-02"},{"version":"0.2.1","date":"2026-07-16"},{"version":"0.2.0","date":"2026-07-01"},{"version":"0.1.9","date":"2026-06-30"},{"version":"0.1.8","date":"2026-06-30"},{"version":"0.1.6","date":"2026-06-29"},{"version":"0.1.5","date":"2026-06-29"},{"version":"0.1.4","date":"2026-06-26"},{"version":"0.1.3","date":"2026-06-26"},{"version":"0.1.2","date":"2026-06-26"},{"version":"0.1.1","date":"2026-06-25"},{"version":"0.1.0","date":"2026-06-25"}],"crawled_at":"2026-10-25"},"edges":{"maintainers":[{"ref":"actor:dong-tran","name":"Đông Trần","json":"/actors/dong-tran.json"}],"contributors":[{"ref":"actor:dong-tran","name":"Đông Trần","json":"/actors/dong-tran.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}