@fusengine/harness 0.1.93 → 0.1.94

package/dist/cli/bin.mjs

@@ -4,9 +4,9 @@ import { r as resolveTtlSec } from "../ttl-Dgwg_QAv.mjs";
 import { r as loadDotenv } from "../dotenv-C1LkcfW-.mjs";
 import { t as detectHarness } from "../harness-BMuLJ9lm.mjs";
 import { t as claudeHome } from "../home-state-oUGFB4ds.mjs";
-import { f as checkStaged, m as stagedFiles, p as stagedContent, t as runPrd } from "../prd-PvK7PKWS.mjs";
+import { f as checkStaged, m as stagedFiles, p as stagedContent, t as runPrd } from "../prd-CixxWJIR.mjs";
 import { n as writeInitFile, t as initFor } from "../run-GHAMqcOn.mjs";
-import { $ as runDoctor, Bt as todayUtc, I as respond, Q as notify, et as runningVersion, t as handleHook, tt as versionBanner } from "../handle-B-g9KL_9.mjs";
+import { $ as runDoctor, Bt as todayUtc, I as respond, Q as notify, et as runningVersion, t as handleHook, tt as versionBanner } from "../handle-CDgBbPRz.mjs";
 import { r as cursorEventContract } from "../normalize-Dy8g9Ybl.mjs";
 import { delimiter, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readSync, readdirSync, writeFileSync } from "node:fs";

package/dist/cli/index.mjs

@@ -1,2 +1,2 @@
-import { a as renderJson, c as positionalArgs, d as resolvePrdArgs, f as checkStaged, i as runPrdStatus, l as readFlag, m as stagedFiles, n as runPrdCompact, o as renderTable, p as stagedContent, r as runPrdValidate, s as hasJsonFlag, t as runPrd, u as resolveAndLoadEnv } from "../prd-PvK7PKWS.mjs";
+import { a as renderJson, c as positionalArgs, d as resolvePrdArgs, f as checkStaged, i as runPrdStatus, l as readFlag, m as stagedFiles, n as runPrdCompact, o as renderTable, p as stagedContent, r as runPrdValidate, s as hasJsonFlag, t as runPrd, u as resolveAndLoadEnv } from "../prd-CixxWJIR.mjs";
 export { checkStaged, hasJsonFlag, positionalArgs, readFlag, renderJson, renderTable, resolveAndLoadEnv, resolvePrdArgs, runPrd, runPrdCompact, runPrdStatus, runPrdValidate, stagedContent, stagedFiles };

package/dist/{handle-B-g9KL_9.mjs → handle-CDgBbPRz.mjs}

@@ -15,7 +15,7 @@ import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 import { a as nowStamp, l as throttleMs, n as readRoots, o as readState, s as setStateField, t as addRoot } from "./registry-IhHk2KlT.mjs";
 import { d as loadIndex, i as cacheLookupMeta, n as webfetchCacheWrite, o as cacheLookupSubstringMeta, t as mcpCacheWrite, u as extractText } from "./mcp-store-BkBDmuxN.mjs";
 import { t as loadRefs } from "./loader-AGz4nK7d.mjs";
