@dyyz1993/pi-coding-agent 0.74.23 → 0.74.25

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

@@ -0,0 +1,156 @@
+export type RuleSeverity = "critical" | "high" | "medium" | "low" | "hint";
+export type RuleScope = "user" | "pi" | "project" | "managed";
+export interface RuleFrontmatter {
+    globs?: string[];
+    paths?: string[];
+    description?: string;
+    severity?: RuleSeverity;
+    allowedTools?: string[];
+    whenToUse?: string;
+    version?: string;
+    model?: string;
+    skills?: string;
+    effort?: string;
+    userInvocable?: string;
+    context?: "inline" | "fork";
+    agent?: string;
+    shell?: string;
+    notifyOnMatch?: boolean;
+    skipInPrompt?: boolean;
+}
+export interface ParsedRule {
+    name: string;
+    filePath: string;
+    title: string;
+    content: string;
+    scope: RuleScope;
+    source: string;
+    frontmatter: RuleFrontmatter;
+    isUnconditional: boolean;
+}
+export interface RuleCache {
+    rules: ParsedRule[];
+    unconditional: ParsedRule[];
+    conditional: ParsedRule[];
+    loadedAt: number;
+}
+export interface CachedRules {
+    rules: ParsedRule[];
+    loadedAt: number;
+}
+export interface RulesConfig {
+    cacheTTL: number;
+    notifyOnLoad: boolean;
+    notifyOnMatch: boolean;
+    dirs?: {
+        user?: string[];
+        pi?: string[];
+        project?: string[];
+        managed?: string[];
+    };
+}
+export interface RuleDetail {
+    name: string;
+    title: string;
+    filePath: string;
+    scope: RuleScope;
+    source: string;
+    severity: RuleSeverity;
+    isUnconditional: boolean;
+    globs: string[];
+    description?: string;
+}
+export interface ScannedDir {
+    dir: string;
+    fileCount: number;
+    ruleNames: string[];
+}
+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 */
+    alreadyLoaded?: boolean;
+}
+export interface MatchRecord {
+    filePath: string;
+    ruleNames: string[];
+    toolName: string;
+    toolCallId: string;
+    severity: "info" | "warning";
+    timestamp: number;
+    matchedRuleDetails?: MatchedRuleDetail[];
+}
+export interface LifecycleEntry {
+    event: "loaded" | "restored" | "injected" | "reloaded" | "unloaded" | "expired";
+    message: string;
+    ruleCount?: number;
+    timestamp: number;
+    details?: {
+        scannedDirs?: ScannedDir[];
+        configSource?: string;
+        cacheHit?: boolean;
+        injectedRules?: Array<{
+            name: string;
+            promptDelta: number;
+        }>;
+    };
+}
+export interface SnapshotPayload {
+    type: "snapshot";
+    rules: RuleDetail[];
+    injectedRuleNames: string[];
+    totalRules: number;
+    unconditionalCount: number;
+    conditionalCount: number;
+    matchHistory: MatchRecord[];
+    lifecycleLog: LifecycleEntry[];
+    loadedAt: number;
+    cacheTTL: number;
+}
+export interface MatchedPayload {
+    type: "matched";
+    filePath: string;
+    matchedRules: MatchedRuleDetail[];
+    toolName: string;
+    toolCallId: string;
+    severity: "info" | "warning";
+    timestamp: number;
+    /** True when all matched rules were already injected in a previous tool call */
+    alreadyLoaded?: boolean;
+}
+export interface InjectedPayload {
+    type: "injected";
+    ruleNames: string[];
+    systemPromptLength: number;
+}
+export interface ReloadedPayload {
+    type: "reloaded";
+    rules: RuleDetail[];
+    loadedAt: number;
+}
+export interface UnloadedPayload {
+    type: "unloaded";
+    reason: string;
+}
+export type RulesChannelEvent = SnapshotPayload | MatchedPayload | InjectedPayload | ReloadedPayload | UnloadedPayload;
+export declare const RULES_CHANNEL_NAME = "rules-engine";
+export interface RulesChannelContract {
+    methods: {
+        getSnapshot: {
+            params: {
+                cwd?: string;
+            };
+            return: SnapshotPayload;
+        };
+    };
+    events: {
+        snapshot: SnapshotPayload;
+        matched: MatchedPayload;
+        injected: InjectedPayload;
+        reloaded: ReloadedPayload;
+        unloaded: UnloadedPayload;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,2 @@
+export const RULES_CHANNEL_NAME = "rules-engine";
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,169 @@
+export type RuleSeverity = "critical" | "high" | "medium" | "low" | "hint";
+
+export type RuleScope = "user" | "pi" | "project" | "managed";
+
+export interface RuleFrontmatter {
+	globs?: string[];
+	paths?: string[];
+	description?: string;
+	severity?: RuleSeverity;
+	allowedTools?: string[];
+	whenToUse?: string;
+	version?: string;
+	model?: string;
+	skills?: string;
+	effort?: string;
+	userInvocable?: string;
+	context?: "inline" | "fork";
+	agent?: string;
+	shell?: string;
+	notifyOnMatch?: boolean;
+	skipInPrompt?: boolean;
+}
+
+export interface ParsedRule {
+	name: string;
+	filePath: string;
+	title: string;
+	content: string;
+	scope: RuleScope;
+	source: string;
+	frontmatter: RuleFrontmatter;
+	isUnconditional: boolean;
+}
+
+export interface RuleCache {
+	rules: ParsedRule[];
+	unconditional: ParsedRule[];
+	conditional: ParsedRule[];
+	loadedAt: number;
+}
+
+export interface CachedRules {
+	rules: ParsedRule[];
+	loadedAt: number;
+}
+
+export interface RulesConfig {
+	cacheTTL: number;
+	notifyOnLoad: boolean;
+	notifyOnMatch: boolean;
+	dirs?: {
+		user?: string[];
+		pi?: string[];
+		project?: string[];
+		managed?: string[];
+	};
+}
+
+export interface RuleDetail {
+	name: string;
+	title: string;
+	filePath: string;
+	scope: RuleScope;
+	source: string;
+	severity: RuleSeverity;
+	isUnconditional: boolean;
+	globs: string[];
+	description?: string;
+}
+
+export interface ScannedDir {
+	dir: string;
+	fileCount: number;
+	ruleNames: string[];
+}
+
+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 */
+	alreadyLoaded?: boolean;
+}
+
+export interface MatchRecord {
+	filePath: string;
+	ruleNames: string[];
+	toolName: string;
+	toolCallId: string;
+	severity: "info" | "warning";
+	timestamp: number;
+	matchedRuleDetails?: MatchedRuleDetail[];
+}
+
+export interface LifecycleEntry {
+	event: "loaded" | "restored" | "injected" | "reloaded" | "unloaded" | "expired";
+	message: string;
+	ruleCount?: number;
+	timestamp: number;
+	details?: {
+		scannedDirs?: ScannedDir[];
+		configSource?: string;
+		cacheHit?: boolean;
+		injectedRules?: Array<{ name: string; promptDelta: number }>;
+	};
+}
+
+export interface SnapshotPayload {
+	type: "snapshot";
+	rules: RuleDetail[];
+	injectedRuleNames: string[];
+	totalRules: number;
+	unconditionalCount: number;
+	conditionalCount: number;
+	matchHistory: MatchRecord[];
+	lifecycleLog: LifecycleEntry[];
+	loadedAt: number;
+	cacheTTL: number;
+}
+
+export interface MatchedPayload {
+	type: "matched";
+	filePath: string;
+	matchedRules: MatchedRuleDetail[];
+	toolName: string;
+	toolCallId: string;
+	severity: "info" | "warning";
+	timestamp: number;
+	/** True when all matched rules were already injected in a previous tool call */
+	alreadyLoaded?: boolean;
+}
+
+export interface InjectedPayload {
+	type: "injected";
+	ruleNames: string[];
+	systemPromptLength: number;
+}
+
+export interface ReloadedPayload {
+	type: "reloaded";
+	rules: RuleDetail[];
+	loadedAt: number;
+}
+
+export interface UnloadedPayload {
+	type: "unloaded";
+	reason: string;
+}
+
+export type RulesChannelEvent = SnapshotPayload | MatchedPayload | InjectedPayload | ReloadedPayload | UnloadedPayload;
+
+export const RULES_CHANNEL_NAME = "rules-engine";
+
+export interface RulesChannelContract {
+	methods: {
+		getSnapshot: {
+			params: { cwd?: string };
+			return: SnapshotPayload;
+		};
+	};
+	events: {
+		snapshot: SnapshotPayload;
+		matched: MatchedPayload;
+		injected: InjectedPayload;
+		reloaded: ReloadedPayload;
+		unloaded: UnloadedPayload;
+	};
+}

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

@@ -0,0 +1,116 @@
+import type { ExtensionAPI } from "@dyyz1993/pi-coding-agent";
+import type {
+    SupervisorConfig,
+    CheckResult,
+} from "./types.js";
+import { CompletionCheckSchema } from "./types.js";
+import { COMPLETION_CHECK_SYSTEM_PROMPT } from "./prompts.js";
+import type { TSchema } from "@sinclair/typebox";
+import { Value } from "typebox/value";
+
+export async function checkWithSmallModel(
+    messages: Array<{ role: string; content: unknown }>,
+    config: SupervisorConfig,
+    callLLM: ExtensionAPI["callLLM"],
+    signal?: AbortSignal,
+): Promise<CheckResult> {
+    const recentMessages = messages.slice(-10);
+    const conversationSummary = recentMessages
+        .map((m) => {
+            const content =
+                typeof m.content === "string"
+                    ? m.content
+                    : JSON.stringify(m.content);
+            return `[${m.role}]: ${content.slice(0, 500)}`;
+        })
+        .join("\n\n");
+
+    try {
+        const response = await callLLMStructured<{
+            completed: boolean;
+            confidence: number;
+            incompleteTasks: CheckResult["incompleteTasks"];
+            reasoning: string;
+        }>(
+            callLLM,
+            {
+                systemPrompt: COMPLETION_CHECK_SYSTEM_PROMPT,
+                messages: [{ role: "user" as const, content: conversationSummary }],
+                model: config.smallModel,
+                maxTokens: 1024,
+                signal,
+            },
+            CompletionCheckSchema,
+        );
+
+        return {
+            completed: response.completed,
+            confidence: response.confidence,
+            incompleteTasks: response.incompleteTasks,
+            modelResponse: response.reasoning,
+        };
+    } catch (err) {
+        return {
+            completed: true,
+            confidence: 0.5,
+            incompleteTasks: [],
+            modelResponse: `Check failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+
+async function callLLMStructured<T>(
+    callLLM: ExtensionAPI["callLLM"],
+    options: {
+        systemPrompt: string;
+        messages: Array<{ role: "user" | "assistant"; content: string }>;
+        model?: string;
+        maxTokens?: number;
+        signal?: AbortSignal;
+    },
+    schema: TSchema,
+): Promise<T> {
+    const schemaStr = JSON.stringify(schema, null, 2);
+    const systemWithSchema = `${options.systemPrompt}\n\nRespond with JSON matching this schema:\n${schemaStr}`;
+
+    const maxRetries = 3;
+    const messages = [...options.messages];
+
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const raw = await callLLM({
+            ...options,
+            systemPrompt: systemWithSchema,
+            messages,
+        });
+
+        try {
+            const jsonStr = raw
+                .replace(/^```(?:json)?\s*\n?/m, "")
+                .replace(/\n?```\s*$/m, "")
+                .trim();
+            const parsed = JSON.parse(jsonStr);
+            const coerced = Value.Convert(schema, parsed);
+
+            if (Value.Check(schema, coerced)) {
+                return coerced as T;
+            }
+
+            const errors = [...Value.Errors(schema, coerced)]
+                .map((e) => `${String(e)}: ${e.message}`)
+                .join("; ");
+            messages.push({ role: "assistant", content: raw });
+            messages.push({
+                role: "user",
+                content: `JSON schema validation failed: ${errors}. Please fix and return valid JSON.`,
+            });
+        } catch (parseErr) {
+            messages.push({ role: "assistant", content: raw });
+            messages.push({
+                role: "user",
+                content: `Failed to parse JSON: ${parseErr instanceof Error ? parseErr.message : String(parseErr)}. Please return valid JSON only.`,
+            });
+        }
+    }
+
+    throw new Error("Failed to get structured response after max retries");
+}

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

@@ -0,0 +1,45 @@
+import { existsSync, readFileSync, appendFileSync } from "node:fs";
+import { join } from "node:path";
+import { Value } from "typebox/value";
+import { SupervisorConfigSchema, type SupervisorConfig } from "./types.js";
+
+function log(msg: string) {
+    const ts = new Date().toISOString();
+    appendFileSync("/tmp/supervisor-debug.log", `[${ts}] [config] ${msg}\n`);
+}
+
+const DEFAULT_CONFIG: SupervisorConfig = {
+    enable: false,
+    checkOnAgentEnd: true,
+    smallModel: "fast",
+    maxContinueCount: 5,
+    defaultDelayMs: 30_000,
+    pauseThresholdMs: 300_000,
+    guards: [],
+};
+
+export function loadConfig(sessionDataDir: string, projectDataDir: string): SupervisorConfig {
+    const candidates = [
+        join(sessionDataDir, "supervisor.json"),
+        join(projectDataDir, "supervisor.json"),
+    ];
+
+    for (const p of candidates) {
+        if (!existsSync(p)) continue;
+        try {
+            const raw = readFileSync(p, "utf-8");
+            log(`Found config at ${p}, raw length=${raw.length}`);
+            const parsed = JSON.parse(raw);
+            log(`Parsed guards count: ${parsed.guards?.length ?? "undefined"}`);
+            const converted = Value.Convert(SupervisorConfigSchema, parsed) as Record<string, unknown>;
+            log(`After Value.Convert guards count: ${Array.isArray(converted.guards) ? converted.guards.length : "undefined"}`);
+            const merged = { ...DEFAULT_CONFIG, ...converted } as SupervisorConfig;
+            log(`After merge guards count: ${merged.guards?.length ?? "undefined"}`);
+            return merged;
+        } catch (err) {
+            log(`Config parse error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    log(`No config file found, using defaults`);
+    return { ...DEFAULT_CONFIG };
+}