guardian-framework 0.1.132 → 0.1.133

package/dist/cli.js

@@ -3202,7 +3202,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.132", 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.133", 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 = {
     ".": {
@@ -3213,7 +3213,10 @@ var init_package = __esm(() => {
   bin = {
     "guardian-framework": "dist/cli.js"
   };
-  files = ["dist/", "templates/"];
+  files = [
+    "dist/",
+    "templates/"
+  ];
   engines = {
     bun: ">=1.0.0"
   };
@@ -3231,9 +3234,15 @@ var init_package = __esm(() => {
     access: "public"
   };
   pi = {
-    extensions: ["./templates/pi/extensions"],
-    skills: ["./templates/pi/skills"],
-    prompts: ["./templates/pi/prompts"]
+    extensions: [
+      "./templates/pi/extensions"
+    ],
+    skills: [
+      "./templates/pi/skills"
+    ],
+    prompts: [
+      "./templates/pi/prompts"
+    ]
   };
   repository = {
     type: "git",
@@ -12838,6 +12847,27 @@ ${bc.description}
       }
       content += `
 `;
+      content += `## Application Services (from exploration use-cases)
+`;
+      content += `
+`;
+      const ctxServices = (sessionResult.applicationServices ?? []).filter((svc) => svc.context === bc.name);
+      if (ctxServices.length === 0) {
+        content += `None captured in exploration yet (run the use-cases pass).
+
+`;
+      } else {
+        content += `| Service | Use case | Maps to FR |
+`;
+        content += `|---------|----------|-----------|
+`;
+        for (const svc of ctxServices) {
+          content += `| \`${svc.name}\` | ${svc.useCase ?? "\u2014"} | ${svc.mapsToFr ?? "\u2014"} |
+`;
+        }
+        content += `
+`;
+      }
       content += `## Ubiquitous Language
 `;
       content += `

package/dist/exports.js

@@ -1987,7 +1987,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.132", 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.133", 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 = {
     ".": {
@@ -1998,7 +1998,10 @@ var init_package = __esm(() => {
   bin = {
     "guardian-framework": "dist/cli.js"
   };
-  files = ["dist/", "templates/"];
+  files = [
+    "dist/",
+    "templates/"
+  ];
   engines = {
     bun: ">=1.0.0"
   };
@@ -2016,9 +2019,15 @@ var init_package = __esm(() => {
     access: "public"
   };
   pi = {
-    extensions: ["./templates/pi/extensions"],
-    skills: ["./templates/pi/skills"],
-    prompts: ["./templates/pi/prompts"]
+    extensions: [
+      "./templates/pi/extensions"
+    ],
+    skills: [
+      "./templates/pi/skills"
+    ],
+    prompts: [
+      "./templates/pi/prompts"
+    ]
   };
   repository = {
     type: "git",
@@ -13162,6 +13171,27 @@ ${bc.description}
       }
       content += `
 `;
+      content += `## Application Services (from exploration use-cases)
+`;
+      content += `
+`;
+      const ctxServices = (sessionResult.applicationServices ?? []).filter((svc) => svc.context === bc.name);
+      if (ctxServices.length === 0) {
+        content += `None captured in exploration yet (run the use-cases pass).
+
+`;
+      } else {
+        content += `| Service | Use case | Maps to FR |
+`;
+        content += `|---------|----------|-----------|
+`;
+        for (const svc of ctxServices) {
+          content += `| \`${svc.name}\` | ${svc.useCase ?? "—"} | ${svc.mapsToFr ?? "—"} |
+`;
+        }
+        content += `
+`;
+      }
       content += `## Ubiquitous Language
 `;
       content += `

package/package.json

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

package/templates/pi/extensions/domain-explorer.ts

@@ -1550,12 +1550,46 @@ export default function (pi: ExtensionAPI) {
 				ctx.ui.notify("Enriching " + moduleFiles.length + " module docs from session " + sessionId, "info");
 				const lang = readLanguage(ctx.cwd);
 
+				let servicesCatalog = "(no catalog available)";
+				try {
+					const svcRaw = JSON.parse(fs.readFileSync(sRawPath, "utf-8")) as Record<string, unknown>;
+					const svcAll = Array.isArray(svcRaw.applicationServices) ? (svcRaw.applicationServices as Record<string, unknown>[]) : [];
+					const svcBcs = Array.isArray(svcRaw.boundedContexts) ? (svcRaw.boundedContexts as Record<string, unknown>[]) : [];
+					const ctxFor = (file: string): string => {
+						const wanted = norm(file.replace(/\.md$/, ""));
+						const bc = svcBcs.find((b) => norm(String(b.name ?? "")) === wanted);
+						return bc ? String(bc.name ?? "") : "";
+					};
+					const chunks = moduleFiles.map((f) => {
+						const ctx = ctxFor(f);
+						const svcs = svcAll.filter((sv) => String(sv.context ?? "") === ctx);
+						if (!ctx || svcs.length === 0) return "";
+						const lines = svcs.map((sv) => {
+							const extra = [String(sv.useCase ?? ""), sv.mapsToFr ? "mapsToFr: " + String(sv.mapsToFr) : ""]
+								.filter(Boolean).join(" — ");
+							return `- \u0060${String(sv.name ?? "")}\u0060 : ${extra}`;
+						});
+						return "### " + ctx + "  (module doc: " + f + ")\n" + lines.join("\n");
+					}).filter(Boolean);
+					if (chunks.length > 0) servicesCatalog = chunks.join("\n\n");
+				} catch { /* leave fallback text */ }
+
 				const enrichPrompt = [
 					"## Task: Complete Architecture Package",
 					"",
 					"The scaffold generated basic stubs. Your task is to produce a **complete, interconnected architecture package**",
 					"that an implementation agent can build from.",
 					"",
+					"### Application-services catalog (AUTHORITATIVE — from the exploration use-cases pass)",
+					"",
+					"The Application Layer section of EVERY module doc you enrich must list exactly these",
+					"application services for that module's bounded context — EXACT names, use-case, and",
+					"FR mapping. Do NOT rename, drop, or substitute services, and do not invent services",
+					"that replace them. Extra controllers/adapters/query helpers may be added BELOW the",
+					"catalog, but every catalog entry must appear verbatim:",
+					"",
+					servicesCatalog,
+					"",
 					"**YOU MUST FOLLOW THESE 3 STEPS IN ORDER. Do not skip steps or reorder them.**",
 					"",
 					"### Source Data",
@@ -1711,6 +1745,8 @@ export default function (pi: ExtensionAPI) {
 
 				const explorationDir = path.join(ctx.cwd, ".pi", "domain", "exploration");
 				const sessionPath = path.join(explorationDir, sessionId + ".md");
+				const modulesDir = path.join(ctx.cwd, ".pi", "architecture", "modules");
+				const norm = (n: string) => n.toLowerCase().replace(/[^a-z0-9]/g, "");
 				const checks: string[] = [];
 				let allPassed = true;
 
@@ -1725,6 +1761,39 @@ export default function (pi: ExtensionAPI) {
 					checks.push(content.includes("## Ubiquitous Language") ? "  PASS Ubiquitous language section" : "  FAIL Missing ubiquitous language section");
 				}
 
+				// Application-services drift gate: every catalog service (use-cases pass)
+				// must appear in its module doc so exploration -> architecture ->
+				// implementation never silently drops a use case.
+				const rawVPath = sessionPath.replace(/\.md$/, ".raw.json");
+				if (fs.existsSync(rawVPath)) {
+					try {
+						const rawV = JSON.parse(fs.readFileSync(rawVPath, "utf-8")) as Record<string, unknown>;
+						const svcV = Array.isArray(rawV.applicationServices) ? (rawV.applicationServices as Record<string, unknown>[]) : [];
+						if (svcV.length > 0) {
+							const vModules = fs.readdirSync(modulesDir).filter((f) => f.endsWith(".md") && f !== "module-template.md");
+							let missingV = 0;
+							for (const sv of svcV) {
+								const ctx = String(sv.context ?? "");
+								const svcName = String(sv.name ?? "");
+								if (!ctx || !svcName) continue;
+								const docFile = vModules.find((f) => norm(f.replace(/\.md$/, "")) === norm(ctx)) ?? "";
+								if (!docFile) { checks.push("  FAIL Module doc not found for context " + ctx + " (service " + svcName + ")"); missingV++; continue; }
+								const docText = fs.readFileSync(path.join(modulesDir, docFile), "utf-8");
+								if (!docText.includes(svcName)) {
+									checks.push("  FAIL Module doc " + docFile + " is missing catalog service " + svcName + " (from exploration use-cases)");
+									missingV++;
+								}
+							}
+							checks.push(missingV === 0
+								? "  PASS All " + svcV.length + " catalog application services present in module docs"
+								: "  FAIL " + missingV + " catalog application service(s) missing from module docs");
+							if (missingV > 0) allPassed = false;
+						} else {
+							checks.push("  PASS No application services in session (use-cases pass not run)");
+						}
+					} catch { /* ignore */ }
+				}
+
 				const header = allPassed ? "Domain Validation - All Checks Passed" : "Domain Validation - Some Checks Failed";
 				ctx.ui.notify(header, allPassed ? "success" : "error");
 

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-06T15:49:30Z",
+  "timestamp": "2026-09-06T18:38:35Z",
   "mode": "all",
   "stages_run": [],
   "summary": {