@code-yeongyu/senpi 2026.6.15 → 2026.6.16

package/dist/core/extensions/builtin/rules/index.js

@@ -0,0 +1,127 @@
+import { readFileSync, realpathSync } from "node:fs";
+import { isAbsolute, relative } from "node:path";
+import { registerSlashCommands } from "./commands.js";
+import { createEngine, defaultConfig } from "./rules/engine.js";
+import { findRuleCandidates } from "./rules/finder.js";
+import { findProjectRoot } from "./rules/project-root.js";
+import { extractToolPaths } from "./rules/tool-paths.js";
+const MODE_VALUES = new Set(["static", "dynamic", "both", "off"]);
+export default function piRulesExtension(pi) {
+    pi.registerFlag("pi-rules-disabled", {
+        type: "boolean",
+        default: false,
+        description: "Disable pi-rules hooks.",
+    });
+    pi.registerFlag("pi-rules-mode", {
+        type: "string",
+        default: "both",
+        description: "Rule injection mode: static, dynamic, both, or off.",
+    });
+    const config = defaultConfig();
+    const engine = createEngine(config, {
+        findCandidates: findRuleCandidates,
+        readFile: (path) => {
+            try {
+                return readFileSync(path, "utf-8");
+            }
+            catch {
+                return null;
+            }
+        },
+        findProjectRoot,
+        extractToolPaths,
+    });
+    registerSlashCommands(pi, engine);
+    function syncConfigFromFlags() {
+        const disabled = pi.getFlag("pi-rules-disabled");
+        const mode = pi.getFlag("pi-rules-mode");
+        if (typeof disabled === "boolean") {
+            engine.config.disabled = disabled;
+        }
+        if (typeof mode === "string" && isPiRulesMode(mode)) {
+            engine.config.mode = mode;
+        }
+    }
+    pi.on("session_start", async (event, ctx) => {
+        syncConfigFromFlags();
+        if (engine.config.disabled) {
+            return undefined;
+        }
+        engine.resetSession(ctx.cwd);
+        pi.appendEntry("pi-rules.scan", { cwd: ctx.cwd, reason: event.reason });
+        return undefined;
+    });
+    pi.on("session_compact", async (_event, ctx) => {
+        engine.resetSession(ctx.cwd);
+        pi.appendEntry("pi-rules.scan", { cwd: ctx.cwd, reason: "compact" });
+        return undefined;
+    });
+    pi.on("before_agent_start", async (event, ctx) => {
+        syncConfigFromFlags();
+        if (engine.config.disabled || engine.config.mode === "off" || engine.config.mode === "dynamic") {
+            return undefined;
+        }
+        const loaded = engine.loadStaticRules(ctx.cwd);
+        const nativeContextPaths = new Set(event.systemPromptOptions.contextFiles?.flatMap((contextFile) => pathKeys(contextFile.path)) ?? []);
+        for (const rule of loaded.rules) {
+            if (nativeContextPaths.has(rule.path) || nativeContextPaths.has(rule.realPath)) {
+                engine.markStaticInjected(rule);
+            }
+        }
+        const rules = loaded.rules.filter((rule) => !nativeContextPaths.has(rule.path) &&
+            !nativeContextPaths.has(rule.realPath) &&
+            !engine.isStaticInjected(rule));
+        if (rules.length === 0) {
+            return undefined;
+        }
+        const block = engine.formatStatic(rules);
+        for (const rule of rules) {
+            engine.markStaticInjected(rule);
+        }
+        return { systemPrompt: event.systemPrompt + block };
+    });
+    pi.on("tool_result", async (event, ctx) => {
+        syncConfigFromFlags();
+        if (engine.config.disabled || engine.config.mode === "off" || engine.config.mode === "static" || event.isError) {
+            return undefined;
+        }
+        const targetPaths = extractToolPaths(event, ctx.cwd);
+        const firstTargetPath = targetPaths[0];
+        if (firstTargetPath === undefined) {
+            return undefined;
+        }
+        const fingerprints = engine.fingerprintDynamicTargets(ctx.cwd, targetPaths);
+        const pendingFingerprints = fingerprints.filter((target) => !engine.isDynamicTargetFingerprintCurrent(target));
+        if (pendingFingerprints.length === 0) {
+            engine.commitDynamicTargetFingerprints(fingerprints);
+            return undefined;
+        }
+        const loaded = engine.loadDynamicRules(ctx.cwd, pendingFingerprints.map((target) => target.targetPath));
+        engine.commitDynamicTargetFingerprints(fingerprints);
+        const rules = loaded.rules.filter((rule) => !engine.isStaticInjected(rule) && !engine.isDynamicInjected(firstTargetPath, rule));
+        if (rules.length === 0) {
+            return undefined;
+        }
+        const firstPendingTarget = pendingFingerprints[0]?.targetPath ?? firstTargetPath;
+        const block = engine.formatDynamic(rules, displayPath(ctx.cwd, firstPendingTarget));
+        for (const rule of rules) {
+            engine.markDynamicInjected(firstTargetPath, rule);
+        }
+        return { content: [...event.content, { type: "text", text: block }] };
+    });
+}
+function isPiRulesMode(value) {
+    return MODE_VALUES.has(value);
+}
+function pathKeys(filePath) {
+    try {
+        return [filePath, realpathSync.native(filePath)];
+    }
+    catch {
+        return [filePath];
+    }
+}
+function displayPath(cwd, filePath) {
+    return isAbsolute(filePath) ? relative(cwd, filePath) : filePath;
+}
+//# sourceMappingURL=index.js.map

