guardian-framework 0.1.132 → 0.1.134

package/dist/cli.js

@@ -3078,7 +3078,11 @@ function categorizeFile(relativePath) {
     "agent/AGENTS.md",
     "domain/",
     "architecture/CHANGELOG.md",
-    "architecture/implementation-roadmap.md"
+    "architecture/implementation-roadmap.md",
+    "architecture/diagrams/",
+    "architecture/modules/",
+    "architecture/decisions/",
+    "architecture/contracts/"
   ];
   if (userEditable.some((p3) => relativePath.includes(p3))) {
     return "user";
@@ -3202,7 +3206,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.134", 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 = {
     ".": {
@@ -11085,6 +11089,12 @@ async function runUpdate(targetDir, options) {
     outro(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
   }
 }
+function isUserOwnedPiPath(manifestPath) {
+  const p3 = manifestPath.replace(/^\.pi\//, "").toLowerCase();
+  if (p3.includes("template"))
+    return false;
+  return p3.startsWith("architecture/diagrams/") || p3.startsWith("architecture/modules/") || p3.startsWith("architecture/decisions/") || p3.startsWith("architecture/contracts/") || p3.startsWith("architecture/architecture-overview.md") || p3.startsWith("domain/exploration.md") || p3.startsWith("domain/exploration/") || p3.startsWith("domain/ubiquitous-language.md");
+}
 function analyzeChanges(targetDir, manifest, templateFiles, context, options) {
   const changes = [];
   const templatePaths = new Set(templateFiles);
@@ -11092,6 +11102,14 @@ function analyzeChanges(targetDir, manifest, templateFiles, context, options) {
     if (!filePath.startsWith(".pi/"))
       continue;
     const fullPath = path9.join(targetDir, filePath);
+    if (isUserOwnedPiPath(filePath)) {
+      changes.push({
+        path: filePath,
+        action: "preserve",
+        reason: "Project-owned architecture content \u2014 never overwritten by update"
+      });
+      continue;
+    }
     if (!templatePaths.has(filePath.replace(".pi/", ""))) {
       changes.push({
         path: filePath,
@@ -11148,6 +11166,15 @@ function analyzeChanges(targetDir, manifest, templateFiles, context, options) {
   for (const relativePath of templateFiles) {
     const manifestPath = `.pi/${relativePath}`;
     if (!manifest.files[manifestPath]) {
+      const existing = path9.join(targetDir, manifestPath);
+      if (fs10.existsSync(existing) && isUserOwnedPiPath(manifestPath)) {
+        changes.push({
+          path: manifestPath,
+          action: "preserve",
+          reason: "Project-owned content already exists"
+        });
+        continue;
+      }
       changes.push({ path: manifestPath, action: "add", reason: "New template file" });
     }
   }
@@ -12838,6 +12865,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

@@ -1898,7 +1898,11 @@ function categorizeFile(relativePath) {
     "agent/AGENTS.md",
     "domain/",
     "architecture/CHANGELOG.md",
-    "architecture/implementation-roadmap.md"
+    "architecture/implementation-roadmap.md",
+    "architecture/diagrams/",
+    "architecture/modules/",
+    "architecture/decisions/",
+    "architecture/contracts/"
   ];
   if (userEditable.some((p2) => relativePath.includes(p2))) {
     return "user";
@@ -1987,7 +1991,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.134", 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 = {
     ".": {
@@ -10209,6 +10213,12 @@ async function runUpdate(targetDir, options) {
     outro(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
   }
 }
+function isUserOwnedPiPath(manifestPath) {
+  const p2 = manifestPath.replace(/^\.pi\//, "").toLowerCase();
+  if (p2.includes("template"))
+    return false;
+  return p2.startsWith("architecture/diagrams/") || p2.startsWith("architecture/modules/") || p2.startsWith("architecture/decisions/") || p2.startsWith("architecture/contracts/") || p2.startsWith("architecture/architecture-overview.md") || p2.startsWith("domain/exploration.md") || p2.startsWith("domain/exploration/") || p2.startsWith("domain/ubiquitous-language.md");
+}
 function analyzeChanges(targetDir, manifest, templateFiles, context, options) {
   const changes = [];
   const templatePaths = new Set(templateFiles);
@@ -10216,6 +10226,14 @@ function analyzeChanges(targetDir, manifest, templateFiles, context, options) {
     if (!filePath.startsWith(".pi/"))
       continue;
     const fullPath = path5.join(targetDir, filePath);
+    if (isUserOwnedPiPath(filePath)) {
+      changes.push({
+        path: filePath,
+        action: "preserve",
+        reason: "Project-owned architecture content — never overwritten by update"
+      });
+      continue;
+    }
     if (!templatePaths.has(filePath.replace(".pi/", ""))) {
       changes.push({
         path: filePath,
@@ -10272,6 +10290,15 @@ function analyzeChanges(targetDir, manifest, templateFiles, context, options) {
   for (const relativePath of templateFiles) {
     const manifestPath = `.pi/${relativePath}`;
     if (!manifest.files[manifestPath]) {
+      const existing = path5.join(targetDir, manifestPath);
+      if (fs6.existsSync(existing) && isUserOwnedPiPath(manifestPath)) {
+        changes.push({
+          path: manifestPath,
+          action: "preserve",
+          reason: "Project-owned content already exists"
+        });
+        continue;
+      }
       changes.push({ path: manifestPath, action: "add", reason: "New template file" });
     }
   }
@@ -13162,6 +13189,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.134",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

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,105 @@ export default function (pi: ExtensionAPI) {
 					checks.push(content.includes("## Ubiquitous Language") ? "  PASS Ubiquitous language section" : "  FAIL Missing ubiquitous language section");
 				}
 
+								// Application-services drift gate (root cause: use-cases stopped at the
+				// exploration layer). Every catalog service must be present in its module
+				// doc's Application Layer catalog block; Implemented rows must resolve to a
+				// real seam class in src; Planned/Seam rows must carry a roadmap/phase
+				// pointer. Catches doc gaps (e.g. evidence-export had no catalog block) and
+				// paper claims (doc says Implemented, code has no such seam).
+				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");
+							const typeExists = (typeName: string): boolean => {
+								const srcBase = path.join(ctx.cwd, "src");
+								if (!fs.existsSync(srcBase)) return false;
+								const target = typeName.replace(/[^A-Za-z0-9_]/g, "");
+								let found = false;
+								const walk = (dir: string, dep: number): void => {
+									if (found || dep > 9) return;
+									let entries;
+									try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+									for (const e of entries) {
+										if (e.name === "node_modules" || e.name === "target" || e.name === ".git" || e.name === "dist") continue;
+										const full = path.join(dir, e.name);
+										if (e.isFile() && (e.name === target + ".java" || e.name === target + ".kt" || e.name === target + ".ts")) { found = true; return; }
+										if (e.isDirectory()) walk(full, dep + 1);
+									}
+								};
+								walk(srcBase, 0);
+								return found;
+							};
+							const ctxNames = new Map<string, string>(); // norm(ctx) -> ctx
+							const svcByCtx = new Map<string, string[]>();
+							for (const sv of svcV) {
+								const ctx = String(sv.context ?? ""); const nm = String(sv.name ?? "");
+								if (!ctx || !nm) continue;
+								ctxNames.set(norm(ctx), ctx);
+								const arr = svcByCtx.get(ctx) ?? [];
+								arr.push(nm); svcByCtx.set(ctx, arr);
+							}
+							let issues = 0;
+							for (const [normCtx, ctx] of ctxNames) {
+								const docFile = vModules.find((f) => norm(f.replace(/\.md$/, "")) === normCtx) ?? "";
+								if (!docFile) {
+									checks.push("  FAIL Module doc not found for context " + ctx + " (has " + svcByCtx.get(ctx)!.length + " catalog services)");
+									issues++; continue;
+								}
+								const docText = fs.readFileSync(path.join(modulesDir, docFile), "utf-8");
+								const catNames = svcByCtx.get(ctx)!;
+								let miss = 0;
+								for (const nm of catNames) if (!docText.includes(nm)) miss++;
+								if (miss > 0) { checks.push("  FAIL " + docFile + " missing " + miss + " catalog service name(s): " + catNames.filter((n) => !docText.includes(n)).join(", ")); issues += miss; }
+								if (!docText.includes("Service (canonical)")) {
+									checks.push("  FAIL " + docFile + " has no Application Layer catalog block (header 'Service (canonical)') for " + catNames.length + " catalog services");
+									issues++;
+								}
+								// Parse catalog table rows: | `Service` | use case | fr | Status | Delivered by |
+								const block = docText.slice(docText.indexOf("### Application Layer") >= 0 ? docText.indexOf("### Application Layer") : 0);
+								for (const line of block.split("\n")) {
+									if (!line.trim().startsWith("|")) continue;
+									const cells = line.split("|").map((c) => c.trim());
+									if (cells.length < 6) continue;
+									const svcName = cells[1].replace(/^`|`$/g, "");
+									if (!catNames.includes(svcName)) continue; // catalog row only
+									const statusCell = cells[4] + " " + cells[5];
+									const seamCell = cells[5];
+									if (/implemented/i.test(statusCell) && !/planned|seam/i.test(statusCell)) {
+										const seamTokens = Array.from(seamCell.matchAll(/`([A-Za-z0-9_]+)`/g)).map((m) => m[1]);
+										if (seamTokens.length === 0 && !/[A-Z][A-Za-z0-9_]+/.test(seamCell)) {
+											checks.push("  FAIL " + docFile + ": Implemented catalog service " + svcName + " has no seam class named in the doc");
+											issues++;
+										} else {
+											for (const tk of seamTokens.length > 0 ? seamTokens : seamCell.match(/[A-Z][A-Za-z0-9_]+/g) ?? []) {
+												if (!typeExists(tk)) {
+													checks.push("  FAIL " + docFile + ": Implemented service " + svcName + " names seam " + tk + " but no such type exists in src");
+													issues++;
+												}
+											}
+										}
+									} else if (/planned|seam/i.test(statusCell)) {
+										if (!/phase|roadmap|later|projection|pending|seam|intake|console|partial|deterministic/i.test(statusCell)) {
+											checks.push("  FAIL " + docFile + ": catalog service " + svcName + " is Planned/Seam without a roadmap/phase pointer");
+											issues++;
+										}
+									}
+								}
+							}
+							checks.push(issues === 0
+								? "  PASS Catalog blocks + seams verified for all " + svcV.length + " application services"
+								: "  FAIL " + issues + " catalog/seam issue(s)");
+							if (issues > 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-07T07:52:39Z",
   "mode": "all",
   "stages_run": [],
   "summary": {