-import { E as isPrdScopedPath, S as subTasksOf, T as classifyPrdPath, _ as readTaskFileSync, a as isPrdEnabled, b as filesOf, c as crossCheckTask, d as readAgentReport, f as readAgentReportSync, g as readTaskFile, h as readRouterSync, i as taskStart, l as hasAnyViolations, m as readRouter, n as taskComplete, p as readAllTaskFiles, r as taskCreate, s as prdProjectRoot, t as acquireLock, u as incompleteSubTasks } from "./apex-task-store-Cb65rE5i.mjs";
+import { C as isCompacted, D as classifyPrdPath, O as isPrdScopedPath, S as filesOf, _ as readRouterSync, a as taskCreate, d as hasAnyViolations, f as incompleteSubTasks, g as readRouter, h as readAllTaskFiles, i as taskComplete, l as prdProjectRoot, m as readAgentReportSync, o as taskStart, p as readAgentReport, r as acquireLock, s as isPrdEnabled, t as canPromoteRouterEntry, u as crossCheckTask, v as readTaskFile, w as subTasksOf, y as readTaskFileSync } from "./prd-compact-BE45t8UR.mjs";
 import { a as sleep, i as readText$1, n as pathExists, o as spawnCapture, s as writeText, t as collectFiles } from "./runtime-io-DuumUeE6.mjs";
 import { C as recordPrdViolation, D as trivialCount, E as recordTrivialEdit, O as apexAuthorizationGate, S as recordPrdStopBlocked, T as recordTarget, _ as prdAlreadyBlocked, a as journalLogPath, b as recordDoc, c as appendEvent, d as signTrack, f as verifyTrack, g as emptyTrack, h as agentsFresh, i as withTrack, l as withTrackLockSync, o as readTrackSync, p as writeLastNonce, r as trackJournalEnabled, s as diffTrackEvents, t as loadTrack, u as LOCK_FAILED, v as recordAgent, w as recordRefRead, x as recordPrdOwner, y as recordBrainstormRequired } from "./store-BVY6gIYM.mjs";
 import { i as parseApplyPatch, n as canonicalizeMcpToolName, r as canonicalizeCodexShellTool, t as isBypassPermissions } from "./permission-mode-B-SFyR0X.mjs";
@@ -7853,6 +7853,65 @@ function persistStopBlocked(trackFilePath, track, key, now) {
 		writeLastNonce(envelope.nonce);
 	});
 }
