guardian-framework 0.1.131 → 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.131", 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.131", 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.131",
+	"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

@@ -1490,14 +1490,32 @@ export default function (pi: ExtensionAPI) {
 				// session's bounded contexts may be touched, and existing module docs
 				// are preserved unless --force. Prevents clobbering other streams.
 				const allModules = fs.readdirSync(modulesDir).filter(f => f.endsWith(".md") && f !== "module-template.md");
-				const kebab = (n: string) => n.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+				// Match a bounded-context name to its module doc by NORMALIZED name
+				// (ignoring case and all separators) — camelCase contexts ("IntentCapture")
+				// scaffold to hyphenated files ("intent-capture.md"); naive kebab of a
+				// camelCase name yields "intentcapture.md" and matches nothing.
+				const norm = (n: string) => n.toLowerCase().replace(/[^a-z0-9]/g, "");
+				const moduleFileFor = (name: string): string => {
+					const wanted = norm(name);
+					const hit = allModules.find((f) => norm(f.replace(/\.md$/, "")) === wanted);
+					if (hit) return hit;
+					const kebabbed = name.trim().replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+						.replace(/[\s_]+/g, "-").toLowerCase().replace(/[^a-z0-9-]+/g, "").replace(/-+/g, "-").replace(/(^-|-$)/g, "");
+					return kebabbed ? kebabbed + ".md" : "";
+				};
 				let sessionModules: string[] = [];
+				const seenFiles = new Set<string>();
+				const addModule = (n: string) => {
+					if (!n) return;
+					const f = moduleFileFor(n);
+					if (f && !seenFiles.has(f)) { seenFiles.add(f); sessionModules.push(f); }
+				};
 				const sRawPath = path.join(explorationDir, sessionId + ".raw.json");
 				if (fs.existsSync(sRawPath)) {
 					try {
 						const rawS = JSON.parse(fs.readFileSync(sRawPath, "utf-8")) as Record<string, unknown>;
 						const bcs = Array.isArray(rawS.boundedContexts) ? (rawS.boundedContexts as Record<string, unknown>[]) : [];
-						sessionModules = bcs.map((bc) => kebab(String(bc.name ?? "")) + ".md").filter((n) => allModules.includes(n));
+						for (const bc of bcs) addModule(String(bc.name ?? ""));
 					} catch { /* ignore */ }
 				}
 				if (sessionModules.length === 0) {
@@ -1505,11 +1523,10 @@ export default function (pi: ExtensionAPI) {
 					const md = fs.existsSync(sessionPath) ? fs.readFileSync(sessionPath, "utf-8") : "";
 					const m = md.match(/## Bounded Contexts[\s\S]*?\n((?:\|.*\n)+?)(?=\n##|$)/);
 					if (m) {
-						sessionModules = m[1].split("\n")
-							.map((l) => l.split("|").map((c) => c.trim()).filter(Boolean)[0])
-							.filter(Boolean)
-							.map((n) => kebab(n) + ".md")
-							.filter((n) => allModules.includes(n));
+						for (const line of m[1].split("\n")) {
+							const cell = line.split("|").map((c) => c.trim()).filter(Boolean)[0];
+							if (cell) addModule(cell);
+						}
 					}
 				}
 				const preserved: string[] = [];
@@ -1533,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",
@@ -1694,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;
 
@@ -1708,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:38:53Z",
+  "timestamp": "2026-09-06T18:38:35Z",
   "mode": "all",
   "stages_run": [],
   "summary": {