@lincoln504/pi-research 1.5.1 → 1.5.2

package/docs/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.2] - 2026-08-22
+
+### Fixed
+
+- **SKILL.md's backgrounding guidance no longer invites double-backgrounding.** The old bullet ("append `&` and keep the PID") was written for shell tools with no background mechanism of their own; an agent following it inside a harness-level background call (e.g. `run_in_background: true` on Claude Code's Bash tool) forked the run and exited the tracked shell immediately, so the harness reported "completed (exit code 0)" seconds after launch while the research process kept running detached and untracked — repeatedly observed live, with a perfect correlation between the inner `&` and instant false-completion notifications across nine launches. The bullet now says to use exactly one mechanism: the harness's own background option when it exists (never combined with `&`), and `&`-plus-PID — waiting on the PID, not on any "completed" signal — only where no such option exists (`skills/pi-research/SKILL.md`).
+
 ## [1.5.1] - 2026-08-22
 
 Post-1.5.0 hardening pass driven by a full static-analysis battery (npm audit,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lincoln504/pi-research",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "Web research for your agents with smart and safe tooling + knowledge store",
   "type": "module",
   "private": false,

package/skills/pi-research/SKILL.md

@@ -2,7 +2,7 @@
 name: pi-research
 description: "Multi-agent web research for any coding agent. Use for anything requiring current information from the internet — news, trends, product/service/company facts, statistics, people, places, events, APIs, library behavior, or 'what is X / how does X work' questions. Also use to search a local knowledge store of previously researched findings before doing live research. Powered by the pi-research engine (search, stealth scraping, security databases, Stack Exchange). Not for reading local files, running project commands, or analyzing this repository's own source."
 license: MIT
-metadata: { "author": "Lincoln Deen", "version": "1.5.1", "package": "@lincoln504/pi-research", "engine": "pi-research-sdk", "openclaw": { "requires": { "bins": ["node"] } } }
+metadata: { "author": "Lincoln Deen", "version": "1.5.2", "package": "@lincoln504/pi-research", "engine": "pi-research-sdk", "openclaw": { "requires": { "bins": ["node"] } } }
 allowed-tools: Bash(node:*)
 ---
 
@@ -25,7 +25,14 @@ node "<SKILL_DIR>/scripts/run.mjs" status    [--json]
   `knowledge` 600000ms · `research --depth 1` 1500000ms · `--depth 2` 1800000ms · `--depth 3` 2400000ms.
   These already include headroom for the run to sit **queued** behind other runs on a
   busy machine (see below); don't shorten them on the assumption a slot is free.
-- **Background**: append `&` and keep the PID to work while a run completes; otherwise it runs foreground (blocks). Timeouts apply either way.
+- **Background — use ONE mechanism, never two.** If your shell tool has its own
+  background option (e.g. `run_in_background: true` on Claude Code's Bash tool), use
+  that alone and do **not** also append `&`: with both, the shell forks the run and
+  exits at once, the harness reports that instant exit as "completed" while the
+  research continues detached, and the completion notification is meaningless. Only
+  on a harness with no background option, append `&` and keep the PID — and then
+  wait on that PID, not on any "completed" signal, before reading output. Otherwise
+  it runs foreground (blocks). Timeouts apply either way.
 - **Several at once is fine.** Up to 3 runs execute concurrently machine-wide (shared
   with any other tool or agent on this machine); further runs **queue** for a slot and
   report `• queued: …` on stderr — that is normal, not a stall. Only if nothing frees