mono-pilot 0.2.4 → 0.2.6

package/dist/src/extensions/mono-pilot.js

@@ -16,6 +16,7 @@ import switchModeExtension from "../../tools/switch-mode.js";
 import applyPatchExtension from "../../tools/apply-patch.js";
 import userMessageExtension from "./user-message.js";
 import systemPromptExtension from "./system-prompt.js";
+import sessionHintsExtension from "./session-hints.js";
 const toolExtensions = [
     shellExtension,
     globExtension,
@@ -35,6 +36,7 @@ const toolExtensions = [
     applyPatchExtension,
     userMessageExtension,
     systemPromptExtension,
+    sessionHintsExtension,
 ];
 export default function monoPilotExtension(pi) {
     for (const register of toolExtensions) {

package/dist/src/extensions/session-hints.js

@@ -0,0 +1,82 @@
+import { existsSync } from "node:fs";
+import { readdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { Text } from "@mariozechner/pi-tui";
+import { hasMessageEntries } from "./mode-runtime.js";
+const SESSION_HINTS_MESSAGE_TYPE = "SessionHints";
+const RULES_RELATIVE_DIR = join(".pi", "rules");
+/** List *.rule.txt full paths from a directory (empty array if dir missing). */
+async function listRuleFiles(dirPath) {
+    if (!existsSync(dirPath))
+        return [];
+    try {
+        const entries = await readdir(dirPath, { withFileTypes: true, encoding: "utf8" });
+        return entries
+            .filter((e) => e.isFile() && e.name.endsWith(".rule.txt"))
+            .map((e) => resolve(dirPath, e.name))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+/** Discover rules files grouped by scope. */
+async function discoverRules(cwd) {
+    const workspaceRulesDir = resolve(cwd, RULES_RELATIVE_DIR);
+    const userRulesDir = resolve(homedir(), RULES_RELATIVE_DIR);
+    const [workspaceRules, userRules] = await Promise.all([
+        listRuleFiles(workspaceRulesDir),
+        listRuleFiles(userRulesDir),
+    ]);
+    return { userRules, projectRules: workspaceRules };
+}
+function shortenHome(filePath) {
+    const home = homedir();
+    if (filePath.startsWith(home)) {
+        return `~${filePath.slice(home.length)}`;
+    }
+    return filePath;
+}
+export default function sessionHintsExtension(pi) {
+    // Render hints matching pi's native section style (same colors as [Context], [Skills], etc.)
+    pi.registerMessageRenderer(SESSION_HINTS_MESSAGE_TYPE, (message, _options, theme) => {
+        const details = message.details;
+        const lines = [];
+        const userRules = details?.userRules ?? [];
+        const projectRules = details?.projectRules ?? [];
+        if (userRules.length > 0 || projectRules.length > 0) {
+            lines.push(theme.fg("mdHeading", "[Rules]"));
+            if (userRules.length > 0) {
+                lines.push(`  ${theme.fg("accent", "user")}`);
+                for (const filePath of userRules) {
+                    lines.push(theme.fg("dim", `    ${shortenHome(filePath)}`));
+                }
+            }
+            if (projectRules.length > 0) {
+                lines.push(`  ${theme.fg("accent", "project")}`);
+                for (const filePath of projectRules) {
+                    lines.push(theme.fg("dim", `    ${shortenHome(filePath)}`));
+                }
+            }
+        }
+        if (lines.length > 0)
+            lines.push("");
+        lines.push(theme.fg("muted", "Mode switch: use ") + theme.fg("dim", "option+m") + theme.fg("muted", " to toggle Plan/Ask/Agent mode."));
+        return new Text(lines.join("\n"), 0, 0);
+    });
+    pi.on("session_start", async (_event, ctx) => {
+        if (!ctx.hasUI)
+            return;
+        const entries = ctx.sessionManager.getEntries();
+        if (hasMessageEntries(entries))
+            return;
+        const details = await discoverRules(ctx.cwd);
+        pi.sendMessage({
+            customType: SESSION_HINTS_MESSAGE_TYPE,
+            content: "",
+            display: true,
+            details,
+        }, { triggerTurn: false });
+    });
+}

package/dist/src/extensions/user-message.js

@@ -1,5 +1,6 @@
 import { existsSync } from "node:fs";
 import { readdir, readFile } from "node:fs/promises";
+import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import process from "node:process";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -138,37 +139,48 @@ async function buildMcpInstructionsEnvelope(workspaceCwd) {
 }
 async function buildRulesEnvelope(workspaceCwd) {
     const rulesDirPath = resolve(workspaceCwd, RULES_RELATIVE_DIR);
-    if (!existsSync(rulesDirPath))
-        return undefined;
-    let directoryEntries;
-    try {
-        directoryEntries = await readdir(rulesDirPath, { withFileTypes: true, encoding: "utf8" });
-    }
-    catch {
-        return undefined;
-    }
-    const ruleFileNames = directoryEntries
-        .filter((entry) => entry.isFile() && entry.name.endsWith(".rule.txt"))
-        .map((entry) => entry.name)
-        .sort((a, b) => a.localeCompare(b));
-    if (ruleFileNames.length === 0)
-        return undefined;
-    const rules = [];
-    for (const ruleFileName of ruleFileNames) {
-        const ruleFilePath = resolve(rulesDirPath, ruleFileName);
+    const userRulesDirPath = resolve(homedir(), RULES_RELATIVE_DIR);
+    const loadRulesFromDir = async (dirPath) => {
+        if (!existsSync(dirPath))
+            return new Map();
+        let directoryEntries;
         try {
-            const content = await readFile(ruleFilePath, "utf-8");
-            const normalized = content.trim();
-            if (normalized.length > 0) {
-                rules.push(normalized);
-            }
+            directoryEntries = await readdir(dirPath, { withFileTypes: true, encoding: "utf8" });
         }
         catch {
-            // Ignore unreadable rule files.
+            return new Map();
+        }
+        const ruleFileNames = directoryEntries
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".rule.txt"))
+            .map((entry) => entry.name)
+            .sort((a, b) => a.localeCompare(b));
+        const rules = new Map();
+        for (const ruleFileName of ruleFileNames) {
+            const ruleFilePath = resolve(dirPath, ruleFileName);
+            try {
+                const content = await readFile(ruleFilePath, "utf-8");
+                const normalized = content.trim();
+                if (normalized.length > 0) {
+                    rules.set(ruleFileName, normalized);
+                }
+            }
+            catch {
+                // Ignore unreadable rule files.
+            }
         }
+        return rules;
+    };
+    const userRules = await loadRulesFromDir(userRulesDirPath);
+    const workspaceRules = await loadRulesFromDir(rulesDirPath);
+    const mergedRules = new Map(userRules);
+    for (const [fileName, content] of workspaceRules) {
+        mergedRules.set(fileName, content);
     }
-    if (rules.length === 0)
+    if (mergedRules.size === 0)
         return undefined;
+    const rules = Array.from(mergedRules.entries())
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([, content]) => content);
     const lines = ["<rules>"];
     for (const rule of rules) {
         lines.push("<user_rule>");

package/dist/tools/switch-mode.js

@@ -1,7 +1,6 @@
 import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
 import { Type } from "@sinclair/typebox";
-import { createModeStateData, deriveInitialModeState, hasMessageEntries, modeRuntimeStore, MODE_STATE_ENTRY_TYPE, parseModeStateEntry, } from "../src/extensions/mode-runtime.js";
-const MODE_HINT_MESSAGE_TYPE = "Hints";
+import { createModeStateData, deriveInitialModeState, modeRuntimeStore, MODE_STATE_ENTRY_TYPE, parseModeStateEntry, } from "../src/extensions/mode-runtime.js";
 const MODE_STATUS_KEY = "mono-pilot-mode";
 const DESCRIPTION = `Switch the interaction mode to better match the current task. Each mode is optimized for a specific type of work.
 
@@ -311,13 +310,6 @@ export default function switchModeExtension(pi) {
         }
         installModeFooter(ctx);
         updateModeStatus(ctx);
-        if (ctx.hasUI && !hasMessageEntries(entries)) {
-            pi.sendMessage({
-                customType: MODE_HINT_MESSAGE_TYPE,
-                content: "Mode switch: use `option+m` to toggle Plan/Ask/Agent mode.",
-                display: true,
-            }, { triggerTurn: false });
-        }
     });
     // System prompt injection is handled centrally by system-prompt extension.
     pi.registerTool({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mono-pilot",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Cursor-compatible coding agent powered by pi-mono",
   "type": "module",
   "license": "MIT",