guardian-framework 0.1.3 → 0.1.5

package/dist/cli.js

@@ -1335,7 +1335,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.3", 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.5", 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 = {
     ".": {

package/dist/exports.js

@@ -995,7 +995,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.3", 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.5", 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 = {
     ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.3",
+	"version": "0.1.5",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

package/templates/pi/agent/AGENTS.md

@@ -76,6 +76,7 @@ delegation:
 3. **Architecture traceability** — Every implementation file must reference its architecture source in `.pi/architecture/modules/`.
 4. **DRY context** — Shared knowledge lives in `.pi/context/`, not scattered across agent files.
 5. **Shift-left validation** — Plans are validated before code is written.
+6. **Auto-advance pipeline** — After completing a step, immediately call `pipeline_advance` to move to the next step/item. Do NOT ask the user for permission — just advance and continue.
 
 ## Commands
 

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-02T16:34:18Z",
+  "timestamp": "2026-07-02T18:56:48Z",
   "mode": "all",
   "stages_run": [],
   "summary": {
@@ -8,7 +8,7 @@
     "failed": 1,
     "skipped": 12
   },
-  "duration_seconds": 1,
+  "duration_seconds": 0,
   "results": [
   {
     "name": "check_mr_traceability.sh",

package/templates/pi/prompts/issue-template-set.md

@@ -17,6 +17,7 @@ Every issue must contain:
 - **Canonical references** — Architecture module + ADR paths
 - **Files/layers affected** — domain, application, infrastructure, api
 - **Rollout or operational notes** — When relevant
+- **Auto-advance pipeline** — After completing a step, call `pipeline_advance` immediately. Do NOT ask the user for permission.
 
 ---
 

package/templates/pi/prompts/issue-template.md

@@ -184,6 +184,7 @@ No internal dependencies. This is a root component.
 
 > **Agent:** Load this file as your complete session context. All information you need is above.
 > Start by reading the canonical reference files, then implement following the layer structure.
+> **Auto-advance:** After completing each pipeline step, call `pipeline_advance` immediately — do NOT ask the user for permission.
 
 ### Steps