@dyyz1993/pi-coding-agent 0.74.27 → 0.74.29

package/dist/extensions/rules-engine/index.ts

@@ -11,6 +11,7 @@ import type {
 	MatchRecord,
 	ParsedRule,
 	RuleDetail,
+	RuleMatchStatus,
 	RuleSeverity,
 	RulesChannelContract,
 	RulesChannelEvent,
@@ -54,8 +55,21 @@ export default function rulesEnginePlugin(pi: ExtensionAPI) {
 	let hasSentSnapshot = false;
 	let _lastCwd = "";
 	let lastMessages: unknown[] = [];
-	/** Track which rule+file combos have been injected (ruleName -> Set<filePath>) */
-	let injectedRuleFiles: Map<string, Set<string>> = new Map();
+
+	/** Track which rule+file combos have been injected.
+	 *  Forward index: ruleName → Map<filePath, toolCallId>
+	 *  The toolCallId is the ID of the tool call that injected this rule+file combo,
+	 *  used to correlate with entries_invalidated events for precise cleanup. */
+	let injectedRuleFiles: Map<string, Map<string, string>> = new Map();
+
+	/** Reverse index: toolCallId → Array<{ ruleName, filePath }>
+	 *  Used to quickly find and remove entries when entries_invalidated fires. */
+	let injectionByToolCallId: Map<string, Array<{ ruleName: string; filePath: string }>> = new Map();
+
+	/** Set of toolCallIds whose entries have been invalidated (deleted/folded/summarized).
+	 *  When checking alreadyLoaded status, if the previous toolCallId is in this set,
+	 *  we mark the rule as "reloaded" instead of "already_loaded". */
+	let invalidatedToolCallIds: Set<string> = new Set();
 
 	function rebuildMatchHistory(messages: unknown[]): MatchRecord[] {
 		const history: MatchRecord[] = [];
@@ -414,10 +428,21 @@ export default function rulesEnginePlugin(pi: ExtensionAPI) {
 		const matching = getMatchingRules(targetPath);
 		if (matching.length === 0) return undefined;
 
+		// Determine status for each rule: loaded / already_loaded / reloaded
 		const matchedRuleDetails: MatchedRuleDetail[] = matching.map((r) => {
 			const ruleName = r.name;
-			const injectedFiles = injectedRuleFiles.get(ruleName);
-			const wasAlreadyLoaded = injectedFiles !== undefined && injectedFiles.has(targetPath);
+			const fileMap = injectedRuleFiles.get(ruleName);
+			const isInMap = fileMap !== undefined && fileMap.has(targetPath);
+
+			let status: RuleMatchStatus;
+			if (!isInMap) {
+				status = "loaded"; // never injected before
+			} else {
+				// Was in map — check if the injection was invalidated
+				const previousCallId = fileMap.get(targetPath)!;
+				const wasInvalidated = invalidatedToolCallIds.has(previousCallId);
+				status = wasInvalidated ? "reloaded" : "already_loaded";
+			}
 
 			return {
 				name: ruleName,
@@ -427,30 +452,48 @@ export default function rulesEnginePlugin(pi: ExtensionAPI) {
 					(r.frontmatter.globs ?? r.frontmatter.paths)?.find((p) => matchesAnyGlob([p], targetPath)) ||
 					(r.frontmatter.globs ?? r.frontmatter.paths)?.[0] ||
 					"",
-				alreadyLoaded: wasAlreadyLoaded || undefined,
+				status,
+				alreadyLoaded: status === "already_loaded" || undefined,
 			};
 		});
 
-		// Determine which rules are newly injected vs already loaded
-		const newRules = matching.filter((r) => {
-			const injectedFiles = injectedRuleFiles.get(r.name);
-			return !injectedFiles || !injectedFiles.has(targetPath);
+		// Rules that need (re-)injection: loaded or reloaded
+		const newRules = matching.filter((_r, i) => {
+			const s = matchedRuleDetails[i].status;
+			return s === "loaded" || s === "reloaded";
 		});
 		const allAlreadyLoaded = newRules.length === 0;
 
 		// Record that these rules have now been injected for this file
-		for (const r of matching) {
-			let injectedFiles = injectedRuleFiles.get(r.name);
-			if (!injectedFiles) {
-				injectedFiles = new Set();
-				injectedRuleFiles.set(r.name, injectedFiles);
+		const toolCallId = event.toolCallId;
+		for (let i = 0; i < matching.length; i++) {
+			const ruleName = matching[i].name;
+			let fileMap = injectedRuleFiles.get(ruleName);
+			if (!fileMap) {
+				fileMap = new Map();
+				injectedRuleFiles.set(ruleName, fileMap);
+			}
+			fileMap.set(targetPath, toolCallId);
+
+			// Update reverse index
+			let reverseEntries = injectionByToolCallId.get(toolCallId);
+			if (!reverseEntries) {
+				reverseEntries = [];
+				injectionByToolCallId.set(toolCallId, reverseEntries);
+			}
+			// Avoid duplicates for same rule+file on same toolCallId
+			if (!reverseEntries.some((e) => e.ruleName === ruleName && e.filePath === targetPath)) {
+				reverseEntries.push({ ruleName, filePath: targetPath });
 			}
-			injectedFiles.add(targetPath);
 		}
 
 		const hasCritical = matching.some((r) => r.frontmatter.severity === "critical");
 		const hasHigh = matching.some((r) => r.frontmatter.severity === "high");
 
+		// Determine overall status for the payload
+		const overallStatus: RuleMatchStatus | undefined =
+			allAlreadyLoaded ? "already_loaded" : matchedRuleDetails.every((d) => d.status === "reloaded") ? "reloaded" : "loaded";
+
 		channel.emit("matched", {
 			type: "matched",
 			filePath: targetPath,
@@ -459,10 +502,11 @@ export default function rulesEnginePlugin(pi: ExtensionAPI) {
 			toolCallId: event.toolCallId,
 			severity: hasCritical ? "warning" : hasHigh ? "warning" : "info",
 			timestamp: Date.now(),
+			status: overallStatus,
 			alreadyLoaded: allAlreadyLoaded || undefined,
 		});
 
-		// Only inject content for NEW rules (skip if all already loaded)
+		// Only inject content for rules that are loaded or reloaded (skip if all already loaded)
 		if (allAlreadyLoaded) {
 			return {
 				details: {
@@ -515,6 +559,8 @@ export default function rulesEnginePlugin(pi: ExtensionAPI) {
 		cachedMatchHash = "";
 		lastMessages = [];
 		injectedRuleFiles = new Map();
+		injectionByToolCallId = new Map();
+		invalidatedToolCallIds = new Set();
 		ctx.ui.setStatus("rules-engine", `Rules: ${rules.length} (re-injected after compact)`);
 	});
 
@@ -522,6 +568,30 @@ export default function rulesEnginePlugin(pi: ExtensionAPI) {
 		cachedMatchHash = "";
 		lastMessages = [];
 		injectedRuleFiles = new Map();
+		injectionByToolCallId = new Map();
+		invalidatedToolCallIds = new Set();
+	});
+
+	pi.on("entries_invalidated", async (event) => {
+		const eventToolCallIds = event.invalidatedToolCallIds;
+		if (eventToolCallIds.length === 0) return;
+
+		// Mark affected toolCallIds as invalidated so next tool_result
+		// can distinguish "reloaded" from "already_loaded"
+		for (const callId of eventToolCallIds) {
+			if (injectionByToolCallId.has(callId)) {
+				invalidatedToolCallIds.add(callId);
+			}
+		}
+
+		// Also scan forward map to find any tracked toolCallId that was invalidated
+		for (const [_ruleName, fileMap] of injectedRuleFiles) {
+			for (const [_filePath, trackedCallId] of fileMap) {
+				if (eventToolCallIds.includes(trackedCallId)) {
+					invalidatedToolCallIds.add(trackedCallId);
+				}
+			}
+		}
 	});
 
 	pi.on("turn_end", async () => {

package/dist/extensions/rules-engine/types.d.ts

@@ -65,12 +65,20 @@ export interface ScannedDir {
     fileCount: number;
     ruleNames: string[];
 }
+export type RuleMatchStatus = "loaded" | "already_loaded" | "reloaded";
 export interface MatchedRuleDetail {
     name: string;
     title: string;
     severity: RuleSeverity;
     matchedGlob: string;
-    /** True when this rule was already injected for the same file in a previous tool call */
+    /**
+     * Match status:
+     * - "loaded": first time injected for this file
+     * - "already_loaded": previously injected and still in context (skipped)
+     * - "reloaded": previously injected but was invalidated (context removed), now re-injected
+     */
+    status?: RuleMatchStatus;
+    /** @deprecated Use status instead. True when this rule was already injected for the same file. */
     alreadyLoaded?: boolean;
 }
 export interface MatchRecord {
@@ -117,7 +125,9 @@ export interface MatchedPayload {
     toolCallId: string;
     severity: "info" | "warning";
     timestamp: number;
-    /** True when all matched rules were already injected in a previous tool call */
+    /** Overall match status when all rules share the same state */
+    status?: RuleMatchStatus;
+    /** @deprecated Use status instead */
     alreadyLoaded?: boolean;
 }
 export interface InjectedPayload {

package/dist/extensions/rules-engine/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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","sourcesContent":["export type RuleSeverity = \"critical\" | \"high\" | \"medium\" | \"low\" | \"hint\";\n\nexport type RuleScope = \"user\" | \"pi\" | \"project\" | \"managed\";\n\nexport interface RuleFrontmatter {\n\tglobs?: string[];\n\tpaths?: string[];\n\tdescription?: string;\n\tseverity?: RuleSeverity;\n\tallowedTools?: string[];\n\twhenToUse?: string;\n\tversion?: string;\n\tmodel?: string;\n\tskills?: string;\n\teffort?: string;\n\tuserInvocable?: string;\n\tcontext?: \"inline\" | \"fork\";\n\tagent?: string;\n\tshell?: string;\n\tnotifyOnMatch?: boolean;\n\tskipInPrompt?: boolean;\n}\n\nexport interface ParsedRule {\n\tname: string;\n\tfilePath: string;\n\ttitle: string;\n\tcontent: string;\n\tscope: RuleScope;\n\tsource: string;\n\tfrontmatter: RuleFrontmatter;\n\tisUnconditional: boolean;\n}\n\nexport interface RuleCache {\n\trules: ParsedRule[];\n\tunconditional: ParsedRule[];\n\tconditional: ParsedRule[];\n\tloadedAt: number;\n}\n\nexport interface CachedRules {\n\trules: ParsedRule[];\n\tloadedAt: number;\n}\n\nexport interface RulesConfig {\n\tcacheTTL: number;\n\tnotifyOnLoad: boolean;\n\tnotifyOnMatch: boolean;\n\tdirs?: {\n\t\tuser?: string[];\n\t\tpi?: string[];\n\t\tproject?: string[];\n\t\tmanaged?: string[];\n\t};\n}\n\nexport interface RuleDetail {\n\tname: string;\n\ttitle: string;\n\tfilePath: string;\n\tscope: RuleScope;\n\tsource: string;\n\tseverity: RuleSeverity;\n\tisUnconditional: boolean;\n\tglobs: string[];\n\tdescription?: string;\n}\n\nexport interface ScannedDir {\n\tdir: string;\n\tfileCount: number;\n\truleNames: string[];\n}\n\nexport interface MatchedRuleDetail {\n\tname: string;\n\ttitle: string;\n\tseverity: RuleSeverity;\n\tmatchedGlob: string;\n\t/** True when this rule was already injected for the same file in a previous tool call */\n\talreadyLoaded?: boolean;\n}\n\nexport interface MatchRecord {\n\tfilePath: string;\n\truleNames: string[];\n\ttoolName: string;\n\ttoolCallId: string;\n\tseverity: \"info\" | \"warning\";\n\ttimestamp: number;\n\tmatchedRuleDetails?: MatchedRuleDetail[];\n}\n\nexport interface LifecycleEntry {\n\tevent: \"loaded\" | \"restored\" | \"injected\" | \"reloaded\" | \"unloaded\" | \"expired\";\n\tmessage: string;\n\truleCount?: number;\n\ttimestamp: number;\n\tdetails?: {\n\t\tscannedDirs?: ScannedDir[];\n\t\tconfigSource?: string;\n\t\tcacheHit?: boolean;\n\t\tinjectedRules?: Array<{ name: string; promptDelta: number }>;\n\t};\n}\n\nexport interface SnapshotPayload {\n\ttype: \"snapshot\";\n\trules: RuleDetail[];\n\tinjectedRuleNames: string[];\n\ttotalRules: number;\n\tunconditionalCount: number;\n\tconditionalCount: number;\n\tmatchHistory: MatchRecord[];\n\tlifecycleLog: LifecycleEntry[];\n\tloadedAt: number;\n\tcacheTTL: number;\n}\n\nexport interface MatchedPayload {\n\ttype: \"matched\";\n\tfilePath: string;\n\tmatchedRules: MatchedRuleDetail[];\n\ttoolName: string;\n\ttoolCallId: string;\n\tseverity: \"info\" | \"warning\";\n\ttimestamp: number;\n\t/** True when all matched rules were already injected in a previous tool call */\n\talreadyLoaded?: boolean;\n}\n\nexport interface InjectedPayload {\n\ttype: \"injected\";\n\truleNames: string[];\n\tsystemPromptLength: number;\n}\n\nexport interface ReloadedPayload {\n\ttype: \"reloaded\";\n\trules: RuleDetail[];\n\tloadedAt: number;\n}\n\nexport interface UnloadedPayload {\n\ttype: \"unloaded\";\n\treason: string;\n}\n\nexport type RulesChannelEvent = SnapshotPayload | MatchedPayload | InjectedPayload | ReloadedPayload | UnloadedPayload;\n\nexport const RULES_CHANNEL_NAME = \"rules-engine\";\n\nexport interface RulesChannelContract {\n\tmethods: {\n\t\tgetSnapshot: {\n\t\t\tparams: { cwd?: string };\n\t\t\treturn: SnapshotPayload;\n\t\t};\n\t};\n\tevents: {\n\t\tsnapshot: SnapshotPayload;\n\t\tmatched: MatchedPayload;\n\t\tinjected: InjectedPayload;\n\t\treloaded: ReloadedPayload;\n\t\tunloaded: UnloadedPayload;\n\t};\n}\n"]}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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","sourcesContent":["export type RuleSeverity = \"critical\" | \"high\" | \"medium\" | \"low\" | \"hint\";\n\nexport type RuleScope = \"user\" | \"pi\" | \"project\" | \"managed\";\n\nexport interface RuleFrontmatter {\n\tglobs?: string[];\n\tpaths?: string[];\n\tdescription?: string;\n\tseverity?: RuleSeverity;\n\tallowedTools?: string[];\n\twhenToUse?: string;\n\tversion?: string;\n\tmodel?: string;\n\tskills?: string;\n\teffort?: string;\n\tuserInvocable?: string;\n\tcontext?: \"inline\" | \"fork\";\n\tagent?: string;\n\tshell?: string;\n\tnotifyOnMatch?: boolean;\n\tskipInPrompt?: boolean;\n}\n\nexport interface ParsedRule {\n\tname: string;\n\tfilePath: string;\n\ttitle: string;\n\tcontent: string;\n\tscope: RuleScope;\n\tsource: string;\n\tfrontmatter: RuleFrontmatter;\n\tisUnconditional: boolean;\n}\n\nexport interface RuleCache {\n\trules: ParsedRule[];\n\tunconditional: ParsedRule[];\n\tconditional: ParsedRule[];\n\tloadedAt: number;\n}\n\nexport interface CachedRules {\n\trules: ParsedRule[];\n\tloadedAt: number;\n}\n\nexport interface RulesConfig {\n\tcacheTTL: number;\n\tnotifyOnLoad: boolean;\n\tnotifyOnMatch: boolean;\n\tdirs?: {\n\t\tuser?: string[];\n\t\tpi?: string[];\n\t\tproject?: string[];\n\t\tmanaged?: string[];\n\t};\n}\n\nexport interface RuleDetail {\n\tname: string;\n\ttitle: string;\n\tfilePath: string;\n\tscope: RuleScope;\n\tsource: string;\n\tseverity: RuleSeverity;\n\tisUnconditional: boolean;\n\tglobs: string[];\n\tdescription?: string;\n}\n\nexport interface ScannedDir {\n\tdir: string;\n\tfileCount: number;\n\truleNames: string[];\n}\n\nexport type RuleMatchStatus = \"loaded\" | \"already_loaded\" | \"reloaded\";\n\nexport interface MatchedRuleDetail {\n\tname: string;\n\ttitle: string;\n\tseverity: RuleSeverity;\n\tmatchedGlob: string;\n\t/**\n\t * Match status:\n\t * - \"loaded\": first time injected for this file\n\t * - \"already_loaded\": previously injected and still in context (skipped)\n\t * - \"reloaded\": previously injected but was invalidated (context removed), now re-injected\n\t */\n\tstatus?: RuleMatchStatus;\n\t/** @deprecated Use status instead. True when this rule was already injected for the same file. */\n\talreadyLoaded?: boolean;\n}\n\nexport interface MatchRecord {\n\tfilePath: string;\n\truleNames: string[];\n\ttoolName: string;\n\ttoolCallId: string;\n\tseverity: \"info\" | \"warning\";\n\ttimestamp: number;\n\tmatchedRuleDetails?: MatchedRuleDetail[];\n}\n\nexport interface LifecycleEntry {\n\tevent: \"loaded\" | \"restored\" | \"injected\" | \"reloaded\" | \"unloaded\" | \"expired\";\n\tmessage: string;\n\truleCount?: number;\n\ttimestamp: number;\n\tdetails?: {\n\t\tscannedDirs?: ScannedDir[];\n\t\tconfigSource?: string;\n\t\tcacheHit?: boolean;\n\t\tinjectedRules?: Array<{ name: string; promptDelta: number }>;\n\t};\n}\n\nexport interface SnapshotPayload {\n\ttype: \"snapshot\";\n\trules: RuleDetail[];\n\tinjectedRuleNames: string[];\n\ttotalRules: number;\n\tunconditionalCount: number;\n\tconditionalCount: number;\n\tmatchHistory: MatchRecord[];\n\tlifecycleLog: LifecycleEntry[];\n\tloadedAt: number;\n\tcacheTTL: number;\n}\n\nexport interface MatchedPayload {\n\ttype: \"matched\";\n\tfilePath: string;\n\tmatchedRules: MatchedRuleDetail[];\n\ttoolName: string;\n\ttoolCallId: string;\n\tseverity: \"info\" | \"warning\";\n\ttimestamp: number;\n\t/** Overall match status when all rules share the same state */\n\tstatus?: RuleMatchStatus;\n\t/** @deprecated Use status instead */\n\talreadyLoaded?: boolean;\n}\n\nexport interface InjectedPayload {\n\ttype: \"injected\";\n\truleNames: string[];\n\tsystemPromptLength: number;\n}\n\nexport interface ReloadedPayload {\n\ttype: \"reloaded\";\n\trules: RuleDetail[];\n\tloadedAt: number;\n}\n\nexport interface UnloadedPayload {\n\ttype: \"unloaded\";\n\treason: string;\n}\n\nexport type RulesChannelEvent = SnapshotPayload | MatchedPayload | InjectedPayload | ReloadedPayload | UnloadedPayload;\n\nexport const RULES_CHANNEL_NAME = \"rules-engine\";\n\nexport interface RulesChannelContract {\n\tmethods: {\n\t\tgetSnapshot: {\n\t\t\tparams: { cwd?: string };\n\t\t\treturn: SnapshotPayload;\n\t\t};\n\t};\n\tevents: {\n\t\tsnapshot: SnapshotPayload;\n\t\tmatched: MatchedPayload;\n\t\tinjected: InjectedPayload;\n\t\treloaded: ReloadedPayload;\n\t\tunloaded: UnloadedPayload;\n\t};\n}\n"]}

package/dist/extensions/rules-engine/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAwJA,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC","sourcesContent":["export type RuleSeverity = \"critical\" | \"high\" | \"medium\" | \"low\" | \"hint\";\n\nexport type RuleScope = \"user\" | \"pi\" | \"project\" | \"managed\";\n\nexport interface RuleFrontmatter {\n\tglobs?: string[];\n\tpaths?: string[];\n\tdescription?: string;\n\tseverity?: RuleSeverity;\n\tallowedTools?: string[];\n\twhenToUse?: string;\n\tversion?: string;\n\tmodel?: string;\n\tskills?: string;\n\teffort?: string;\n\tuserInvocable?: string;\n\tcontext?: \"inline\" | \"fork\";\n\tagent?: string;\n\tshell?: string;\n\tnotifyOnMatch?: boolean;\n\tskipInPrompt?: boolean;\n}\n\nexport interface ParsedRule {\n\tname: string;\n\tfilePath: string;\n\ttitle: string;\n\tcontent: string;\n\tscope: RuleScope;\n\tsource: string;\n\tfrontmatter: RuleFrontmatter;\n\tisUnconditional: boolean;\n}\n\nexport interface RuleCache {\n\trules: ParsedRule[];\n\tunconditional: ParsedRule[];\n\tconditional: ParsedRule[];\n\tloadedAt: number;\n}\n\nexport interface CachedRules {\n\trules: ParsedRule[];\n\tloadedAt: number;\n}\n\nexport interface RulesConfig {\n\tcacheTTL: number;\n\tnotifyOnLoad: boolean;\n\tnotifyOnMatch: boolean;\n\tdirs?: {\n\t\tuser?: string[];\n\t\tpi?: string[];\n\t\tproject?: string[];\n\t\tmanaged?: string[];\n\t};\n}\n\nexport interface RuleDetail {\n\tname: string;\n\ttitle: string;\n\tfilePath: string;\n\tscope: RuleScope;\n\tsource: string;\n\tseverity: RuleSeverity;\n\tisUnconditional: boolean;\n\tglobs: string[];\n\tdescription?: string;\n}\n\nexport interface ScannedDir {\n\tdir: string;\n\tfileCount: number;\n\truleNames: string[];\n}\n\nexport interface MatchedRuleDetail {\n\tname: string;\n\ttitle: string;\n\tseverity: RuleSeverity;\n\tmatchedGlob: string;\n\t/** True when this rule was already injected for the same file in a previous tool call */\n\talreadyLoaded?: boolean;\n}\n\nexport interface MatchRecord {\n\tfilePath: string;\n\truleNames: string[];\n\ttoolName: string;\n\ttoolCallId: string;\n\tseverity: \"info\" | \"warning\";\n\ttimestamp: number;\n\tmatchedRuleDetails?: MatchedRuleDetail[];\n}\n\nexport interface LifecycleEntry {\n\tevent: \"loaded\" | \"restored\" | \"injected\" | \"reloaded\" | \"unloaded\" | \"expired\";\n\tmessage: string;\n\truleCount?: number;\n\ttimestamp: number;\n\tdetails?: {\n\t\tscannedDirs?: ScannedDir[];\n\t\tconfigSource?: string;\n\t\tcacheHit?: boolean;\n\t\tinjectedRules?: Array<{ name: string; promptDelta: number }>;\n\t};\n}\n\nexport interface SnapshotPayload {\n\ttype: \"snapshot\";\n\trules: RuleDetail[];\n\tinjectedRuleNames: string[];\n\ttotalRules: number;\n\tunconditionalCount: number;\n\tconditionalCount: number;\n\tmatchHistory: MatchRecord[];\n\tlifecycleLog: LifecycleEntry[];\n\tloadedAt: number;\n\tcacheTTL: number;\n}\n\nexport interface MatchedPayload {\n\ttype: \"matched\";\n\tfilePath: string;\n\tmatchedRules: MatchedRuleDetail[];\n\ttoolName: string;\n\ttoolCallId: string;\n\tseverity: \"info\" | \"warning\";\n\ttimestamp: number;\n\t/** True when all matched rules were already injected in a previous tool call */\n\talreadyLoaded?: boolean;\n}\n\nexport interface InjectedPayload {\n\ttype: \"injected\";\n\truleNames: string[];\n\tsystemPromptLength: number;\n}\n\nexport interface ReloadedPayload {\n\ttype: \"reloaded\";\n\trules: RuleDetail[];\n\tloadedAt: number;\n}\n\nexport interface UnloadedPayload {\n\ttype: \"unloaded\";\n\treason: string;\n}\n\nexport type RulesChannelEvent = SnapshotPayload | MatchedPayload | InjectedPayload | ReloadedPayload | UnloadedPayload;\n\nexport const RULES_CHANNEL_NAME = \"rules-engine\";\n\nexport interface RulesChannelContract {\n\tmethods: {\n\t\tgetSnapshot: {\n\t\t\tparams: { cwd?: string };\n\t\t\treturn: SnapshotPayload;\n\t\t};\n\t};\n\tevents: {\n\t\tsnapshot: SnapshotPayload;\n\t\tmatched: MatchedPayload;\n\t\tinjected: InjectedPayload;\n\t\treloaded: ReloadedPayload;\n\t\tunloaded: UnloadedPayload;\n\t};\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAmKA,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC","sourcesContent":["export type RuleSeverity = \"critical\" | \"high\" | \"medium\" | \"low\" | \"hint\";\n\nexport type RuleScope = \"user\" | \"pi\" | \"project\" | \"managed\";\n\nexport interface RuleFrontmatter {\n\tglobs?: string[];\n\tpaths?: string[];\n\tdescription?: string;\n\tseverity?: RuleSeverity;\n\tallowedTools?: string[];\n\twhenToUse?: string;\n\tversion?: string;\n\tmodel?: string;\n\tskills?: string;\n\teffort?: string;\n\tuserInvocable?: string;\n\tcontext?: \"inline\" | \"fork\";\n\tagent?: string;\n\tshell?: string;\n\tnotifyOnMatch?: boolean;\n\tskipInPrompt?: boolean;\n}\n\nexport interface ParsedRule {\n\tname: string;\n\tfilePath: string;\n\ttitle: string;\n\tcontent: string;\n\tscope: RuleScope;\n\tsource: string;\n\tfrontmatter: RuleFrontmatter;\n\tisUnconditional: boolean;\n}\n\nexport interface RuleCache {\n\trules: ParsedRule[];\n\tunconditional: ParsedRule[];\n\tconditional: ParsedRule[];\n\tloadedAt: number;\n}\n\nexport interface CachedRules {\n\trules: ParsedRule[];\n\tloadedAt: number;\n}\n\nexport interface RulesConfig {\n\tcacheTTL: number;\n\tnotifyOnLoad: boolean;\n\tnotifyOnMatch: boolean;\n\tdirs?: {\n\t\tuser?: string[];\n\t\tpi?: string[];\n\t\tproject?: string[];\n\t\tmanaged?: string[];\n\t};\n}\n\nexport interface RuleDetail {\n\tname: string;\n\ttitle: string;\n\tfilePath: string;\n\tscope: RuleScope;\n\tsource: string;\n\tseverity: RuleSeverity;\n\tisUnconditional: boolean;\n\tglobs: string[];\n\tdescription?: string;\n}\n\nexport interface ScannedDir {\n\tdir: string;\n\tfileCount: number;\n\truleNames: string[];\n}\n\nexport type RuleMatchStatus = \"loaded\" | \"already_loaded\" | \"reloaded\";\n\nexport interface MatchedRuleDetail {\n\tname: string;\n\ttitle: string;\n\tseverity: RuleSeverity;\n\tmatchedGlob: string;\n\t/**\n\t * Match status:\n\t * - \"loaded\": first time injected for this file\n\t * - \"already_loaded\": previously injected and still in context (skipped)\n\t * - \"reloaded\": previously injected but was invalidated (context removed), now re-injected\n\t */\n\tstatus?: RuleMatchStatus;\n\t/** @deprecated Use status instead. True when this rule was already injected for the same file. */\n\talreadyLoaded?: boolean;\n}\n\nexport interface MatchRecord {\n\tfilePath: string;\n\truleNames: string[];\n\ttoolName: string;\n\ttoolCallId: string;\n\tseverity: \"info\" | \"warning\";\n\ttimestamp: number;\n\tmatchedRuleDetails?: MatchedRuleDetail[];\n}\n\nexport interface LifecycleEntry {\n\tevent: \"loaded\" | \"restored\" | \"injected\" | \"reloaded\" | \"unloaded\" | \"expired\";\n\tmessage: string;\n\truleCount?: number;\n\ttimestamp: number;\n\tdetails?: {\n\t\tscannedDirs?: ScannedDir[];\n\t\tconfigSource?: string;\n\t\tcacheHit?: boolean;\n\t\tinjectedRules?: Array<{ name: string; promptDelta: number }>;\n\t};\n}\n\nexport interface SnapshotPayload {\n\ttype: \"snapshot\";\n\trules: RuleDetail[];\n\tinjectedRuleNames: string[];\n\ttotalRules: number;\n\tunconditionalCount: number;\n\tconditionalCount: number;\n\tmatchHistory: MatchRecord[];\n\tlifecycleLog: LifecycleEntry[];\n\tloadedAt: number;\n\tcacheTTL: number;\n}\n\nexport interface MatchedPayload {\n\ttype: \"matched\";\n\tfilePath: string;\n\tmatchedRules: MatchedRuleDetail[];\n\ttoolName: string;\n\ttoolCallId: string;\n\tseverity: \"info\" | \"warning\";\n\ttimestamp: number;\n\t/** Overall match status when all rules share the same state */\n\tstatus?: RuleMatchStatus;\n\t/** @deprecated Use status instead */\n\talreadyLoaded?: boolean;\n}\n\nexport interface InjectedPayload {\n\ttype: \"injected\";\n\truleNames: string[];\n\tsystemPromptLength: number;\n}\n\nexport interface ReloadedPayload {\n\ttype: \"reloaded\";\n\trules: RuleDetail[];\n\tloadedAt: number;\n}\n\nexport interface UnloadedPayload {\n\ttype: \"unloaded\";\n\treason: string;\n}\n\nexport type RulesChannelEvent = SnapshotPayload | MatchedPayload | InjectedPayload | ReloadedPayload | UnloadedPayload;\n\nexport const RULES_CHANNEL_NAME = \"rules-engine\";\n\nexport interface RulesChannelContract {\n\tmethods: {\n\t\tgetSnapshot: {\n\t\t\tparams: { cwd?: string };\n\t\t\treturn: SnapshotPayload;\n\t\t};\n\t};\n\tevents: {\n\t\tsnapshot: SnapshotPayload;\n\t\tmatched: MatchedPayload;\n\t\tinjected: InjectedPayload;\n\t\treloaded: ReloadedPayload;\n\t\tunloaded: UnloadedPayload;\n\t};\n}\n"]}

package/dist/extensions/rules-engine/types.ts

@@ -74,12 +74,21 @@ export interface ScannedDir {
 	ruleNames: string[];
 }
 
+export type RuleMatchStatus = "loaded" | "already_loaded" | "reloaded";
+
 export interface MatchedRuleDetail {
 	name: string;
 	title: string;
 	severity: RuleSeverity;
 	matchedGlob: string;
-	/** True when this rule was already injected for the same file in a previous tool call */
+	/**
+	 * Match status:
+	 * - "loaded": first time injected for this file
+	 * - "already_loaded": previously injected and still in context (skipped)
+	 * - "reloaded": previously injected but was invalidated (context removed), now re-injected
+	 */
+	status?: RuleMatchStatus;
+	/** @deprecated Use status instead. True when this rule was already injected for the same file. */
 	alreadyLoaded?: boolean;
 }
 
@@ -127,7 +136,9 @@ export interface MatchedPayload {
 	toolCallId: string;
 	severity: "info" | "warning";
 	timestamp: number;
-	/** True when all matched rules were already injected in a previous tool call */
+	/** Overall match status when all rules share the same state */
+	status?: RuleMatchStatus;
+	/** @deprecated Use status instead */
 	alreadyLoaded?: boolean;
 }
 

package/dist/extensions/session-supervisor/config.ts

@@ -15,7 +15,9 @@ const DEFAULT_CONFIG: SupervisorConfig = {
     maxContinueCount: 5,
     defaultDelayMs: 30_000,
     pauseThresholdMs: 300_000,
-    guards: [],
+    guards: [
+        { name: "incomplete-keywords", type: "keyword", enable: true, keywords: ["TODO", "FIXME", "WIP", "HACK"] },
+    ],
 };
 
 export function loadConfig(sessionDataDir: string, projectDataDir: string): SupervisorConfig {

package/dist/extensions/session-supervisor/index.ts

@@ -36,6 +36,10 @@ function log(msg: string) {
     appendFileSync(LOG_FILE, line);
 }
 
+const DEFAULT_GUARDS: GuardConfig[] = [
+    { name: "incomplete-keywords", type: "keyword", enable: true, keywords: ["TODO", "FIXME", "WIP", "HACK"] },
+];
+
 export default function sessionSupervisorExtension(pi: ExtensionAPI) {
     let config: SupervisorConfig;
     let enabled = false;
@@ -72,8 +76,8 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
     const { server: channel } =
         createTypedChannel<SupervisorChannelContract>(rawChannel);
 
-    channel.handle("supervisor.getStatus", async () => getStatus());
-    channel.handle("supervisor.requestPause", async (params) => {
+    channel.handle("getStatus", async () => getStatus());
+    channel.handle("requestPause", async (params) => {
         const delayMs = params.delayMs ?? config.defaultDelayMs;
         const result = schedulerInstance.scheduleContinue(
             "manual-pause",
@@ -90,7 +94,7 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
         return result;
     });
 
-    channel.handle("supervisor.cancelPause", async () => {
+    channel.handle("cancelPause", async () => {
         const cancelled = schedulerInstance.cancelTimer("manual-pause");
         if (cancelled) {
             channel.emit("supervisor.pauseCancelled", { reason: "Cancelled via channel" });
@@ -98,7 +102,7 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
         return { cancelled };
     });
 
-    channel.handle("supervisor.forceContinue", async (params) => {
+    channel.handle("forceContinue", async (params) => {
         schedulerInstance.cancelAll();
         currentState = "continuing";
         emitStatusChanged();
@@ -106,7 +110,7 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
         return { triggered: true };
     });
 
-    channel.handle("supervisor.disable", async () => {
+    channel.handle("disable", async () => {
         enabled = false;
         schedulerInstance.cancelAll();
         currentState = "disabled";
@@ -114,16 +118,16 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
         return { disabled: true };
     });
 
-    channel.handle("supervisor.enable", async () => {
+    channel.handle("enable", async () => {
         enabled = true;
         currentState = "idle";
         emitStatusChanged();
         return { enabled: true };
     });
 
-    channel.handle("supervisor.getTaskReport", async () => ({ tasks: lastTaskReports }));
+    channel.handle("getTaskReport", async () => ({ tasks: lastTaskReports }));
 
-    channel.handle("supervisor.checkToolStatus", async (params) => {
+    channel.handle("checkToolStatus", async (params) => {
         const targetChannelName = params.channelName ?? params.toolName;
         try {
             const result = await rawChannel.call(
@@ -222,8 +226,8 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
             config.smallModel = modelFlag;
         }
 
-        // Determine project root for specs file resolution
-        projectRoot = ctx.projectDataDir ?? process.cwd();
+        // projectRoot is the git root (worktree-aware), correct for specs file resolution
+        projectRoot = ctx.projectRoot ?? ctx.cwd;
 
         schedulerInstance = new Scheduler(
             config.maxContinueCount,
@@ -276,7 +280,29 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
                 log(`guard[${guard.name}] completed=${result.completed}, remaining=${result.remainingItems.length}`);
             }
 
-            // Also run the generic model-based check as fallback (if no custom guards or as additional check)
+            lastTaskReports = reports;
+            channel.emit("supervisor.taskReport", { tasks: reports });
+
+            // Phase 2: If any guard says incomplete → continue immediately
+            const hasIncompleteGuards = guardResults.some((r) => !r.completed && r.remainingItems.length > 0);
+
+            if (hasIncompleteGuards) {
+                log(`Guards detected incomplete tasks`);
+                specsIterationCount++;
+
+                const continueMessage = generateContinueMessage(
+                    activeGuards,
+                    guardResults,
+                    null,
+                );
+
+                lastCheckResult = { completed: false, confidence: 0.9, incompleteTasks: [], guardResults };
+
+                scheduleContinue(continueMessage);
+                return;
+            }
+
+            // Phase 3: All guards passed → run fallback model check
             const modelCheck = await checkWithSmallModel(
                 event.messages as Array<{ role: string; content: unknown }>,
                 config,
@@ -284,14 +310,9 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
                 ctx.sessionSignal,
             );
 
-            lastTaskReports = reports;
-            channel.emit("supervisor.taskReport", { tasks: reports });
-
-            // Phase 2: Determine if we should continue
-            const hasIncompleteGuards = guardResults.some((r) => !r.completed && r.remainingItems.length > 0);
             const hasModelIncomplete = modelCheck.completed === false || modelCheck.incompleteTasks.length > 0;
 
-            if (!hasIncompleteGuards && !hasModelIncomplete) {
+            if (!hasModelIncomplete) {
                 log(`All guards passed + model check passed → idle`);
                 currentState = "idle";
                 lastCheckResult = { ...modelCheck, guardResults };
@@ -299,10 +320,8 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
                 return;
             }
 
-            // Phase 3: Generate continue message from first incomplete guard
-            log(`Incomplete tasks detected, scheduling continue...`);
-            specsIterationCount++;
-
+            // Phase 4: Model detected incompleteness → continue with model's assessment
+            log(`Model detected incomplete tasks`);
             const continueMessage = generateContinueMessage(
                 activeGuards,
                 guardResults,
@@ -310,41 +329,7 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
             );
 
             lastCheckResult = { ...modelCheck, guardResults };
-
-            // Phase 4: Schedule continue
-            const delayMs = config.defaultDelayMs;
-
-            if (schedulerInstance.shouldPause(delayMs)) {
-                currentState = "paused";
-                emitStatusChanged();
-                channel.emit("supervisor.pauseRequested", {
-                    delayMs,
-                    reason: continueMessage.slice(0, 200),
-                });
-            }
-
-            pi.background(async (signal) => {
-                await new Promise<void>((resolve) => {
-                    const timer = setTimeout(resolve, delayMs);
-                    signal.addEventListener("abort", () => {
-                        clearTimeout(timer);
-                        resolve();
-                    });
-                });
-
-                if (signal.aborted) return;
-
-                currentState = "continuing";
-                emitStatusChanged();
-                pi.sendMessage(
-                    {
-                        customType: "supervisor_continue",
-                        content: continueMessage,
-                        display: true,
-                    },
-                    { triggerTurn: true },
-                );
-            });
+            scheduleContinue(continueMessage);
         } catch (err) {
             log(`agent_end error: ${err instanceof Error ? err.message : String(err)}`);
             currentState = "idle";
@@ -359,8 +344,46 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
 
     // ── Guard Check Functions ──
 
+    function scheduleContinue(continueMessage: string): void {
+        const delayMs = config.defaultDelayMs;
+
+        if (schedulerInstance.shouldPause(delayMs)) {
+            currentState = "paused";
+            emitStatusChanged();
+            channel.emit("supervisor.pauseRequested", {
+                delayMs,
+                reason: continueMessage.slice(0, 200),
+            });
+        }
+
+        pi.background(async (signal) => {
+            await new Promise<void>((resolve) => {
+                const timer = setTimeout(resolve, delayMs);
+                signal.addEventListener("abort", () => {
+                    clearTimeout(timer);
+                    resolve();
+                });
+            });
+
+            if (signal.aborted) return;
+
+            currentState = "continuing";
+            emitStatusChanged();
+            pi.sendMessage(
+                {
+                    customType: "supervisor_continue",
+                    content: continueMessage,
+                    display: true,
+                },
+                { triggerTurn: true },
+            );
+        });
+    }
+
     function getActiveGuards(): GuardConfig[] {
-        return (config.guards ?? []).filter((g) => g.enable !== false);
+        const guards = config.guards ?? [];
+        const source = guards.length > 0 ? guards : DEFAULT_GUARDS;
+        return source.filter((g) => g.enable !== false);
     }
 
     async function runGuardCheck(
@@ -599,7 +622,7 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
     function generateContinueMessage(
         guards: GuardConfig[],
         results: GuardCheckResult[],
-        modelCheck: CheckResult,
+        modelCheck: CheckResult | null,
     ): string {
         // Priority: first incomplete guard generates the message
         for (let i = 0; i < guards.length; i++) {
@@ -640,11 +663,15 @@ export default function sessionSupervisorExtension(pi: ExtensionAPI) {
         }
 
         // Fallback: generic continue from model check
-        const tasks = modelCheck.incompleteTasks.map((t) => `[${t.severity}] ${t.description}`);
-        return CONTINUE_PROMPT(
-            modelCheck.modelResponse ?? "Model detected incomplete tasks",
-            tasks.length > 0 ? tasks : ["Continue working"],
-        );
+        if (modelCheck) {
+            const tasks = modelCheck.incompleteTasks.map((t) => `[${t.severity}] ${t.description}`);
+            return CONTINUE_PROMPT(
+                modelCheck.modelResponse ?? "Model detected incomplete tasks",
+                tasks.length > 0 ? tasks : ["Continue working"],
+            );
+        }
+
+        return CONTINUE_PROMPT("Incomplete tasks detected", ["Please continue working on remaining items."]);
     }
 
     function generateBlockMessage(