package/dist/core/extensions/builtin/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/rules/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync, realpathSync } from \"node:fs\";\nimport { isAbsolute, relative } from \"node:path\";\n\nimport type { ExtensionAPI } from \"../../types.ts\";\n\nimport { registerSlashCommands } from \"./commands.ts\";\nimport { createEngine, defaultConfig } from \"./rules/engine.ts\";\nimport { findRuleCandidates } from \"./rules/finder.ts\";\nimport { findProjectRoot } from \"./rules/project-root.ts\";\nimport { extractToolPaths } from \"./rules/tool-paths.ts\";\nimport type { PiRulesConfig } from \"./rules/types.ts\";\n\ntype PiRulesMode = PiRulesConfig[\"mode\"];\n\nconst MODE_VALUES = new Set<string>([\"static\", \"dynamic\", \"both\", \"off\"]);\n\nexport default function piRulesExtension(pi: ExtensionAPI): void {\n\tpi.registerFlag(\"pi-rules-disabled\", {\n\t\ttype: \"boolean\",\n\t\tdefault: false,\n\t\tdescription: \"Disable pi-rules hooks.\",\n\t});\n\tpi.registerFlag(\"pi-rules-mode\", {\n\t\ttype: \"string\",\n\t\tdefault: \"both\",\n\t\tdescription: \"Rule injection mode: static, dynamic, both, or off.\",\n\t});\n\tconst config = defaultConfig();\n\tconst engine = createEngine(config, {\n\t\tfindCandidates: findRuleCandidates,\n\t\treadFile: (path) => {\n\t\t\ttry {\n\t\t\t\treturn readFileSync(path, \"utf-8\");\n\t\t\t} catch {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t},\n\t\tfindProjectRoot,\n\t\textractToolPaths,\n\t});\n\tregisterSlashCommands(pi, engine);\n\n\tfunction syncConfigFromFlags(): void {\n\t\tconst disabled = pi.getFlag(\"pi-rules-disabled\");\n\t\tconst mode = pi.getFlag(\"pi-rules-mode\");\n\n\t\tif (typeof disabled === \"boolean\") {\n\t\t\tengine.config.disabled = disabled;\n\t\t}\n\t\tif (typeof mode === \"string\" && isPiRulesMode(mode)) {\n\t\t\tengine.config.mode = mode;\n\t\t}\n\t}\n\n\tpi.on(\"session_start\", async (event, ctx) => {\n\t\tsyncConfigFromFlags();\n\t\tif (engine.config.disabled) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tengine.resetSession(ctx.cwd);\n\t\tpi.appendEntry(\"pi-rules.scan\", { cwd: ctx.cwd, reason: event.reason });\n\t\treturn undefined;\n\t});\n\n\tpi.on(\"session_compact\", async (_event, ctx) => {\n\t\tengine.resetSession(ctx.cwd);\n\t\tpi.appendEntry(\"pi-rules.scan\", { cwd: ctx.cwd, reason: \"compact\" });\n\t\treturn undefined;\n\t});\n\n\tpi.on(\"before_agent_start\", async (event, ctx) => {\n\t\tsyncConfigFromFlags();\n\t\tif (engine.config.disabled || engine.config.mode === \"off\" || engine.config.mode === \"dynamic\") {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst loaded = engine.loadStaticRules(ctx.cwd);\n\t\tconst nativeContextPaths = new Set(\n\t\t\tevent.systemPromptOptions.contextFiles?.flatMap((contextFile) => pathKeys(contextFile.path)) ?? [],\n\t\t);\n\t\tfor (const rule of loaded.rules) {\n\t\t\tif (nativeContextPaths.has(rule.path) || nativeContextPaths.has(rule.realPath)) {\n\t\t\t\tengine.markStaticInjected(rule);\n\t\t\t}\n\t\t}\n\t\tconst rules = loaded.rules.filter(\n\t\t\t(rule) =>\n\t\t\t\t!nativeContextPaths.has(rule.path) &&\n\t\t\t\t!nativeContextPaths.has(rule.realPath) &&\n\t\t\t\t!engine.isStaticInjected(rule),\n\t\t);\n\n\t\tif (rules.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst block = engine.formatStatic(rules);\n\t\tfor (const rule of rules) {\n\t\t\tengine.markStaticInjected(rule);\n\t\t}\n\n\t\treturn { systemPrompt: event.systemPrompt + block };\n\t});\n\n\tpi.on(\"tool_result\", async (event, ctx) => {\n\t\tsyncConfigFromFlags();\n\t\tif (engine.config.disabled || engine.config.mode === \"off\" || engine.config.mode === \"static\" || event.isError) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst targetPaths = extractToolPaths(event, ctx.cwd);\n\t\tconst firstTargetPath = targetPaths[0];\n\t\tif (firstTargetPath === undefined) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst fingerprints = engine.fingerprintDynamicTargets(ctx.cwd, targetPaths);\n\t\tconst pendingFingerprints = fingerprints.filter((target) => !engine.isDynamicTargetFingerprintCurrent(target));\n\t\tif (pendingFingerprints.length === 0) {\n\t\t\tengine.commitDynamicTargetFingerprints(fingerprints);\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst loaded = engine.loadDynamicRules(\n\t\t\tctx.cwd,\n\t\t\tpendingFingerprints.map((target) => target.targetPath),\n\t\t);\n\t\tengine.commitDynamicTargetFingerprints(fingerprints);\n\t\tconst rules = loaded.rules.filter(\n\t\t\t(rule) => !engine.isStaticInjected(rule) && !engine.isDynamicInjected(firstTargetPath, rule),\n\t\t);\n\t\tif (rules.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst firstPendingTarget = pendingFingerprints[0]?.targetPath ?? firstTargetPath;\n\t\tconst block = engine.formatDynamic(rules, displayPath(ctx.cwd, firstPendingTarget));\n\t\tfor (const rule of rules) {\n\t\t\tengine.markDynamicInjected(firstTargetPath, rule);\n\t\t}\n\n\t\treturn { content: [...event.content, { type: \"text\", text: block }] };\n\t});\n}\n\nfunction isPiRulesMode(value: string): value is PiRulesMode {\n\treturn MODE_VALUES.has(value);\n}\n\nfunction pathKeys(filePath: string): string[] {\n\ttry {\n\t\treturn [filePath, realpathSync.native(filePath)];\n\t} catch {\n\t\treturn [filePath];\n\t}\n}\n\nfunction displayPath(cwd: string, filePath: string): string {\n\treturn isAbsolute(filePath) ? relative(cwd, filePath) : filePath;\n}\n"]}

