pi-soly 2.1.3 → 2.1.4

package/core.ts

@@ -16,6 +16,7 @@
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
+import { fileURLToPath } from "node:url";
 
 // Shared leaf utilities now live in util.ts; re-exported here so existing
 // `import { ... } from "./core.ts"` call sites keep working unchanged.
@@ -58,7 +59,8 @@ export type RuleSource =
   | "phase-soly"
   | "project-agents"
   | "global-agents"
-  | "phase-agents";
+  | "phase-agents"
+  | "built-in";
 
 export interface RuleFrontmatter {
   description?: string;
@@ -259,6 +261,40 @@ function loadRulesFromSource(spec: SourceSpec): RuleFile[] {
   return rules;
 }
 
+/**
+ * Resolve the path to the extension's `built-in-rules/` directory. Lives
+ * at `<package>/built-in-rules/` relative to the compiled module. We use
+ * `fileURLToPath(import.meta.url)` so this works whether the package is
+ * loaded directly from source (Bun, tsx) or from compiled output.
+ *
+ * `here` is the directory containing this core.ts file (i.e. the package
+ * root for source, the package root for compiled output too — both files
+ * live alongside package.json), so we don't need to traverse up.
+ */
+export function builtInRulesDir(): string {
+	const here = path.dirname(fileURLToPath(import.meta.url));
+	return path.resolve(here, "built-in-rules");
+}
+
+/**
+ * Load every markdown rule from the extension's `built-in-rules/` directory.
+ * These rules ship with the soly extension and are always present in the
+ * system prompt. Source spec uses priority=10 (highest), so a user rule at
+ * the same relPath is silently dropped into `overridden[]` — built-in
+ * rules win by design. `sourceLabel: "soly"` makes them visible in
+ * `/rules list` so users know which rules come from the package itself.
+ */
+export function loadBuiltInRules(): RuleFile[] {
+	const dir = builtInRulesDir();
+	if (!fs.existsSync(dir)) return [];
+	return loadRulesFromSource({
+		dir,
+		source: "built-in",
+		sourceLabel: "soly",
+		priority: 10,
+	});
+}
+
 export function loadAllRules(sources: SourceSpec[]): {
   rules: RuleFile[];
   overridden: string[];

package/index.ts

@@ -34,6 +34,8 @@ import {
 	extractFilePathsFromPrompt,
 	formatTok,
 	loadAllRules,
+	builtInRulesDir,
+	loadBuiltInRules,
 	loadPhaseRules,
 	loadProjectState,
 	matchesGlob,
@@ -441,10 +443,14 @@ export default function solyExtension(pi: ExtensionAPI) {
 		// Project rules always beat global rules. `.agents/rules.local/` is
 		// gitignored — for personal overrides on top of the project's rules.
 		// `.agents/rules/` is the vendor-neutral project-level convention.
+		// Built-in rules ship with the extension (priority=10 — highest) and
+		// can't be overridden: a user rule at the same relPath is dropped
+		// silently into the `overridden[]` list (see loadAllRules).
 		ruleSources = [
-			{ dir: path.join(ctx.cwd, ".agents", "rules.local"), source: "project-agents", sourceLabel: "local", priority: 5 },
-			{ dir: path.join(ctx.cwd, ".agents", "rules"), source: "project-agents", sourceLabel: "agents", priority: 3 },
+			{ dir: builtInRulesDir(), source: "built-in", sourceLabel: "soly", priority: 10 },
 			{ dir: path.join(os.homedir(), ".agents", "rules"), source: "global-agents", sourceLabel: "agents", priority: 1 },
+			{ dir: path.join(ctx.cwd, ".agents", "rules"), source: "project-agents", sourceLabel: "agents", priority: 3 },
+			{ dir: path.join(ctx.cwd, ".agents", "rules.local"), source: "project-agents", sourceLabel: "local", priority: 5 },
 		];
 		refreshRules();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-soly",
-  "version": "2.1.3",
+  "version": "2.1.4",
   "description": "Project management + workflow framework for pi-coding-agent. Plans, state, MANDATORY rules, self-review, multi-question picker, native footer + welcome chrome — one npm install, zero config. The LLM drives the workflow inline via the soly_workflow tool — no external subagent plugin.",
   "type": "module",
   "main": "index.ts",