ptp-telemetry-stop

Stops the local ptp telemetry receiver after verified lockfile and port checks.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/AlmogMaayan/ptp --skill ptp-telemetry-stop-almogmaayan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ptp-telemetry-stop
Source: https://github.com/AlmogMaayan/ptp/tree/main/skills/ptp-telemetry-stop
Command: npx skills add https://github.com/AlmogMaayan/ptp --skill ptp-telemetry-stop-almogmaayan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Stopping a local telemetry receiver safely is harder than it looks: process ids get reused, lockfiles go stale, and a listener on a port may belong to a different store. This Skill defines a strict verify-before-signal methodology so the ptp telemetry receiver is terminated only when identity is fully confirmed, and its lockfile is removed only after the receiver is confirmed down. ## Core Features & Use Cases - Five-conjunct verification: Confirms the recorded pid is live, the probe answered, the launch token matches, the reported pid equals the recorded pid, and the store identity matches before signalling anything. - Ordered stop semantics: Reads the lockfile, probes the recorded port, reloads the lockfile after the probe, signals the process, and removes the lockfile only after the port is confirmed unserved. - Structured outcome vocabulary: Reports one JSON object per invocation with outcomes such as stopped, already-stopped, stale-lockfile, mismatched-lockfile, not-stopped, and refused. - Use Case: A developer finished a coding session and wants to shut down the local telemetry receiver without risking killing an unrelated process that reused the pid, or deleting the only record of a receiver that is still running. ## Quick Start Ask the agent to stop the ptp telemetry receiver for this repository using the ptp-telemetry-stop skill and report the JSON outcome.

Frequently Asked Questions about ptp-telemetry-stop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stop the ptp telemetry receiver?▼

Run the stop action via the ptp-telemetry-stop skill, which executes node ptp-otel-sink.js stop with the repository root. It verifies the lockfile and listener identity before signalling the process and reports a single JSON outcome object.

Why does telemetry stop refuse to kill a process on the recorded port?▼

Stop never terminates on a port answer alone because pids get reused and a listener may belong to a different store. It requires all five conjuncts to match: live pid, answered probe, matching launch token, matching reported pid, and matching store identity.

What happens if the telemetry lockfile is missing when stopping?▼

An absent lockfile is treated as unknown, not as stopped. The skill probes the configured telemetry port for a listener reporting this store; if nothing answers it reports already-stopped, and if a matching listener answers it reloads the self-healed lockfile and verifies normally.

Does stopping the telemetry receiver depend on telemetry.mode?▼

No. Unlike start, stop has no telemetry.mode gate and none may be added. A mode-gated stop would make a live receiver unstoppable through ptp once the mode was switched off.

Why is the lockfile sometimes left behind after a stop?▼

The lockfile is removed only after the receiver is confirmed down on the recorded port. If removal fails, the outcome is stopped with lockfile_removed false; for stale, mismatched, or refused outcomes the lockfile is deliberately left untouched.