package/dist/core/extensions/builtin/rules/rules/cache.d.ts

@@ -0,0 +1,10 @@
+import type { LoadedRule, SessionState } from "./types.ts";
+export declare function createSessionState(cwd?: string): SessionState;
+export declare function staticDedupKey(cwd: string, rulePath: string, contentHash: string): string;
+export declare function dynamicDedupKey(scopeKey: string, rulePath: string, contentHash: string): string;
+export declare function markStaticInjected(state: SessionState, rule: LoadedRule): boolean;
+export declare function markDynamicInjected(state: SessionState, scopeKey: string, rule: LoadedRule): boolean;
+export declare function isStaticInjected(state: SessionState, rule: LoadedRule): boolean;
+export declare function isDynamicInjected(state: SessionState, scopeKey: string, rule: LoadedRule): boolean;
+export declare function clearSession(state: SessionState): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/extensions/builtin/rules/rules/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/rules/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3D,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,CAS7D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAQjF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAcpG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAE/E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAElG;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAMtD"}

package/dist/core/extensions/builtin/rules/rules/cache.js

@@ -0,0 +1,51 @@
+export function createSessionState(cwd) {
+    return {
+        cwd,
+        staticDedup: new Set(),
+        dynamicDedup: new Map(),
+        dynamicTargetFingerprints: new Map(),
+        loadedRules: [],
+        diagnostics: [],
+    };
+}
+export function staticDedupKey(cwd, rulePath, contentHash) {
+    return `${cwd}::${rulePath}::${contentHash}`;
+}
+export function dynamicDedupKey(scopeKey, rulePath, contentHash) {
+    return `${scopeKey}::${rulePath}::${contentHash}`;
+}
+export function markStaticInjected(state, rule) {
+    const key = staticDedupKey(state.cwd ?? "", rule.realPath, rule.contentHash);
+    if (state.staticDedup.has(key)) {
+        return false;
+    }
+    state.staticDedup.add(key);
+    return true;
+}
+export function markDynamicInjected(state, scopeKey, rule) {
+    let keys = state.dynamicDedup.get(scopeKey);
+    if (keys === undefined) {
+        keys = new Set();
+        state.dynamicDedup.set(scopeKey, keys);
+    }
+    const key = dynamicDedupKey(scopeKey, rule.realPath, rule.contentHash);
+    if (keys.has(key)) {
+        return false;
+    }
+    keys.add(key);
+    return true;
+}
+export function isStaticInjected(state, rule) {
+    return state.staticDedup.has(staticDedupKey(state.cwd ?? "", rule.realPath, rule.contentHash));
+}
+export function isDynamicInjected(state, scopeKey, rule) {
+    return state.dynamicDedup.get(scopeKey)?.has(dynamicDedupKey(scopeKey, rule.realPath, rule.contentHash)) === true;
+}
+export function clearSession(state) {
+    state.staticDedup.clear();
+    state.dynamicDedup.clear();
+    state.dynamicTargetFingerprints.clear();
+    state.loadedRules.length = 0;
+    state.diagnostics.length = 0;
+}
+//# sourceMappingURL=cache.js.map

