guardian-framework 0.1.2 → 0.1.4

package/README.md

@@ -97,13 +97,6 @@ npx guardian-framework init
 npm install -g guardian-framework
 ```
 
-**Pi package** — load extensions, skills, and prompts directly into a [pi](https://github.com/badlogic/pi-mono) session:
-
-```bash
-pi install npm:guardian-framework
-```
-
-This makes all Guardian slash commands (`/architect`, `/pipeline`, `/goal`, `/domain`, etc.) available inside pi without running `guardian init` first. Run `/guardian-status` after install to check availability.
 
 **Prerequisites:** [Bun](https://bun.sh) >= 1.0.0
 

package/dist/cli.js

@@ -1335,7 +1335,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.2", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
+var name = "guardian-framework", version = "0.1.4", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
 var init_package = __esm(() => {
   exports = {
     ".": {
@@ -1346,7 +1346,11 @@ var init_package = __esm(() => {
   bin = {
     "guardian-framework": "./dist/cli.js"
   };
-  files = ["dist/", "templates/", "pi-package/"];
+  files = [
+    "dist/",
+    "templates/",
+    "pi-package/"
+  ];
   engines = {
     bun: ">=1.0.0"
   };
@@ -1364,9 +1368,15 @@ var init_package = __esm(() => {
     access: "public"
   };
   pi = {
-    extensions: ["./pi-package/extensions"],
-    skills: ["./pi-package/skills"],
-    prompts: ["./pi-package/prompts"]
+    extensions: [
+      "./pi-package/extensions"
+    ],
+    skills: [
+      "./pi-package/skills"
+    ],
+    prompts: [
+      "./pi-package/prompts"
+    ]
   };
   repository = {
     type: "git",
@@ -11393,17 +11403,6 @@ function scaffoldPiDirectory(piDir, context, scaffoldedFiles) {
   } else {
     errors.push(`INDEX.md: ${indexResult.error.message}`);
   }
-  const readmePath = path9.join(piDir, "README.md");
-  const readmeResult = readTemplate("README.md");
-  if (readmeResult.ok) {
-    fs11.writeFileSync(readmePath, readmeResult.value, "utf-8");
-    scaffoldedFiles[`${PI_DIR}/README.md`] = {
-      category: "framework",
-      content: readmeResult.value
-    };
-  } else {
-    errors.push(`README.md: ${readmeResult.error.message}`);
-  }
   return errors;
 }
 function shouldSkipFile(relativePath, language) {

package/dist/exports.js

@@ -995,7 +995,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.2", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
+var name = "guardian-framework", version = "0.1.4", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
 var init_package = __esm(() => {
   exports = {
     ".": {
@@ -1006,7 +1006,11 @@ var init_package = __esm(() => {
   bin = {
     "guardian-framework": "./dist/cli.js"
   };
-  files = ["dist/", "templates/", "pi-package/"];
+  files = [
+    "dist/",
+    "templates/",
+    "pi-package/"
+  ];
   engines = {
     bun: ">=1.0.0"
   };
@@ -1024,9 +1028,15 @@ var init_package = __esm(() => {
     access: "public"
   };
   pi = {
-    extensions: ["./pi-package/extensions"],
-    skills: ["./pi-package/skills"],
-    prompts: ["./pi-package/prompts"]
+    extensions: [
+      "./pi-package/extensions"
+    ],
+    skills: [
+      "./pi-package/skills"
+    ],
+    prompts: [
+      "./pi-package/prompts"
+    ]
   };
   repository = {
     type: "git",
@@ -10156,17 +10166,6 @@ function scaffoldPiDirectory(piDir, context, scaffoldedFiles) {
   } else {
     errors.push(`INDEX.md: ${indexResult.error.message}`);
   }
-  const readmePath = path6.join(piDir, "README.md");
-  const readmeResult = readTemplate("README.md");
-  if (readmeResult.ok) {
-    fs7.writeFileSync(readmePath, readmeResult.value, "utf-8");
-    scaffoldedFiles[`${PI_DIR}/README.md`] = {
-      category: "framework",
-      content: readmeResult.value
-    };
-  } else {
-    errors.push(`README.md: ${readmeResult.error.message}`);
-  }
   return errors;
 }
 function shouldSkipFile(relativePath, language) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.2",
+	"version": "0.1.4",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",
@@ -14,7 +14,11 @@
 	"bin": {
 		"guardian-framework": "./dist/cli.js"
 	},
-	"files": ["dist/", "templates/", "pi-package/"],
+	"files": [
+		"dist/",
+		"templates/",
+		"pi-package/"
+	],
 	"engines": {
 		"bun": ">=1.0.0"
 	},
@@ -32,9 +36,15 @@
 		"access": "public"
 	},
 	"pi": {
-		"extensions": ["./pi-package/extensions"],
-		"skills": ["./pi-package/skills"],
-		"prompts": ["./pi-package/prompts"]
+		"extensions": [
+			"./pi-package/extensions"
+		],
+		"skills": [
+			"./pi-package/skills"
+		],
+		"prompts": [
+			"./pi-package/prompts"
+		]
 	},
 	"repository": {
 		"type": "git",

package/templates/pi/extensions/architect-lib/helpers.ts

@@ -224,12 +224,28 @@ export function readGroupId(cwd: string): string {
 export function findModuleByName(cwd: string, name: string): string | null {
     const files = discoverModules(cwd);
     const nameLower = name.toLowerCase().replace(/[^a-z0-9]/g, "");
+
+    // Pass 1: exact match only (preferred)
     for (const f of files) {
         const key = f.replace(".md", "").toLowerCase().replace(/[^a-z0-9]/g, "");
-        if (key === nameLower || nameLower.includes(key) || key.includes(nameLower)) {
+        if (key === nameLower) {
             return f;
         }
     }
+
+    // Pass 2: substring match — only if unambiguous (exactly one match)
+    const substringMatches: string[] = [];
+    for (const f of files) {
+        const key = f.replace(".md", "").toLowerCase().replace(/[^a-z0-9]/g, "");
+        if (nameLower.includes(key) || key.includes(nameLower)) {
+            substringMatches.push(f);
+        }
+    }
+    if (substringMatches.length === 1) {
+        return substringMatches[0];
+    }
+
+    // Ambiguous or no match — let caller decide
     return null;
 }
 

package/templates/pi/extensions/architect.ts

@@ -308,12 +308,28 @@ function readGroupId(cwd: string): string {
 function findModuleByName(cwd: string, name: string): string | null {
     const files = discoverModules(cwd);
     const nameLower = name.toLowerCase().replace(/[^a-z0-9]/g, "");
+
+    // Pass 1: exact match only (preferred)
     for (const f of files) {
         const key = f.replace(".md", "").toLowerCase().replace(/[^a-z0-9]/g, "");
-        if (key === nameLower || nameLower.includes(key) || key.includes(nameLower)) {
+        if (key === nameLower) {
             return f;
         }
     }
+
+    // Pass 2: substring match — only if unambiguous (exactly one match)
+    const substringMatches: string[] = [];
+    for (const f of files) {
+        const key = f.replace(".md", "").toLowerCase().replace(/[^a-z0-9]/g, "");
+        if (nameLower.includes(key) || key.includes(nameLower)) {
+            substringMatches.push(f);
+        }
+    }
+    if (substringMatches.length === 1) {
+        return substringMatches[0];
+    }
+
+    // Ambiguous or no match — let caller decide
     return null;
 }
 
@@ -1021,10 +1037,21 @@ class EpicManager {
 			const planned = components.filter((c: ModuleComponent) => c.status === "planned");
 			if (planned.length > 0) {
 				slice = { module: matchedModule.replace(".md", ""), components, nextLogicalSlice: planned };
+			} else {
+				ctx.ui.notify(
+					`Module "${matchedModule}" found for epic "${name}" but has no parseable components. ` +
+					`Make sure its \`## Components\` section uses sub-headings (\`### ComponentName\`) with \`status:\` markers. ` +
+					`Falling back to first module with planned components.`,
+					"warn",
+				);
 			}
 		}
 		// Fallback: first module with planned components
 		if (!slice) {
+			ctx.ui.notify(
+				`No exact module match with planned components for "${name}". Using first available module instead.`,
+				"warn",
+			);
 			slice = findNextLogicalSlice(this.cwd, moduleFiles);
 		}
 		if (!slice) {

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-01T06:41:46Z",
+  "timestamp": "2026-07-02T18:42:54Z",
   "mode": "all",
   "stages_run": [],
   "summary": {