+/** Task names whose task-PRD is fully validated (every agent, every sub-task) but not yet compacted (`prd-compact.ts`'s own per-agent test, applied task-wide). */
+function compactableTasks(router, taskFiles) {
+	const ready = [];
+	for (const task of Object.keys(router)) {
+		const taskFile = taskFiles[task];
+		if (!taskFile || canPromoteRouterEntry(taskFile)) continue;
+		if (Object.values(taskFile).every((entry) => {
+			if (isCompacted(entry)) return true;
+			const subs = Object.values(subTasksOf(entry));
+			return subs.length > 0 && subs.every((s) => s.status === "validated");
+		})) ready.push(task);
+	}
+	return ready;
+}
+/** Names the compactable task(s) and the exact `harness prd compact` invocation (verified against `cli/prd/compact.ts`'s own usage string). */
+function compactHintText(tasks) {
+	if (tasks.length === 1) return `PRD task "${tasks[0]}" is fully validated and ready to compact. Run \`harness prd compact ${tasks[0]}\`.`;
+	return `PRD tasks fully validated and ready to compact: ${tasks.join(", ")}. Run \`harness prd compact <task>\` for each.`;
+}
+/**
+* Non-blocking "ready to compact" hint. Target-agnostic by design: an id
+* allowlist here would silently go stale the day a target's real Stop wiring
+* changes, so this mirrors the SAME per-target form choice as the block path
+* directly below instead of hardcoding one target — kimi/gemini-cli/cline
+* get their own native `respond()` inform envelope, everyone else gets the
+* `Stop` `additionalContext` channel. Whether this function is ever REACHED
+* for a given id is a wiring question, not a code question: measured live
+* against the real hooks.json this project ships (claude-plugins/
+* codex-plugins/kimi-code-plugins) plus each target's own hook docs — only
+* Codex's Stop wiring is a plain `hook codex core` with no short-circuit;
+* claude-code's and Kimi's own Stop hook always carries `--sound stop`,
+* which exits in `maybePlaySound()` (`src/cli/hook-sound.ts`) before stdin
+* is ever read, and hermes/gemini-cli/cline have no event literally named
+* `Stop` in their own documented hook taxonomy at all — see prd.md's Known
+* limitations for the full measurement. One-shot per session, on a marker
+* key DISTINCT from the block-once key so neither shadows the other.
+* @param id - Harness target id.
+* @param payload - The raw Stop hook payload.
+* @param router - The parsed router.
+* @param taskFiles - Every router task's parsed task-PRD (or `null`).
+* @param track - The current session track.
+* @param trackFilePath - The session track file path.
+* @param now - Event clock.
+* @returns The native non-blocking stdout (once per session), else `""`.
+*/
+function compactReminder(id, payload, router, taskFiles, track, trackFilePath, now) {
+	const ready = compactableTasks(router, taskFiles);
+	if (ready.length === 0) return "";
+	const key = `${typeof payload.session_id === "string" ? payload.session_id : "unknown"}:StopCompactHint`;
+	if (prdAlreadyBlocked(track, key)) return "";
+	persistStopBlocked(trackFilePath, track, key, now);
+	const text = compactHintText(ready);
+	if (id === "kimi" || id === "gemini-cli" || id === "cline") return respond(id, {
+		kind: "inform",
+		title: "PRD compact",
+		reason: text
+	}, "Stop");
+	return contextResponse("Stop", text);
+}
 /**
 * Run the PRD lead-Stop block-once gate.
 * @param payload - The raw Stop hook payload.
@@ -7860,7 +7919,8 @@ function persistStopBlocked(trackFilePath, track, key, now) {
 * @param id - Harness target id.
 * @param trackFilePath - The session track file path.
 * @param now - Event clock.
-* @returns The native block stdout (once per session), else `""`.
+* @returns The native block stdout (once per session); else the compact
+* hint (once per session, whichever ids' real Stop wiring reaches it); else `""`.
 */
 function prdStopGate(payload, cwd, id, trackFilePath, now) {
 	if (!isPrdEnabled(cwd, id)) return "";
@@ -7871,7 +7931,8 @@ function prdStopGate(payload, cwd, id, trackFilePath, now) {
 	if (!router) return "";
 	const track = readTrackSync(trackFilePath, trackJournalEnabled());
 	if (!((track.prdViolations?.length ?? 0) > 0)) {
-		if (!hasAnyViolations(router, readAllTaskFilesSync(root, homeSeg, router))) return "";
+		const taskFiles = readAllTaskFilesSync(root, homeSeg, router);
+		if (!hasAnyViolations(router, taskFiles)) return compactReminder(id, payload, router, taskFiles, track, trackFilePath, now);
 	}
 	const key = `${typeof payload.session_id === "string" ? payload.session_id : "unknown"}:Stop`;
 	if (prdAlreadyBlocked(track, key)) return "";

package/dist/{prd-PvK7PKWS.mjs → prd-CixxWJIR.mjs}

@@ -3,7 +3,7 @@ import { t as isCodeFile } from "./project-root-3kk7gCOp.mjs";
 import { t as evaluate } from "./evaluate-CMiIqHeH.mjs";
 import { r as harnessHomeSegment } from "./apex-target-Xc2M32Pl.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
-import { C as withRouterStatus, D as prdDir, O as prdRouterPath, S as subTasksOf, c as crossCheckTask, d as readAgentReport, g as readTaskFile, m as readRouter, o as isPrdFlagSet, p as readAllTaskFiles, t as acquireLock, u as incompleteSubTasks, v as writeRouter, w as withSubTaskValidated, x as isCompacted, y as writeTaskFile } from "./apex-task-store-Cb65rE5i.mjs";
+import { A as prdRouterPath, C as isCompacted, E as withSubTaskValidated, T as withRouterStatus, b as writeRouter, c as isPrdFlagSet, f as incompleteSubTasks, g as readRouter, h as readAllTaskFiles, k as prdDir, n as compactTaskFile, p as readAgentReport, r as acquireLock, u as crossCheckTask, v as readTaskFile, w as subTasksOf, x as writeTaskFile } from "./prd-compact-BE45t8UR.mjs";
 import { join } from "node:path";
 import { existsSync } from "node:fs";
 import { homedir } from "node:os";
@@ -407,34 +407,6 @@ async function runPrdValidate(argv, cwd, env = process.env) {
 	return 0;
 }
 //#endregion
-//#region src/policy/prd/prd-compact.ts
-/** Collapses fully-validated task-PRD agent entries to their compact shape. Pure — no fs. */
-/** Collapses one agent entry to the compacted shape ONLY when every sub-task is `validated`; else returns it unchanged. */
-function compactAgentEntry(e, at) {
-	if (isCompacted(e)) return e;
-	const subTasks = Object.values(subTasksOf(e));
-	if (subTasks.length === 0 || !subTasks.every((s) => s.status === "validated")) return e;
-	return {
-		status: "validated",
-		files: e.files,
-		"validated-at": at
-	};
-}
-/** Compacts every eligible agent entry in a task-PRD; reports which agent names got collapsed. */
-function compactTaskFile(taskFile, at) {
-	const compacted = [];
-	const file = {};
-	for (const [agent, entry] of Object.entries(taskFile)) {
-		const next = compactAgentEntry(entry, at);
-		if (next !== entry) compacted.push(agent);
-		file[agent] = next;
-	}
-	return {
-		file,
-		compacted
-	};
-}
-//#endregion
 //#region src/cli/prd/compact.ts
 /**
 * `harness prd compact <task> [--id] [--root]` — collapses every fully

package/dist/{apex-task-store-Cb65rE5i.mjs → prd-compact-BE45t8UR.mjs}

@@ -464,4 +464,36 @@ async function taskComplete(file, id) {
 	await writeJsonFile(file, data);
 }
 //#endregion
-export { withRouterStatus as C, prdDir as D, isPrdScopedPath as E, prdRouterPath as O, subTasksOf as S, classifyPrdPath as T, readTaskFileSync as _, isPrdEnabled as a, filesOf as b, crossCheckTask as c, readAgentReport as d, readAgentReportSync as f, readTaskFile as g, readRouterSync as h, taskStart as i, hasAnyViolations as l, readRouter as m, taskComplete as n, isPrdFlagSet as o, readAllTaskFiles as p, taskCreate as r, prdProjectRoot as s, acquireLock as t, incompleteSubTasks as u, writeRouter as v, withSubTaskValidated as w, isCompacted as x, writeTaskFile as y };
+//#region src/policy/prd/prd-compact.ts
+/** Collapses fully-validated task-PRD agent entries to their compact shape. Pure — no fs. */
+/** Collapses one agent entry to the compacted shape ONLY when every sub-task is `validated`; else returns it unchanged. */
+function compactAgentEntry(e, at) {
+	if (isCompacted(e)) return e;
+	const subTasks = Object.values(subTasksOf(e));
+	if (subTasks.length === 0 || !subTasks.every((s) => s.status === "validated")) return e;
+	return {
+		status: "validated",
+		files: e.files,
+		"validated-at": at
+	};
+}
+/** Compacts every eligible agent entry in a task-PRD; reports which agent names got collapsed. */
+function compactTaskFile(taskFile, at) {
+	const compacted = [];
+	const file = {};
+	for (const [agent, entry] of Object.entries(taskFile)) {
+		const next = compactAgentEntry(entry, at);
+		if (next !== entry) compacted.push(agent);
+		file[agent] = next;
+	}
+	return {
+		file,
+		compacted
+	};
+}
+/** True when every agent in the task-PRD is already compacted+validated. */
+function canPromoteRouterEntry(taskFile) {
+	return Object.values(taskFile).every((entry) => isCompacted(entry));
+}
+//#endregion
+export { prdRouterPath as A, isCompacted as C, classifyPrdPath as D, withSubTaskValidated as E, isPrdScopedPath as O, filesOf as S, withRouterStatus as T, readRouterSync as _, taskCreate as a, writeRouter as b, isPrdFlagSet as c, hasAnyViolations as d, incompleteSubTasks as f, readRouter as g, readAllTaskFiles as h, taskComplete as i, prdDir as k, prdProjectRoot as l, readAgentReportSync as m, compactTaskFile as n, taskStart as o, readAgentReport as p, acquireLock as r, isPrdEnabled as s, canPromoteRouterEntry as t, crossCheckTask as u, readTaskFile as v, subTasksOf as w, writeTaskFile as x, readTaskFileSync as y };

package/dist/runtime/index.mjs

@@ -1,6 +1,6 @@
 import { r as projectLayout } from "../layout-KWoE_Mqn.mjs";
 import { a as sanitizeSessionId, c as sessionsDir, i as loadSessionState, n as fuseHarnessHome, o as saveSessionState, r as fusengineCache, s as sessionStatePath, t as claudeHome } from "../home-state-oUGFB4ds.mjs";
-import { A as gate, At as taskContext, B as writePluginMap, Bt as todayUtc, C as trackEnrichment, Ct as removeOldFiles, D as DEFAULT_WINDOW_MS, Dt as projectContext, E as dispatchAipilot, Et as gitContext, F as extractSymbols, Ft as isoUtc, G as mergeLines, H as isProject, I as respond, It as loadSecurityState, J as listChildren, K as countFiles, L as dispatchLessons, Lt as saveSecurityState, M as preCommitGate, Mt as projectHash, N as detectDuplication, Nt as trackFile, O as REQUIRED_AGENTS, Ot as claudeMdKey, P as dryGate, Pt as normalizeEvent, R as cartoSessionStart, Rt as securityStateDir, S as trackSkillRead, St as purgeTtlTree, T as aipilotPostToolUse, Tt as devContext, U as writeTree, V as generateProjectMap, W as loadEnriched, X as lessonsFileFor, Y as lessonsArchiveFileFor, Z as lessonsStateFileFor, _ as securityAdvisory, _t as injectRules, a as mcpPostStore, at as cleanupSession, b as trackWatchResearch, bt as sessionStartCore, c as WEBFETCH_TTL_MS, ct as validateTeammateOutput, d as queryOf, dt as validateTailwind, f as lifecycleStdout, ft as validateSolidGate, g as dispatchMemory, gt as solidDetectStart, h as seoPostToolUseResponse, ht as detectSolidProfile, i as recordActivity, it as validateRulesLoaded, j as gateCommandCandidates, jt as defaultStateDir, k as TRIVIAL_BUDGET, kt as promptSubmitContext, l as cacheQueryOf, lt as trackAgentMemory, m as seoPostToolUse, mt as countLoc, n as activityFor, nt as postEditTypescript, o as mcpPreIntercept, ot as saveApexState, p as postEditContext, pt as checkFileSize, q as getFileDesc, r as handlePre, rt as trackSessionChanges, s as MCP_TTL_MS, st as logToolFailure, t as handleHook, u as isMcpTool, ut as subagentCacheContext, v as securityAdvisoryForPatch, vt as readRules, w as dispatchLifecycle, wt as trimLogFile, x as trackMcpResearch, xt as pruneEmptyDirs, y as postTrackingSideEffects, yt as runSessionStartCleanups, z as generateEcosystemMap, zt as securityStatePath } from "../handle-B-g9KL_9.mjs";
+import { A as gate, At as taskContext, B as writePluginMap, Bt as todayUtc, C as trackEnrichment, Ct as removeOldFiles, D as DEFAULT_WINDOW_MS, Dt as projectContext, E as dispatchAipilot, Et as gitContext, F as extractSymbols, Ft as isoUtc, G as mergeLines, H as isProject, I as respond, It as loadSecurityState, J as listChildren, K as countFiles, L as dispatchLessons, Lt as saveSecurityState, M as preCommitGate, Mt as projectHash, N as detectDuplication, Nt as trackFile, O as REQUIRED_AGENTS, Ot as claudeMdKey, P as dryGate, Pt as normalizeEvent, R as cartoSessionStart, Rt as securityStateDir, S as trackSkillRead, St as purgeTtlTree, T as aipilotPostToolUse, Tt as devContext, U as writeTree, V as generateProjectMap, W as loadEnriched, X as lessonsFileFor, Y as lessonsArchiveFileFor, Z as lessonsStateFileFor, _ as securityAdvisory, _t as injectRules, a as mcpPostStore, at as cleanupSession, b as trackWatchResearch, bt as sessionStartCore, c as WEBFETCH_TTL_MS, ct as validateTeammateOutput, d as queryOf, dt as validateTailwind, f as lifecycleStdout, ft as validateSolidGate, g as dispatchMemory, gt as solidDetectStart, h as seoPostToolUseResponse, ht as detectSolidProfile, i as recordActivity, it as validateRulesLoaded, j as gateCommandCandidates, jt as defaultStateDir, k as TRIVIAL_BUDGET, kt as promptSubmitContext, l as cacheQueryOf, lt as trackAgentMemory, m as seoPostToolUse, mt as countLoc, n as activityFor, nt as postEditTypescript, o as mcpPreIntercept, ot as saveApexState, p as postEditContext, pt as checkFileSize, q as getFileDesc, r as handlePre, rt as trackSessionChanges, s as MCP_TTL_MS, st as logToolFailure, t as handleHook, u as isMcpTool, ut as subagentCacheContext, v as securityAdvisoryForPatch, vt as readRules, w as dispatchLifecycle, wt as trimLogFile, x as trackMcpResearch, xt as pruneEmptyDirs, y as postTrackingSideEffects, yt as runSessionStartCleanups, z as generateEcosystemMap, zt as securityStatePath } from "../handle-CDgBbPRz.mjs";
 //#region src/runtime/storage.ts
 /**
 * The project's single state dir (`<root>/.harness`) — neutral + harness-agnostic,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fusengine/harness",
-	"version": "0.1.93",
+	"version": "0.1.94",
 	"description": "Harness-agnostic toolkit for AI coding agents: runtime harness detection (Claude Code, Codex, Cursor, Cline, Gemini, Aider...), pure policy core (env config, project/framework detection, SOLID/file-size limits, APEX freshness, guard patterns, portable prompts), cache, project memory, ref routing, state/locks, statusline, per-harness adapters (Claude/Cursor/Cline/Gemini) and a cli-mode harness-check binary. Bun-native, with a built dist for Node + bundlers.",
 	"type": "module",
 	"module": "src/index.ts",

package/src/runtime/prd/prd-stop-gate.ts

@@ -9,8 +9,8 @@
 import { dirname } from "node:path";
 import { harnessHomeSegment } from "../../policy/apex-target";
 import {
-  hasAnyViolations, isPrdEnabled, prdProjectRoot, readRouterSync, readTaskFileSync,
-  type PrdRouter, type PrdTaskFile,
+  canPromoteRouterEntry, hasAnyViolations, isCompacted, isPrdEnabled, prdProjectRoot,
+  readRouterSync, readTaskFileSync, subTasksOf, type PrdRouter, type PrdTaskFile,
 } from "../../policy/prd";
 import { journalLogPath, readTrackSync } from "../../tracking/track-compact";
 import { trackJournalEnabled } from "../../tracking/store";
@@ -20,7 +20,7 @@ import { prdAlreadyBlocked, recordPrdStopBlocked, type SessionTrack } from "../.
 import { signTrack, writeLastNonce } from "../../tracking/integrity";
 import { withTrackLockSync } from "../../tracking/track-lock-sync";
 import { atomicWrite } from "../../util/json-io";
-import { blockResponse } from "../../adapters/claude";
+import { blockResponse, contextResponse } from "../../adapters/claude";
 import { respond } from "../respond";
 
 const REASON = "PRD cross-check found unresolved violation(s): a task/sub-task is marked validated without a matching done report. Run `harness prd status` for details.";
@@ -57,6 +57,71 @@ function persistStopBlocked(trackFilePath: string, track: SessionTrack, key: str
   });
 }
 
+/** Task names whose task-PRD is fully validated (every agent, every sub-task) but not yet compacted (`prd-compact.ts`'s own per-agent test, applied task-wide). */
+function compactableTasks(router: PrdRouter, taskFiles: Record<string, PrdTaskFile | null>): string[] {
+  const ready: string[] = [];
+  for (const task of Object.keys(router)) {
+    const taskFile = taskFiles[task];
+    if (!taskFile || canPromoteRouterEntry(taskFile)) continue; // missing/unparseable, or already fully compacted
+    const fullyValidated = Object.values(taskFile).every((entry) => {
+      if (isCompacted(entry)) return true;
+      const subs = Object.values(subTasksOf(entry));
+      return subs.length > 0 && subs.every((s) => s.status === "validated");
+    });
+    if (fullyValidated) ready.push(task);
+  }
+  return ready;
+}
+
+/** Names the compactable task(s) and the exact `harness prd compact` invocation (verified against `cli/prd/compact.ts`'s own usage string). */
+function compactHintText(tasks: string[]): string {
+  if (tasks.length === 1) return `PRD task "${tasks[0]}" is fully validated and ready to compact. Run \`harness prd compact ${tasks[0]}\`.`;
+  return `PRD tasks fully validated and ready to compact: ${tasks.join(", ")}. Run \`harness prd compact <task>\` for each.`;
+}
+
+/**
+ * Non-blocking "ready to compact" hint. Target-agnostic by design: an id
+ * allowlist here would silently go stale the day a target's real Stop wiring
+ * changes, so this mirrors the SAME per-target form choice as the block path
+ * directly below instead of hardcoding one target — kimi/gemini-cli/cline
+ * get their own native `respond()` inform envelope, everyone else gets the
+ * `Stop` `additionalContext` channel. Whether this function is ever REACHED
+ * for a given id is a wiring question, not a code question: measured live
+ * against the real hooks.json this project ships (claude-plugins/
+ * codex-plugins/kimi-code-plugins) plus each target's own hook docs — only
+ * Codex's Stop wiring is a plain `hook codex core` with no short-circuit;
+ * claude-code's and Kimi's own Stop hook always carries `--sound stop`,
+ * which exits in `maybePlaySound()` (`src/cli/hook-sound.ts`) before stdin
+ * is ever read, and hermes/gemini-cli/cline have no event literally named
+ * `Stop` in their own documented hook taxonomy at all — see prd.md's Known
+ * limitations for the full measurement. One-shot per session, on a marker
+ * key DISTINCT from the block-once key so neither shadows the other.
+ * @param id - Harness target id.
+ * @param payload - The raw Stop hook payload.
+ * @param router - The parsed router.
+ * @param taskFiles - Every router task's parsed task-PRD (or `null`).
+ * @param track - The current session track.
+ * @param trackFilePath - The session track file path.
+ * @param now - Event clock.
+ * @returns The native non-blocking stdout (once per session), else `""`.
+ */
+function compactReminder(
+  id: string, payload: Record<string, unknown>, router: PrdRouter,
+  taskFiles: Record<string, PrdTaskFile | null>, track: SessionTrack, trackFilePath: string, now: number,
+): string {
+  const ready = compactableTasks(router, taskFiles);
+  if (ready.length === 0) return "";
+  const sessionId = typeof payload.session_id === "string" ? payload.session_id : "unknown";
+  const key = `${sessionId}:StopCompactHint`;
+  if (prdAlreadyBlocked(track, key)) return "";
+  persistStopBlocked(trackFilePath, track, key, now);
+  const text = compactHintText(ready);
+  if (id === "kimi" || id === "gemini-cli" || id === "cline") {
+    return respond(id, { kind: "inform", title: "PRD compact", reason: text }, "Stop");
+  }
+  return contextResponse("Stop", text);
+}
+
 /**
  * Run the PRD lead-Stop block-once gate.
  * @param payload - The raw Stop hook payload.
@@ -64,7 +129,8 @@ function persistStopBlocked(trackFilePath: string, track: SessionTrack, key: str
  * @param id - Harness target id.
  * @param trackFilePath - The session track file path.
  * @param now - Event clock.
- * @returns The native block stdout (once per session), else `""`.
+ * @returns The native block stdout (once per session); else the compact
+ * hint (once per session, whichever ids' real Stop wiring reaches it); else `""`.
  */
 export function prdStopGate(payload: Record<string, unknown>, cwd: string, id: string, trackFilePath: string, now: number): string {
   if (!isPrdEnabled(cwd, id)) return "";
@@ -82,7 +148,7 @@ export function prdStopGate(payload: Record<string, unknown>, cwd: string, id: s
   const trackHasViolations = (track.prdViolations?.length ?? 0) > 0;
   if (!trackHasViolations) {
     const taskFiles = readAllTaskFilesSync(root, homeSeg, router);
-    if (!hasAnyViolations(router, taskFiles)) return "";
+    if (!hasAnyViolations(router, taskFiles)) return compactReminder(id, payload, router, taskFiles, track, trackFilePath, now);
   }
 
   const sessionId = typeof payload.session_id === "string" ? payload.session_id : "unknown";