package/dist/core/extensions/builtin/rules/rules/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/rules/cache.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC9C,OAAO;QACN,GAAG;QACH,WAAW,EAAE,IAAI,GAAG,EAAE;QACtB,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,yBAAyB,EAAE,IAAI,GAAG,EAAE;QACpC,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE;KACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,QAAgB,EAAE,WAAmB;IAChF,OAAO,GAAG,GAAG,KAAK,QAAQ,KAAK,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,QAAgB,EAAE,WAAmB;IACtF,OAAO,GAAG,QAAQ,KAAK,QAAQ,KAAK,WAAW,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAmB,EAAE,IAAgB;IACvE,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7E,IAAI,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAmB,EAAE,QAAgB,EAAE,IAAgB;IAC1F,IAAI,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACjB,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACd,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAmB,EAAE,IAAgB;IACrE,OAAO,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB,EAAE,QAAgB,EAAE,IAAgB;IACxF,OAAO,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC/C,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC1B,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC3B,KAAK,CAAC,yBAAyB,CAAC,KAAK,EAAE,CAAC;IACxC,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["import type { LoadedRule, SessionState } from \"./types.ts\";\n\nexport function createSessionState(cwd?: string): SessionState {\n\treturn {\n\t\tcwd,\n\t\tstaticDedup: new Set(),\n\t\tdynamicDedup: new Map(),\n\t\tdynamicTargetFingerprints: new Map(),\n\t\tloadedRules: [],\n\t\tdiagnostics: [],\n\t};\n}\n\nexport function staticDedupKey(cwd: string, rulePath: string, contentHash: string): string {\n\treturn `${cwd}::${rulePath}::${contentHash}`;\n}\n\nexport function dynamicDedupKey(scopeKey: string, rulePath: string, contentHash: string): string {\n\treturn `${scopeKey}::${rulePath}::${contentHash}`;\n}\n\nexport function markStaticInjected(state: SessionState, rule: LoadedRule): boolean {\n\tconst key = staticDedupKey(state.cwd ?? \"\", rule.realPath, rule.contentHash);\n\tif (state.staticDedup.has(key)) {\n\t\treturn false;\n\t}\n\n\tstate.staticDedup.add(key);\n\treturn true;\n}\n\nexport function markDynamicInjected(state: SessionState, scopeKey: string, rule: LoadedRule): boolean {\n\tlet keys = state.dynamicDedup.get(scopeKey);\n\tif (keys === undefined) {\n\t\tkeys = new Set();\n\t\tstate.dynamicDedup.set(scopeKey, keys);\n\t}\n\n\tconst key = dynamicDedupKey(scopeKey, rule.realPath, rule.contentHash);\n\tif (keys.has(key)) {\n\t\treturn false;\n\t}\n\n\tkeys.add(key);\n\treturn true;\n}\n\nexport function isStaticInjected(state: SessionState, rule: LoadedRule): boolean {\n\treturn state.staticDedup.has(staticDedupKey(state.cwd ?? \"\", rule.realPath, rule.contentHash));\n}\n\nexport function isDynamicInjected(state: SessionState, scopeKey: string, rule: LoadedRule): boolean {\n\treturn state.dynamicDedup.get(scopeKey)?.has(dynamicDedupKey(scopeKey, rule.realPath, rule.contentHash)) === true;\n}\n\nexport function clearSession(state: SessionState): void {\n\tstate.staticDedup.clear();\n\tstate.dynamicDedup.clear();\n\tstate.dynamicTargetFingerprints.clear();\n\tstate.loadedRules.length = 0;\n\tstate.diagnostics.length = 0;\n}\n"]}

