guardian-framework 0.1.133 → 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.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 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 = {
     ".": {
@@ -3213,10 +3217,7 @@ var init_package = __esm(() => {
   bin = {
     "guardian-framework": "dist/cli.js"
   };
-  files = [
-    "dist/",
-    "templates/"
-  ];
+  files = ["dist/", "templates/"];
   engines = {
     bun: ">=1.0.0"
   };
@@ -3234,15 +3235,9 @@ 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",
@@ -11094,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);
@@ -11101,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,
@@ -11157,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" });
     }
   }

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.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 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 = {
     ".": {
@@ -1998,10 +2002,7 @@ var init_package = __esm(() => {
   bin = {
     "guardian-framework": "dist/cli.js"
   };
-  files = [
-    "dist/",
-    "templates/"
-  ];
+  files = ["dist/", "templates/"];
   engines = {
     bun: ">=1.0.0"
   };
@@ -2019,15 +2020,9 @@ 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",
@@ -10218,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);
@@ -10225,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,
@@ -10281,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" });
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.133",
+	"version": "0.1.134",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",
@@ -14,10 +14,7 @@
 	"bin": {
 		"guardian-framework": "dist/cli.js"
 	},
-	"files": [
-		"dist/",
-		"templates/"
-	],
+	"files": ["dist/", "templates/"],
 	"engines": {
 		"bun": ">=1.0.0"
 	},
@@ -35,15 +32,9 @@
 		"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

@@ -1761,9 +1761,12 @@ 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.
+								// 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 {
@@ -1771,29 +1774,92 @@ export default function (pi: ExtensionAPI) {
 						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;
+							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 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 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");
-								if (!docText.includes(svcName)) {
-									checks.push("  FAIL Module doc " + docFile + " is missing catalog service " + svcName + " (from exploration use-cases)");
-									missingV++;
+								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(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;
+							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-06T18:38:35Z",
+  "timestamp": "2026-09-07T07:52:39Z",
   "mode": "all",
   "stages_run": [],
   "summary": {