@dyyz1993/pi-coding-agent 0.69.12 → 0.69.14

package/dist/rules-engine/loader.js

@@ -0,0 +1,190 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+function splitComma(val) {
+    const result = [];
+    let depth = 0;
+    let current = "";
+    for (const ch of val) {
+        if (ch === "{" || ch === "(" || ch === "[")
+            depth++;
+        else if (ch === "}" || ch === ")" || ch === "]")
+            depth--;
+        if (ch === "," && depth === 0) {
+            const trimmed = current.trim().replace(/^["']|["']$/g, "");
+            if (trimmed)
+                result.push(trimmed);
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    const trimmed = current.trim().replace(/^["']|["']$/g, "");
+    if (trimmed)
+        result.push(trimmed);
+    return result;
+}
+export function parseFrontmatter(content) {
+    const frontmatterRegex = /^---\r?\n([\s\S]*?)\n?---\r?\n([\s\S]*)$/;
+    const match = content.match(frontmatterRegex);
+    if (!match) {
+        return { data: {}, body: content };
+    }
+    const [, frontmatterStr, body] = match;
+    const data = {};
+    const lines = frontmatterStr.split("\n");
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const colonIndex = line.indexOf(":");
+        if (colonIndex === -1) {
+            i++;
+            continue;
+        }
+        const rawKey = line.slice(0, colonIndex).trim();
+        let value = line.slice(colonIndex + 1).trim();
+        if (value === "" || value === "null" || value === "undefined") {
+            const listItems = [];
+            let j = i + 1;
+            while (j < lines.length) {
+                const subLine = lines[j];
+                if (subLine.match(/^\s*-\s+/)) {
+                    listItems.push(subLine
+                        .replace(/^\s*-\s+/, "")
+                        .trim()
+                        .replace(/^["']|["']$/g, ""));
+                    j++;
+                }
+                else if (subLine.trim() === "" || subLine.match(/^\s+/)) {
+                    j++;
+                }
+                else {
+                    break;
+                }
+            }
+            if (listItems.length > 0) {
+                const camelKey = rawKey.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+                data[camelKey] = listItems;
+                i = j;
+                continue;
+            }
+            value = null;
+        }
+        else if (value.startsWith("[") && value.endsWith("]")) {
+            try {
+                value = JSON.parse(value.replace(/'/g, '"'));
+            }
+            catch {
+                value = value
+                    .slice(1, -1)
+                    .split(",")
+                    .map((v) => v.trim().replace(/^["']|["']$/g, ""));
+            }
+        }
+        else if (value.startsWith('"') && value.endsWith('"')) {
+            value = value.slice(1, -1);
+        }
+        else if (value.startsWith("'") && value.endsWith("'")) {
+            value = value.slice(1, -1);
+        }
+        const camelKey = rawKey.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+        if (camelKey === "paths" && typeof value === "string") {
+            data[camelKey] = splitComma(value);
+        }
+        else {
+            data[camelKey] = value;
+        }
+        i++;
+    }
+    return { data, body: body.trim() };
+}
+function extractTitle(body) {
+    for (const line of body.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed) {
+            return trimmed.replace(/^#+\s*/, "").replace(/\*\*/g, "");
+        }
+    }
+    return "Untitled Rule";
+}
+function parsePaths(raw) {
+    if (!raw)
+        return [];
+    if (typeof raw === "string") {
+        return raw
+            .split(",")
+            .map((g) => g.trim())
+            .filter(Boolean);
+    }
+    if (Array.isArray(raw))
+        return raw;
+    return [];
+}
+export function parseRuleFile(filePath, content) {
+    const { data, body } = parseFrontmatter(content);
+    const paths = parsePaths(data.paths);
+    const isUnconditional = paths.length === 0 || (paths.length === 1 && paths[0] === "**");
+    const frontmatter = {};
+    if (data.description && typeof data.description === "string")
+        frontmatter.description = data.description;
+    if (data.severity && typeof data.severity === "string")
+        frontmatter.severity = data.severity;
+    if (data.paths)
+        frontmatter.paths = paths;
+    if (data.allowedTools)
+        frontmatter.allowedTools =
+            typeof data.allowedTools === "string" ? [data.allowedTools] : data.allowedTools;
+    if (data.whenToUse && typeof data.whenToUse === "string")
+        frontmatter.whenToUse = data.whenToUse;
+    if (data.notifyOnMatch !== undefined)
+        frontmatter.notifyOnMatch = data.notifyOnMatch === "true" || data.notifyOnMatch === true;
+    if (data.skipInPrompt !== undefined)
+        frontmatter.skipInPrompt = data.skipInPrompt === "true" || data.skipInPrompt === true;
+    return {
+        name: path.basename(filePath, ".md"),
+        filePath,
+        title: extractTitle(body),
+        content: body.trim(),
+        scope: "project",
+        source: "",
+        frontmatter,
+        isUnconditional,
+    };
+}
+function scanDir(dir, files = []) {
+    if (!fs.existsSync(dir))
+        return files;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            scanDir(fullPath, files);
+        }
+        else if (entry.isFile() && (entry.name.endsWith(".md") || entry.name.endsWith(".mdc"))) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+export function loadRules(rulesDir) {
+    const rules = [];
+    const unconditional = [];
+    const conditional = [];
+    if (!fs.existsSync(rulesDir)) {
+        return { rules, unconditional, conditional, loadedAt: Date.now() };
+    }
+    const files = scanDir(rulesDir);
+    for (const filePath of files) {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const rule = parseRuleFile(filePath, content);
+        rules.push(rule);
+        if (rule.isUnconditional) {
+            unconditional.push(rule);
+        }
+        else {
+            conditional.push(rule);
+        }
+    }
+    return { rules, unconditional, conditional, loadedAt: Date.now() };
+}
+//# sourceMappingURL=loader.js.map

package/dist/rules-engine/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/rules-engine/loader.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { ParsedRule, RuleCache, RuleFrontmatter } from \"./types.js\";\n\nfunction splitComma(val: string): string[] {\n\tconst result: string[] = [];\n\tlet depth = 0;\n\tlet current = \"\";\n\tfor (const ch of val) {\n\t\tif (ch === \"{\" || ch === \"(\" || ch === \"[\") depth++;\n\t\telse if (ch === \"}\" || ch === \")\" || ch === \"]\") depth--;\n\n\t\tif (ch === \",\" && depth === 0) {\n\t\t\tconst trimmed = current.trim().replace(/^[\"']|[\"']$/g, \"\");\n\t\t\tif (trimmed) result.push(trimmed);\n\t\t\tcurrent = \"\";\n\t\t} else {\n\t\t\tcurrent += ch;\n\t\t}\n\t}\n\tconst trimmed = current.trim().replace(/^[\"']|[\"']$/g, \"\");\n\tif (trimmed) result.push(trimmed);\n\treturn result;\n}\n\nexport function parseFrontmatter(content: string): { data: Record<string, unknown>; body: string } {\n\tconst frontmatterRegex = /^---\\r?\\n([\\s\\S]*?)\\n?---\\r?\\n([\\s\\S]*)$/;\n\tconst match = content.match(frontmatterRegex);\n\n\tif (!match) {\n\t\treturn { data: {}, body: content };\n\t}\n\n\tconst [, frontmatterStr, body] = match;\n\tconst data: Record<string, unknown> = {};\n\n\tconst lines = frontmatterStr.split(\"\\n\");\n\tlet i = 0;\n\twhile (i < lines.length) {\n\t\tconst line = lines[i];\n\t\tconst colonIndex = line.indexOf(\":\");\n\t\tif (colonIndex === -1) {\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst rawKey = line.slice(0, colonIndex).trim();\n\t\tlet value: string | string[] | null = line.slice(colonIndex + 1).trim();\n\n\t\tif (value === \"\" || value === \"null\" || value === \"undefined\") {\n\t\t\tconst listItems: string[] = [];\n\t\t\tlet j = i + 1;\n\t\t\twhile (j < lines.length) {\n\t\t\t\tconst subLine = lines[j];\n\t\t\t\tif (subLine.match(/^\\s*-\\s+/)) {\n\t\t\t\t\tlistItems.push(\n\t\t\t\t\t\tsubLine\n\t\t\t\t\t\t\t.replace(/^\\s*-\\s+/, \"\")\n\t\t\t\t\t\t\t.trim()\n\t\t\t\t\t\t\t.replace(/^[\"']|[\"']$/g, \"\"),\n\t\t\t\t\t);\n\t\t\t\t\tj++;\n\t\t\t\t} else if (subLine.trim() === \"\" || subLine.match(/^\\s+/)) {\n\t\t\t\t\tj++;\n\t\t\t\t} else {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (listItems.length > 0) {\n\t\t\t\tconst camelKey = rawKey.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());\n\t\t\t\tdata[camelKey] = listItems;\n\t\t\t\ti = j;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tvalue = null;\n\t\t} else if (value.startsWith(\"[\") && value.endsWith(\"]\")) {\n\t\t\ttry {\n\t\t\t\tvalue = JSON.parse(value.replace(/'/g, '\"'));\n\t\t\t} catch {\n\t\t\t\tvalue = (value as string)\n\t\t\t\t\t.slice(1, -1)\n\t\t\t\t\t.split(\",\")\n\t\t\t\t\t.map((v: string) => v.trim().replace(/^[\"']|[\"']$/g, \"\"));\n\t\t\t}\n\t\t} else if (value.startsWith('\"') && value.endsWith('\"')) {\n\t\t\tvalue = value.slice(1, -1);\n\t\t} else if (value.startsWith(\"'\") && value.endsWith(\"'\")) {\n\t\t\tvalue = value.slice(1, -1);\n\t\t}\n\n\t\tconst camelKey = rawKey.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());\n\n\t\tif (camelKey === \"paths\" && typeof value === \"string\") {\n\t\t\tdata[camelKey] = splitComma(value);\n\t\t} else {\n\t\t\tdata[camelKey] = value;\n\t\t}\n\t\ti++;\n\t}\n\n\treturn { data, body: body.trim() };\n}\n\nfunction extractTitle(body: string): string {\n\tfor (const line of body.split(\"\\n\")) {\n\t\tconst trimmed = line.trim();\n\t\tif (trimmed) {\n\t\t\treturn trimmed.replace(/^#+\\s*/, \"\").replace(/\\*\\*/g, \"\");\n\t\t}\n\t}\n\treturn \"Untitled Rule\";\n}\n\nfunction parsePaths(raw: unknown): string[] {\n\tif (!raw) return [];\n\tif (typeof raw === \"string\") {\n\t\treturn raw\n\t\t\t.split(\",\")\n\t\t\t.map((g) => g.trim())\n\t\t\t.filter(Boolean);\n\t}\n\tif (Array.isArray(raw)) return raw as string[];\n\treturn [];\n}\n\nexport function parseRuleFile(filePath: string, content: string): ParsedRule {\n\tconst { data, body } = parseFrontmatter(content);\n\tconst paths = parsePaths(data.paths);\n\tconst isUnconditional = paths.length === 0 || (paths.length === 1 && paths[0] === \"**\");\n\n\tconst frontmatter: RuleFrontmatter = {};\n\tif (data.description && typeof data.description === \"string\") frontmatter.description = data.description;\n\tif (data.severity && typeof data.severity === \"string\")\n\t\tfrontmatter.severity = data.severity as ParsedRule[\"frontmatter\"][\"severity\"];\n\tif (data.paths) frontmatter.paths = paths;\n\tif (data.allowedTools)\n\t\tfrontmatter.allowedTools =\n\t\t\ttypeof data.allowedTools === \"string\" ? [data.allowedTools] : (data.allowedTools as string[]);\n\tif (data.whenToUse && typeof data.whenToUse === \"string\") frontmatter.whenToUse = data.whenToUse;\n\tif (data.notifyOnMatch !== undefined)\n\t\tfrontmatter.notifyOnMatch = data.notifyOnMatch === \"true\" || data.notifyOnMatch === true;\n\tif (data.skipInPrompt !== undefined)\n\t\tfrontmatter.skipInPrompt = data.skipInPrompt === \"true\" || data.skipInPrompt === true;\n\n\treturn {\n\t\tname: path.basename(filePath, \".md\"),\n\t\tfilePath,\n\t\ttitle: extractTitle(body),\n\t\tcontent: body.trim(),\n\t\tscope: \"project\",\n\t\tsource: \"\",\n\t\tfrontmatter,\n\t\tisUnconditional,\n\t};\n}\n\nfunction scanDir(dir: string, files: string[] = []): string[] {\n\tif (!fs.existsSync(dir)) return files;\n\tconst entries = fs.readdirSync(dir, { withFileTypes: true });\n\tfor (const entry of entries) {\n\t\tconst fullPath = path.join(dir, entry.name);\n\t\tif (entry.isDirectory()) {\n\t\t\tscanDir(fullPath, files);\n\t\t} else if (entry.isFile() && (entry.name.endsWith(\".md\") || entry.name.endsWith(\".mdc\"))) {\n\t\t\tfiles.push(fullPath);\n\t\t}\n\t}\n\treturn files;\n}\n\nexport function loadRules(rulesDir: string): RuleCache {\n\tconst rules: ParsedRule[] = [];\n\tconst unconditional: ParsedRule[] = [];\n\tconst conditional: ParsedRule[] = [];\n\n\tif (!fs.existsSync(rulesDir)) {\n\t\treturn { rules, unconditional, conditional, loadedAt: Date.now() };\n\t}\n\n\tconst files = scanDir(rulesDir);\n\n\tfor (const filePath of files) {\n\t\tconst content = fs.readFileSync(filePath, \"utf-8\");\n\t\tconst rule = parseRuleFile(filePath, content);\n\t\trules.push(rule);\n\t\tif (rule.isUnconditional) {\n\t\t\tunconditional.push(rule);\n\t\t} else {\n\t\t\tconditional.push(rule);\n\t\t}\n\t}\n\n\treturn { rules, unconditional, conditional, loadedAt: Date.now() };\n}\n"]}

package/dist/rules-engine/matcher.d.ts

@@ -0,0 +1,3 @@
+export declare function matchGlob(pattern: string, target: string): boolean;
+export declare function matchesAnyGlob(globs: string[], filePath: string): boolean;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/rules-engine/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/rules-engine/matcher.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAoClE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIzE","sourcesContent":["export function matchGlob(pattern: string, target: string): boolean {\n\tif (!pattern || !target) return false;\n\n\tconst normalizedTarget = target.replace(/\\\\/g, \"/\");\n\tlet i = 0;\n\tlet re = \"\";\n\n\twhile (i < pattern.length) {\n\t\tconst ch = pattern[i];\n\t\tif (ch === \"*\") {\n\t\t\tif (pattern[i + 1] === \"*\") {\n\t\t\t\tre += \".*\";\n\t\t\t\ti += 2;\n\t\t\t\tif (pattern[i] === \"/\") i++;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tre += \"[^/]*\";\n\t\t} else if (ch === \"?\") {\n\t\t\tre += \"[^/]\";\n\t\t} else if (ch === \".\") {\n\t\t\tre += \"\\\\.\";\n\t\t} else if (ch === \"{\") {\n\t\t\tconst close = pattern.indexOf(\"}\", i);\n\t\t\tif (close !== -1) {\n\t\t\t\tre += `(${pattern.slice(i + 1, close).replace(/,/g, \"|\")})`;\n\t\t\t\ti = close;\n\t\t\t} else {\n\t\t\t\tre += ch;\n\t\t\t}\n\t\t} else {\n\t\t\tre += ch;\n\t\t}\n\t\ti++;\n\t}\n\n\treturn new RegExp(`^${re}$`).test(normalizedTarget);\n}\n\nexport function matchesAnyGlob(globs: string[], filePath: string): boolean {\n\tif (!filePath || globs.length === 0) return false;\n\tconst normalized = filePath.replace(/\\\\/g, \"/\");\n\treturn globs.some((g) => matchGlob(g, normalized));\n}\n"]}

package/dist/rules-engine/matcher.js

@@ -0,0 +1,48 @@
+export function matchGlob(pattern, target) {
+    if (!pattern || !target)
+        return false;
+    const normalizedTarget = target.replace(/\\/g, "/");
+    let i = 0;
+    let re = "";
+    while (i < pattern.length) {
+        const ch = pattern[i];
+        if (ch === "*") {
+            if (pattern[i + 1] === "*") {
+                re += ".*";
+                i += 2;
+                if (pattern[i] === "/")
+                    i++;
+                continue;
+            }
+            re += "[^/]*";
+        }
+        else if (ch === "?") {
+            re += "[^/]";
+        }
+        else if (ch === ".") {
+            re += "\\.";
+        }
+        else if (ch === "{") {
+            const close = pattern.indexOf("}", i);
+            if (close !== -1) {
+                re += `(${pattern.slice(i + 1, close).replace(/,/g, "|")})`;
+                i = close;
+            }
+            else {
+                re += ch;
+            }
+        }
+        else {
+            re += ch;
+        }
+        i++;
+    }
+    return new RegExp(`^${re}$`).test(normalizedTarget);
+}
+export function matchesAnyGlob(globs, filePath) {
+    if (!filePath || globs.length === 0)
+        return false;
+    const normalized = filePath.replace(/\\/g, "/");
+    return globs.some((g) => matchGlob(g, normalized));
+}
+//# sourceMappingURL=matcher.js.map

package/dist/rules-engine/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../../src/rules-engine/matcher.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,MAAc,EAAW;IACnE,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,EAAE,GAAG,EAAE,CAAC;IAEZ,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAChB,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC5B,EAAE,IAAI,IAAI,CAAC;gBACX,CAAC,IAAI,CAAC,CAAC;gBACP,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;oBAAE,CAAC,EAAE,CAAC;gBAC5B,SAAS;YACV,CAAC;YACD,EAAE,IAAI,OAAO,CAAC;QACf,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACvB,EAAE,IAAI,MAAM,CAAC;QACd,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACvB,EAAE,IAAI,KAAK,CAAC;QACb,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACtC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClB,EAAE,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;gBAC5D,CAAC,GAAG,KAAK,CAAC;YACX,CAAC;iBAAM,CAAC;gBACP,EAAE,IAAI,EAAE,CAAC;YACV,CAAC;QACF,CAAC;aAAM,CAAC;YACP,EAAE,IAAI,EAAE,CAAC;QACV,CAAC;QACD,CAAC,EAAE,CAAC;IACL,CAAC;IAED,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAAA,CACpD;AAED,MAAM,UAAU,cAAc,CAAC,KAAe,EAAE,QAAgB,EAAW;IAC1E,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;AAAA,CACnD","sourcesContent":["export function matchGlob(pattern: string, target: string): boolean {\n\tif (!pattern || !target) return false;\n\n\tconst normalizedTarget = target.replace(/\\\\/g, \"/\");\n\tlet i = 0;\n\tlet re = \"\";\n\n\twhile (i < pattern.length) {\n\t\tconst ch = pattern[i];\n\t\tif (ch === \"*\") {\n\t\t\tif (pattern[i + 1] === \"*\") {\n\t\t\t\tre += \".*\";\n\t\t\t\ti += 2;\n\t\t\t\tif (pattern[i] === \"/\") i++;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tre += \"[^/]*\";\n\t\t} else if (ch === \"?\") {\n\t\t\tre += \"[^/]\";\n\t\t} else if (ch === \".\") {\n\t\t\tre += \"\\\\.\";\n\t\t} else if (ch === \"{\") {\n\t\t\tconst close = pattern.indexOf(\"}\", i);\n\t\t\tif (close !== -1) {\n\t\t\t\tre += `(${pattern.slice(i + 1, close).replace(/,/g, \"|\")})`;\n\t\t\t\ti = close;\n\t\t\t} else {\n\t\t\t\tre += ch;\n\t\t\t}\n\t\t} else {\n\t\t\tre += ch;\n\t\t}\n\t\ti++;\n\t}\n\n\treturn new RegExp(`^${re}$`).test(normalizedTarget);\n}\n\nexport function matchesAnyGlob(globs: string[], filePath: string): boolean {\n\tif (!filePath || globs.length === 0) return false;\n\tconst normalized = filePath.replace(/\\\\/g, \"/\");\n\treturn globs.some((g) => matchGlob(g, normalized));\n}\n"]}

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

@@ -0,0 +1,150 @@
+export type RuleSeverity = "critical" | "high" | "medium" | "low" | "hint";
+export type RuleScope = "user" | "pi" | "project" | "managed";
+export interface RuleFrontmatter {
+    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;
+    paths: string[];
+    description?: string;
+}
+export interface ScannedDir {
+    dir: string;
+    fileCount: number;
+    ruleNames: string[];
+}
+export interface MatchedRuleDetail {
+    name: string;
+    title: string;
+    severity: RuleSeverity;
+    matchedGlob: string;
+}
+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;
+}
+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 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/rules-engine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rules-engine/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\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\tpaths: 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}\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}\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 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/rules-engine/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/rules-engine/types.ts"],"names":[],"mappings":"","sourcesContent":["export type RuleSeverity = \"critical\" | \"high\" | \"medium\" | \"low\" | \"hint\";\n\nexport type RuleScope = \"user\" | \"pi\" | \"project\" | \"managed\";\n\nexport interface RuleFrontmatter {\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\tpaths: 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}\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}\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 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/docs/extensions.md

@@ -832,89 +832,89 @@ Transforms chain across handlers. See [input-transform.ts](../examples/extension
 
 ### UI Interception Events
 
-Intercept `ctx.ui.confirm()`, `ctx.ui.select()`, and `ctx.ui.input()` calls from **any extension** or the agent itself. This allows a single extension to take over all UI dialogs -- for example, to forward permission requests to a remote service and wait for a response.
+Intercept `ctx.ui.confirm()`, `ctx.ui.select()`, and `ctx.ui.input()` calls from **any extension** or the agent itself. This allows a single extension to observe and respond to all UI dialogs -- for example, to forward permission requests to a remote service and wait for a response.
 
 Without UI interception, each extension calls `ctx.ui.confirm()` independently and the results are invisible to other extensions. With UI interception, one extension can observe and respond to all UI dialogs on behalf of the user.
 
-#### ui_confirm
+#### ui
 
-Fired when any code calls `ctx.ui.confirm()`. Return `{ action: "responded", confirmed }` to answer the dialog without showing it to the user. Return `undefined` to fall through to the original UI.
+Fired when any code calls `ctx.ui.confirm()`, `ctx.ui.select()`, or `ctx.ui.input()`. The `method` field distinguishes which UI call triggered the event.
 
 ```typescript
-pi.on("ui_confirm", async (event, ctx) => {
-  // event.title   - dialog title
-  // event.message - dialog message
-  // event.signal  - AbortSignal if the caller provided one
-  // event.timeout - timeout in ms if the caller provided one
+pi.on("ui", async (event, ctx) => {
+  // event.id       - unique identifier for this UI request
+  // event.method   - "confirm" | "select" | "input" | "notify"
+  // event.title    - dialog title (for notify, this is the message)
+  // event.message  - dialog message (confirm only)
+  // event.options  - string[] of options (select only)
+  // event.placeholder - placeholder text (input only)
+  // event.notifyType - "info" | "warning" | "error" (notify only)
+  // event.signal   - AbortSignal if the caller provided one
+  // event.timeout  - timeout in ms if the caller provided one
 
-  // Example: forward all confirmations to a remote service
-  const response = await fetch("https://my-server/api/confirm", {
-    method: "POST",
-    body: JSON.stringify({ title: event.title, message: event.message }),
-  });
-  const decision = await response.json();
-
-  return { action: "responded", confirmed: decision.allowed };
-});
-```
-
-**Results:**
-- `{ action: "responded", confirmed: boolean }` - answer the dialog immediately (first handler to respond wins)
-- `undefined` - pass through to the original UI implementation
-
-#### ui_select
-
-Fired when any code calls `ctx.ui.select()`. Return `{ action: "responded", value }` to provide a selection without showing the UI.
-
-```typescript
-pi.on("ui_select", async (event, ctx) => {
-  // event.title   - dialog title
-  // event.options - string[] of selectable options
-  // event.signal  - AbortSignal if provided
-  // event.timeout - timeout in ms if provided
+  // Example: intercept all confirmations and forward to a remote service
+  if (event.method === "confirm") {
+    const response = await fetch("https://my-server/api/confirm", {
+      method: "POST",
+      body: JSON.stringify({ id: event.id, title: event.title, message: event.message }),
+    });
+    const decision = await response.json();
+    return { action: "responded", confirmed: decision.allowed };
+  }
 
-  // Example: only intercept dangerous permission selects
-  if (event.title.includes("Dangerous")) {
+  // Example: intercept select dialogs with a remote decision
+  if (event.method === "select" && event.title.includes("Dangerous")) {
     const choice = await askRemote(event);
     return { action: "responded", value: choice };
   }
 
-  return undefined; // let other UI selects pass through normally
+  // Example: forward notifications to a remote service (return value is ignored for notify)
+  if (event.method === "notify") {
+    sendToRemote({ type: "notification", message: event.message, level: event.notifyType });
+    return undefined; // original notify still fires
+  }
+
+  return undefined; // pass through to the original UI
 });
 ```
 
 **Results:**
-- `{ action: "responded", value: string | undefined }` - answer the select (undefined = dismissed)
-- `undefined` - pass through to the original UI
+- `{ action: "responded", confirmed: boolean }` - answer a confirm dialog (first handler to respond wins)
+- `{ action: "responded", value: string | undefined }` - answer a select or input dialog (undefined = dismissed/cancelled)
+- `undefined` - pass through to the original UI implementation
+- For `notify`, the return value is ignored. The original `notify` always fires regardless.
 
-#### ui_input
+#### Short-circuit behavior
 
-Fired when any code calls `ctx.ui.input()`. Return `{ action: "responded", value }` to provide input text.
+The `ui` event uses first-responder semantics: the first handler to return `{ action: "responded" }` wins. Remaining handlers are not called. If no handler responds, the original UI implementation runs (TUI dialog, RPC protocol, or no-op depending on the mode).
 
-```typescript
-pi.on("ui_input", async (event, ctx) => {
-  // event.title       - dialog title
-  // event.placeholder - placeholder text if provided
-  // event.signal      - AbortSignal if provided
-  // event.timeout     - timeout in ms if provided
+If a handler throws, the error is reported via the error listener and the next handler is tried. If all handlers fail, the original UI runs as fallback.
 
-  return undefined; // pass through to normal UI
-});
-```
+#### ctx.respondUI(id, result) -- async response injection
 
-**Results:**
-- `{ action: "responded", value: string | undefined }` - provide the input (undefined = cancelled)
-- `undefined` - pass through to the original UI
+When a handler returns `undefined`, the original UI is invoked -- but the handler can also capture the `event.id` and call `ctx.respondUI(id, result)` later to inject a response asynchronously. This creates a **race** between the original UI and the async response: first one wins, the other is ignored.
 
-#### Short-circuit behavior
+```typescript
+pi.on("ui", async (event, ctx) => {
+  if (event.method === "confirm") {
+    // Forward to remote service (fire-and-forget)
+    sendToRemote({ id: event.id, message: event.message });
+    // Return undefined to let original UI also show
+    return undefined;
+  }
+});
 
-All three events use first-responder semantics: the first handler to return `{ action: "responded" }` wins. Remaining handlers are not called. If no handler responds, the original UI implementation runs (TUI dialog, RPC protocol, or no-op depending on the mode).
+// When remote responds (e.g. via channel, webhook, etc.):
+someChannel.onReceive((response) => {
+  ctx.respondUI(response.id, { action: "responded", confirmed: response.allowed });
+});
+```
 
-If a handler throws, the error is reported via the error listener and the next handler is tried. If all handlers fail, the original UI runs as fallback.
+If the user responds from the TUI first, the `respondUI` call is ignored. If the remote service responds first, the TUI dialog is cancelled. First response wins.
 
 #### Use cases
 
-- **Remote permission control** -- forward all `confirm`/`select` dialogs to a web dashboard or mobile app, hold the agent until the operator responds
+- **Remote permission control** -- forward all `confirm`/`select` dialogs to a web dashboard or mobile app, race with the local UI
 - **Audit logging** -- record all UI interactions without intercepting them (return `undefined` after logging)
 - **Headless automation** -- auto-approve or auto-deny dialogs based on rules, enabling unattended operation
 - **Custom approval workflows** -- require multiple approvers, time-based auto-approval, or integration with ticketing systems