package/dist/core/extensions/builtin/rules/rules/constants.d.ts

@@ -0,0 +1,57 @@
+import type { RuleSource } from "./types.ts";
+/**
+ * Project root marker files / directories used by `findProjectRoot`.
+ * Walks UP from cwd until any of these is found in the directory.
+ */
+export declare const PROJECT_MARKERS: readonly string[];
+/**
+ * Project rule subdirectories. First tuple element is the parent dir under
+ * the project root, second is the subdir scanned recursively.
+ */
+export declare const PROJECT_RULE_SUBDIRS: ReadonlyArray<readonly [string, string]>;
+/**
+ * Single-file project rules (always apply, frontmatter optional).
+ */
+export declare const PROJECT_SINGLE_FILES: readonly string[];
+/**
+ * User-home rule directories.
+ */
+export declare const USER_HOME_RULE_SUBDIRS: readonly string[];
+/**
+ * User-home single-file rules. The first one to exist wins per "first-match" semantics.
+ */
+export declare const USER_HOME_SINGLE_FILES: readonly string[];
+/**
+ * File extensions accepted as rule files in scanned directories.
+ */
+export declare const RULE_FILE_EXTENSIONS: readonly string[];
+/**
+ * Per-rule source priority for deterministic ordering. Lower = earlier.
+ */
+export declare const SOURCE_PRIORITY: ReadonlyMap<RuleSource, number>;
+/**
+ * Distance value assigned to global / user-home rules.
+ */
+export declare const GLOBAL_DISTANCE = 9999;
+/**
+ * Per-rule body character cap (default).
+ */
+export declare const DEFAULT_MAX_RULE_CHARS = 12000;
+/**
+ * Total injected chars per tool result (default).
+ */
+export declare const DEFAULT_MAX_RESULT_CHARS = 40000;
+/**
+ * Truncation marker template. `{path}` is replaced with the relative path.
+ */
+export declare const TRUNCATION_NOTICE = "\n\n[Rule truncated. Read full rule: {path}]";
+/**
+ * Built-in tool names whose results trigger dynamic rule injection.
+ */
+export declare const TRACKED_BUILTIN_TOOLS: readonly string[];
+export declare const TRACKED_BUILTIN_TOOL_SET: ReadonlySet<string>;
+/**
+ * Directories excluded by the recursive scanner regardless of glob settings.
+ */
+export declare const SCANNER_EXCLUDED_DIRS: readonly string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/extensions/builtin/rules/rules/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/rules/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAQ5C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAKzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAKjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAuD,CAAC;AAE5G;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAwD,CAAC;AAE7G;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAoB,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,UAAU,EAAE,MAAM,CAc1D,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,iBAAiB,iDAAiD,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAA8B,CAAC;AAClF,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAAkC,CAAC;AAE5F;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAQlD,CAAC"}

