guardian-framework 0.1.128 → 0.1.129

package/dist/cli.js

@@ -3202,7 +3202,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.128", 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.129", 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 = {
     ".": {
@@ -12178,6 +12178,60 @@ function answerExploration(sessionId, responseJson, options) {
     warnings
   };
 }
+function moduleHasImplementation(projectDir, moduleName) {
+  const sanitized = (moduleName || "").toLowerCase().replace(/[^a-z0-9]/g, "");
+  if (!sanitized)
+    return false;
+  const roots = ["src", "crates", "packages", "internal", "lib", "app", "modules"];
+  const exts = ".*.(java|kt|ts|tsx|js|jsx|rs|py|go)$";
+  for (const root of roots) {
+    const base = path2.join(projectDir, root);
+    if (!fs.existsSync(base))
+      continue;
+    try {
+      const walk = (dir, depth) => {
+        if (depth > 6)
+          return false;
+        let entries;
+        try {
+          entries = fs.readdirSync(dir, { withFileTypes: true });
+        } catch {
+          return false;
+        }
+        for (const e of entries) {
+          if (e.name === "node_modules" || e.name === "target" || e.name === "dist" || e.name === ".git")
+            continue;
+          const full = path2.join(dir, e.name);
+          if (e.isDirectory()) {
+            if (e.name === sanitized && hasSourceBelow(full, depth))
+              return true;
+            if (walk(full, depth + 1))
+              return true;
+          }
+        }
+        return false;
+      };
+      const hasSourceBelow = (dir, depth) => {
+        let entries;
+        try {
+          entries = fs.readdirSync(dir, { withFileTypes: true });
+        } catch {
+          return false;
+        }
+        for (const e of entries) {
+          if (e.isFile() && new RegExp(exts).test(e.name) && !/test|spec/i.test(e.name))
+            return true;
+          if (e.isDirectory() && e.name !== "node_modules" && e.name !== "target" && depth < 6 && hasSourceBelow(path2.join(dir, e.name), depth + 1))
+            return true;
+        }
+        return false;
+      };
+      if (walk(base, 0))
+        return true;
+    } catch {}
+  }
+  return false;
+}
 function readExplorationSession(sessionId, projectDir) {
   const root = projectDir ?? process.cwd();
   const filePath = path2.join(root, ".pi", "domain", "exploration", `${sessionId}.md`);
@@ -12378,11 +12432,16 @@ function scaffoldFromExploration(sessionId, options) {
     const invariants = bc.invariants || [];
     const force = options?.overwrite === true;
     if (!dryRun && fs.existsSync(filePath)) {
-      if (!force) {
-        warnings.push(`Module already exists, preserved (use overwrite:true to replace): ${fileName}`);
+      const implemented = moduleHasImplementation(projectDir, moduleName);
+      if (implemented && !force) {
+        warnings.push(`Module is IMPLEMENTED, preserved (use overwrite:true to force): ${fileName}`);
         continue;
       }
-      warnings.push(`Module already exists, will be overwritten: ${fileName}`);
+      if (implemented && force) {
+        warnings.push(`Overwriting implemented module doc (--force): ${fileName}`);
+      } else {
+        warnings.push(`Refreshing planned module doc (no implementation yet): ${fileName}`);
+      }
     }
     const aggregateRoots = contextEntities.filter((e) => e.type === "aggregate-root");
     const regularEntities = contextEntities.filter((e) => e.type === "entity");
@@ -13155,7 +13214,7 @@ async function runDomain(targetDir, args, options) {
       await runExplore(targetDir, options);
       break;
     case "scaffold":
-      await runScaffold(targetDir, args[1], options);
+      await runScaffold(targetDir, args[1], { ...options, overwrite: args.includes("--force") });
       break;
     case "answer":
       await runAnswer(targetDir, args[1], args[2], options);
@@ -13262,7 +13321,8 @@ async function runScaffold(targetDir, sessionId, options) {
   try {
     const result = scaffoldFromExploration(sessionId, {
       projectDir: targetDir,
-      dryRun: options.dryRun
+      dryRun: options.dryRun,
+      overwrite: options.overwrite
     });
     if (options.dryRun) {
       outro(`Dry-run: would generate ${result.modulesGenerated} module(s)`);

package/dist/exports.js

@@ -1987,7 +1987,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.128", 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.129", 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 = {
     ".": {
@@ -12502,6 +12502,60 @@ function answerExploration(sessionId, responseJson, options) {
     warnings
   };
 }
+function moduleHasImplementation(projectDir, moduleName) {
+  const sanitized = (moduleName || "").toLowerCase().replace(/[^a-z0-9]/g, "");
+  if (!sanitized)
+    return false;
+  const roots = ["src", "crates", "packages", "internal", "lib", "app", "modules"];
+  const exts = ".*.(java|kt|ts|tsx|js|jsx|rs|py|go)$";
+  for (const root of roots) {
+    const base = path11.join(projectDir, root);
+    if (!fs12.existsSync(base))
+      continue;
+    try {
+      const walk = (dir, depth) => {
+        if (depth > 6)
+          return false;
+        let entries;
+        try {
+          entries = fs12.readdirSync(dir, { withFileTypes: true });
+        } catch {
+          return false;
+        }
+        for (const e of entries) {
+          if (e.name === "node_modules" || e.name === "target" || e.name === "dist" || e.name === ".git")
+            continue;
+          const full = path11.join(dir, e.name);
+          if (e.isDirectory()) {
+            if (e.name === sanitized && hasSourceBelow(full, depth))
+              return true;
+            if (walk(full, depth + 1))
+              return true;
+          }
+        }
+        return false;
+      };
+      const hasSourceBelow = (dir, depth) => {
+        let entries;
+        try {
+          entries = fs12.readdirSync(dir, { withFileTypes: true });
+        } catch {
+          return false;
+        }
+        for (const e of entries) {
+          if (e.isFile() && new RegExp(exts).test(e.name) && !/test|spec/i.test(e.name))
+            return true;
+          if (e.isDirectory() && e.name !== "node_modules" && e.name !== "target" && depth < 6 && hasSourceBelow(path11.join(dir, e.name), depth + 1))
+            return true;
+        }
+        return false;
+      };
+      if (walk(base, 0))
+        return true;
+    } catch {}
+  }
+  return false;
+}
 function readExplorationSession(sessionId, projectDir) {
   const root = projectDir ?? process.cwd();
   const filePath = path11.join(root, ".pi", "domain", "exploration", `${sessionId}.md`);
@@ -12702,11 +12756,16 @@ function scaffoldFromExploration(sessionId, options) {
     const invariants = bc.invariants || [];
     const force = options?.overwrite === true;
     if (!dryRun && fs12.existsSync(filePath)) {
-      if (!force) {
-        warnings.push(`Module already exists, preserved (use overwrite:true to replace): ${fileName}`);
+      const implemented = moduleHasImplementation(projectDir, moduleName);
+      if (implemented && !force) {
+        warnings.push(`Module is IMPLEMENTED, preserved (use overwrite:true to force): ${fileName}`);
         continue;
       }
-      warnings.push(`Module already exists, will be overwritten: ${fileName}`);
+      if (implemented && force) {
+        warnings.push(`Overwriting implemented module doc (--force): ${fileName}`);
+      } else {
+        warnings.push(`Refreshing planned module doc (no implementation yet): ${fileName}`);
+      }
     }
     const aggregateRoots = contextEntities.filter((e) => e.type === "aggregate-root");
     const regularEntities = contextEntities.filter((e) => e.type === "entity");
@@ -13479,7 +13538,7 @@ async function runDomain(targetDir, args, options) {
       await runExplore(targetDir, options);
       break;
     case "scaffold":
-      await runScaffold(targetDir, args[1], options);
+      await runScaffold(targetDir, args[1], { ...options, overwrite: args.includes("--force") });
       break;
     case "answer":
       await runAnswer(targetDir, args[1], args[2], options);
@@ -13586,7 +13645,8 @@ async function runScaffold(targetDir, sessionId, options) {
   try {
     const result = scaffoldFromExploration(sessionId, {
       projectDir: targetDir,
-      dryRun: options.dryRun
+      dryRun: options.dryRun,
+      overwrite: options.overwrite
     });
     if (options.dryRun) {
       outro(`Dry-run: would generate ${result.modulesGenerated} module(s)`);

package/package.json

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

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

@@ -239,6 +239,45 @@ function mergeRawJson(existing: Record<string, unknown>, incoming: Record<string
 	return merged;
 }
 
+// True when a module has real implementation code (not just a planned doc).
+function moduleHasCode(cwd: string, moduleName: string): boolean {
+	const sanitized = (moduleName || "").toLowerCase().replace(/[^a-z0-9]/g, "");
+	if (!sanitized) return false;
+	const roots = ["src", "crates", "packages", "internal", "lib", "app", "modules"];
+	const codeFile = (n: string): boolean => /.*\.(java|kt|ts|tsx|js|jsx|rs|py|go)$/.test(n) && !/test|spec/i.test(n);
+	const walk = (dir: string, depth: number): boolean => {
+		if (depth > 6) return false;
+		let entries;
+		try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return false; }
+		for (const e of entries) {
+			if (["node_modules", "target", "dist", ".git"].includes(e.name)) continue;
+			const full = path.join(dir, e.name);
+			if (e.isFile() && codeFile(e.name)) return true;
+			if (e.isDirectory() && (e.name === sanitized || walk(full, depth + 1))) {
+				// entered the module dir: any code file below counts
+				if (e.name === sanitized && hasCodeBelow(full, depth)) return true;
+			}
+		}
+		return false;
+	};
+	const hasCodeBelow = (dir: string, depth: number): boolean => {
+		let entries;
+		try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return false; }
+		for (const e of entries) {
+			if (["node_modules", "target", "dist"].includes(e.name)) continue;
+			const full = path.join(dir, e.name);
+			if (e.isFile() && codeFile(e.name)) return true;
+			if (e.isDirectory() && depth < 6 && hasCodeBelow(full, depth + 1)) return true;
+		}
+		return false;
+	};
+	for (const r of roots) {
+		const base = path.join(cwd, r);
+		if (fs.existsSync(base) && walk(base, 0)) return true;
+	}
+	return false;
+}
+
 function buildExplorationPrompt(context: string): string {
 	return [
 		"You are a Domain-Driven Design expert. Analyze the following business",
@@ -1058,7 +1097,7 @@ export default function (pi: ExtensionAPI) {
 				let scaffoldError = "";
 
 				try {
-					const cmd = "guardian-framework domain scaffold " + sessionId + " 2>&1";
+					const cmd = "guardian-framework domain scaffold " + sessionId + (forceScaffold ? " --force" : "") + " 2>&1";
 					const shellResult = await shellExec(ctx, cmd);
 					if (shellResult.exitCode === 0) {
 						const outputLines = shellResult.stdout.split("\n");
@@ -1281,7 +1320,9 @@ export default function (pi: ExtensionAPI) {
 				}
 				const preserved: string[] = [];
 				const moduleFiles = sessionModules.filter((f) => {
-					if (fs.existsSync(path.join(modulesDir, f)) && !forceEnrich) {
+					const exists = fs.existsSync(path.join(modulesDir, f));
+					const implemented = moduleHasCode(ctx.cwd, f.replace(/\.md$/, ""));
+					if (exists && implemented && !forceEnrich) {
 						preserved.push(f);
 						return false;
 					}

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-06T13:11:45Z",
+  "timestamp": "2026-09-06T13:20:31Z",
   "mode": "all",
   "stages_run": [],
   "summary": {