package/dist/core/extensions/builtin/rules/rules/constants.js

@@ -0,0 +1,96 @@
+/**
+ * Project root marker files / directories used by `findProjectRoot`.
+ * Walks UP from cwd until any of these is found in the directory.
+ */
+export const PROJECT_MARKERS = [
+    ".git",
+    "pnpm-workspace.yaml",
+    "package.json",
+    "pyproject.toml",
+    "Cargo.toml",
+    "go.mod",
+    ".venv",
+];
+/**
+ * Project rule subdirectories. First tuple element is the parent dir under
+ * the project root, second is the subdir scanned recursively.
+ */
+export const PROJECT_RULE_SUBDIRS = [
+    [".omo", "rules"],
+    [".claude", "rules"],
+    [".cursor", "rules"],
+    [".github", "instructions"],
+];
+/**
+ * Single-file project rules (always apply, frontmatter optional).
+ */
+export const PROJECT_SINGLE_FILES = [
+    ".github/copilot-instructions.md",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "CONTEXT.md",
+];
+/**
+ * User-home rule directories.
+ */
+export const USER_HOME_RULE_SUBDIRS = [".omo/rules", ".opencode/rules", ".claude/rules"];
+/**
+ * User-home single-file rules. The first one to exist wins per "first-match" semantics.
+ */
+export const USER_HOME_SINGLE_FILES = [".config/opencode/AGENTS.md", ".claude/CLAUDE.md"];
+/**
+ * File extensions accepted as rule files in scanned directories.
+ */
+export const RULE_FILE_EXTENSIONS = [".md", ".mdc"];
+/**
+ * Per-rule source priority for deterministic ordering. Lower = earlier.
+ */
+export const SOURCE_PRIORITY = new Map([
+    [".omo/rules", 0],
+    [".claude/rules", 1],
+    [".cursor/rules", 2],
+    [".github/instructions", 3],
+    [".github/copilot-instructions.md", 4],
+    ["AGENTS.md", 5],
+    ["CLAUDE.md", 6],
+    ["CONTEXT.md", 7],
+    ["~/.omo/rules", 100],
+    ["~/.opencode/rules", 101],
+    ["~/.claude/rules", 102],
+    ["~/.config/opencode/AGENTS.md", 103],
+    ["~/.claude/CLAUDE.md", 104],
+]);
+/**
+ * Distance value assigned to global / user-home rules.
+ */
+export const GLOBAL_DISTANCE = 9999;
+/**
+ * Per-rule body character cap (default).
+ */
+export const DEFAULT_MAX_RULE_CHARS = 12000;
+/**
+ * Total injected chars per tool result (default).
+ */
+export const DEFAULT_MAX_RESULT_CHARS = 40000;
+/**
+ * Truncation marker template. `{path}` is replaced with the relative path.
+ */
+export const TRUNCATION_NOTICE = "\n\n[Rule truncated. Read full rule: {path}]";
+/**
+ * Built-in tool names whose results trigger dynamic rule injection.
+ */
+export const TRACKED_BUILTIN_TOOLS = ["read", "edit", "write"];
+export const TRACKED_BUILTIN_TOOL_SET = new Set(TRACKED_BUILTIN_TOOLS);
+/**
+ * Directories excluded by the recursive scanner regardless of glob settings.
+ */
+export const SCANNER_EXCLUDED_DIRS = [
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    ".turbo",
+    ".next",
+    "coverage",
+];
+//# sourceMappingURL=constants.js.map

package/dist/core/extensions/builtin/rules/rules/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/rules/constants.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsB;IACjD,MAAM;IACN,qBAAqB;IACrB,cAAc;IACd,gBAAgB;IAChB,YAAY;IACZ,QAAQ;IACR,OAAO;CACP,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA6C;IAC7E,CAAC,MAAM,EAAE,OAAO,CAAC;IACjB,CAAC,SAAS,EAAE,OAAO,CAAC;IACpB,CAAC,SAAS,EAAE,OAAO,CAAC;IACpB,CAAC,SAAS,EAAE,cAAc,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACtD,iCAAiC;IACjC,WAAW;IACX,WAAW;IACX,YAAY;CACZ,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsB,CAAC,YAAY,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAC;AAE5G;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsB,CAAC,4BAA4B,EAAE,mBAAmB,CAAC,CAAC;AAE7G;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoC,IAAI,GAAG,CAAC;IACvE,CAAC,YAAY,EAAE,CAAC,CAAC;IACjB,CAAC,eAAe,EAAE,CAAC,CAAC;IACpB,CAAC,eAAe,EAAE,CAAC,CAAC;IACpB,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC3B,CAAC,iCAAiC,EAAE,CAAC,CAAC;IACtC,CAAC,WAAW,EAAE,CAAC,CAAC;IAChB,CAAC,WAAW,EAAE,CAAC,CAAC;IAChB,CAAC,YAAY,EAAE,CAAC,CAAC;IACjB,CAAC,cAAc,EAAE,GAAG,CAAC;IACrB,CAAC,mBAAmB,EAAE,GAAG,CAAC;IAC1B,CAAC,iBAAiB,EAAE,GAAG,CAAC;IACxB,CAAC,8BAA8B,EAAE,GAAG,CAAC;IACrC,CAAC,qBAAqB,EAAE,GAAG,CAAC;CAC5B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,8CAA8C,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAE5F;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACvD,cAAc;IACd,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,UAAU;CACV,CAAC","sourcesContent":["import type { RuleSource } from \"./types.ts\";\n\n/**\n * Project root marker files / directories used by `findProjectRoot`.\n * Walks UP from cwd until any of these is found in the directory.\n */\nexport const PROJECT_MARKERS: readonly string[] = [\n\t\".git\",\n\t\"pnpm-workspace.yaml\",\n\t\"package.json\",\n\t\"pyproject.toml\",\n\t\"Cargo.toml\",\n\t\"go.mod\",\n\t\".venv\",\n];\n\n/**\n * Project rule subdirectories. First tuple element is the parent dir under\n * the project root, second is the subdir scanned recursively.\n */\nexport const PROJECT_RULE_SUBDIRS: ReadonlyArray<readonly [string, string]> = [\n\t[\".omo\", \"rules\"],\n\t[\".claude\", \"rules\"],\n\t[\".cursor\", \"rules\"],\n\t[\".github\", \"instructions\"],\n];\n\n/**\n * Single-file project rules (always apply, frontmatter optional).\n */\nexport const PROJECT_SINGLE_FILES: readonly string[] = [\n\t\".github/copilot-instructions.md\",\n\t\"AGENTS.md\",\n\t\"CLAUDE.md\",\n\t\"CONTEXT.md\",\n];\n\n/**\n * User-home rule directories.\n */\nexport const USER_HOME_RULE_SUBDIRS: readonly string[] = [\".omo/rules\", \".opencode/rules\", \".claude/rules\"];\n\n/**\n * User-home single-file rules. The first one to exist wins per \"first-match\" semantics.\n */\nexport const USER_HOME_SINGLE_FILES: readonly string[] = [\".config/opencode/AGENTS.md\", \".claude/CLAUDE.md\"];\n\n/**\n * File extensions accepted as rule files in scanned directories.\n */\nexport const RULE_FILE_EXTENSIONS: readonly string[] = [\".md\", \".mdc\"];\n\n/**\n * Per-rule source priority for deterministic ordering. Lower = earlier.\n */\nexport const SOURCE_PRIORITY: ReadonlyMap<RuleSource, number> = new Map([\n\t[\".omo/rules\", 0],\n\t[\".claude/rules\", 1],\n\t[\".cursor/rules\", 2],\n\t[\".github/instructions\", 3],\n\t[\".github/copilot-instructions.md\", 4],\n\t[\"AGENTS.md\", 5],\n\t[\"CLAUDE.md\", 6],\n\t[\"CONTEXT.md\", 7],\n\t[\"~/.omo/rules\", 100],\n\t[\"~/.opencode/rules\", 101],\n\t[\"~/.claude/rules\", 102],\n\t[\"~/.config/opencode/AGENTS.md\", 103],\n\t[\"~/.claude/CLAUDE.md\", 104],\n]);\n\n/**\n * Distance value assigned to global / user-home rules.\n */\nexport const GLOBAL_DISTANCE = 9999;\n\n/**\n * Per-rule body character cap (default).\n */\nexport const DEFAULT_MAX_RULE_CHARS = 12000;\n\n/**\n * Total injected chars per tool result (default).\n */\nexport const DEFAULT_MAX_RESULT_CHARS = 40000;\n\n/**\n * Truncation marker template. `{path}` is replaced with the relative path.\n */\nexport const TRUNCATION_NOTICE = \"\\n\\n[Rule truncated. Read full rule: {path}]\";\n\n/**\n * Built-in tool names whose results trigger dynamic rule injection.\n */\nexport const TRACKED_BUILTIN_TOOLS: readonly string[] = [\"read\", \"edit\", \"write\"];\nexport const TRACKED_BUILTIN_TOOL_SET: ReadonlySet<string> = new Set(TRACKED_BUILTIN_TOOLS);\n\n/**\n * Directories excluded by the recursive scanner regardless of glob settings.\n */\nexport const SCANNER_EXCLUDED_DIRS: readonly string[] = [\n\t\"node_modules\",\n\t\".git\",\n\t\"dist\",\n\t\"build\",\n\t\".turbo\",\n\t\".next\",\n\t\"coverage\",\n];\n"]}

package/dist/core/extensions/builtin/rules/rules/engine.d.ts

@@ -0,0 +1,67 @@
+import type { ToolResultEvent } from "../../../types.ts";
+import { type RuleDiscoveryCache } from "./finder.ts";
+import { matchRule } from "./matcher.ts";
+import type { LoadedRule, PiRulesConfig, RuleCandidate, RuleDiagnostic, SessionState } from "./types.ts";
+export interface EngineDeps {
+    findCandidates: (options: {
+        projectRoot: string | null;
+        targetFile: string | null;
+        homeDir?: string;
+        disabledSources?: ReadonlySet<string>;
+        skipUserHome?: boolean;
+        cache?: RuleDiscoveryCache;
+    }) => RuleCandidate[];
+    readFile: (path: string) => string | null;
+    findProjectRoot: (startPath: string) => string | null;
+    extractToolPaths: (event: ToolResultEvent, cwd: string) => string[];
+    matchRule?: typeof matchRule;
+    /**
+     * Returns a stable identifier for a rule file. Default uses `statSync` mtime/ctime/size.
+     * Tests may inject a content-based fingerprint when fixtures use synthetic paths.
+     */
+    fileFingerprint?: (filePath: string) => string;
+}
+export interface DynamicTargetFingerprint {
+    targetPath: string;
+    cacheKey: string;
+    fingerprint: string;
+}
+export interface Engine {
+    state: SessionState;
+    config: PiRulesConfig;
+    loadStaticRules(cwd: string): {
+        rules: LoadedRule[];
+        diagnostics: RuleDiagnostic[];
+    };
+    loadDynamicRules(cwd: string, targetPaths: ReadonlyArray<string>): {
+        rules: LoadedRule[];
+        diagnostics: RuleDiagnostic[];
+    };
+    formatStatic(rules: ReadonlyArray<LoadedRule>): string;
+    formatDynamic(rules: ReadonlyArray<LoadedRule>, target: string): string;
+    resetSession(cwd?: string): void;
+    isStaticInjected(rule: LoadedRule): boolean;
+    isDynamicInjected(scopeKey: string, rule: LoadedRule): boolean;
+    markStaticInjected(rule: LoadedRule): boolean;
+    markDynamicInjected(scopeKey: string, rule: LoadedRule): boolean;
+    /**
+     * Computes a fingerprint for each unique target derived from its discovered
+     * candidates plus their on-disk fingerprints. Pure - does not mutate state.
+     */
+    fingerprintDynamicTargets(cwd: string, targetPaths: ReadonlyArray<string>): DynamicTargetFingerprint[];
+    /**
+     * Returns true when the fingerprint for a target already matches the value
+     * stored on `state.dynamicTargetFingerprints`. The hook layer skips
+     * `loadDynamicRules` entirely when every target is current.
+     */
+    isDynamicTargetFingerprintCurrent(target: DynamicTargetFingerprint): boolean;
+    /**
+     * Commits the supplied fingerprints to `state.dynamicTargetFingerprints`.
+     * Always pass every fingerprint observed during a hook invocation so the
+     * map mirrors the latest discovery.
+     */
+    commitDynamicTargetFingerprints(fingerprints: ReadonlyArray<DynamicTargetFingerprint>): void;
+}
+export declare function defaultConfig(): PiRulesConfig;
+export declare function createEngine(config: PiRulesConfig, deps: EngineDeps): Engine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/core/extensions/builtin/rules/rules/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/rules/engine.ts"],"names":[],"mappings":"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"}