guardian-framework 0.1.126 → 0.1.128

package/dist/cli.js

@@ -3202,7 +3202,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.126", 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.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 init_package = __esm(() => {
   exports = {
     ".": {
@@ -12376,7 +12376,12 @@ function scaffoldFromExploration(sessionId, options) {
     const depthHeaderNote = bc.subdomainType === undefined || bc.subdomainType === null ? " (unclassified \u2014 defaulted to tactical; re-run exploration with ADR-008 depth)" : "";
     const contextEdges = (result.contextMap || []).filter((e) => e.from === bc.name || e.to === bc.name);
     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}`);
+        continue;
+      }
       warnings.push(`Module already exists, will be overwritten: ${fileName}`);
     }
     const aggregateRoots = contextEntities.filter((e) => e.type === "aggregate-root");

package/dist/exports.js

@@ -1987,7 +1987,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.126", 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.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 init_package = __esm(() => {
   exports = {
     ".": {
@@ -12700,7 +12700,12 @@ function scaffoldFromExploration(sessionId, options) {
     const depthHeaderNote = bc.subdomainType === undefined || bc.subdomainType === null ? " (unclassified — defaulted to tactical; re-run exploration with ADR-008 depth)" : "";
     const contextEdges = (result.contextMap || []).filter((e) => e.from === bc.name || e.to === bc.name);
     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}`);
+        continue;
+      }
       warnings.push(`Module already exists, will be overwritten: ${fileName}`);
     }
     const aggregateRoots = contextEntities.filter((e) => e.type === "aggregate-root");

package/package.json

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

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

@@ -978,10 +978,12 @@ export default function (pi: ExtensionAPI) {
 			// /domain --architect-scaffold <session-id>
 			// /domain --architect-scaffold <session-id>
 			if (trimmed.startsWith("--architect-scaffold")) {
-				const sessionId = trimmed.slice("--architect-scaffold".length).trim();
+				const rest = trimmed.slice("--architect-scaffold".length).trim();
+				const forceScaffold = rest.includes("--force");
+				const sessionId = rest.split(/\s+/)[0] || "";
 				if (!sessionId) {
 					ctx.ui.notify(
-						"Usage: /domain --architect-scaffold <session-id>",
+						"Usage: /domain --architect-scaffold <session-id> [--force]",
 						"error",
 					);
 					return "(domain command handled)";
@@ -1079,8 +1081,13 @@ export default function (pi: ExtensionAPI) {
 					ctx.ui.notify("Module scaffold unavailable - agent can create docs directly", "info");
 				}
 
-				// Step 2: Always regenerate ADR-001 to reflect current session
+				// Step 2: Refresh ADR-001 only when it does not exist yet (or --force).
+				// Never clobber an existing ADR that documents implemented architecture.
 				const adrPath = path.join(decisionsDir, "ADR-001-architecture-pattern.md");
+				if (fs.existsSync(adrPath) && !forceScaffold) {
+					ctx.ui.notify("Existing ADR-001 preserved — module docs scaffolded (use --force to refresh ADR)", "info");
+					return "(domain command handled)";
+				}
 				const bcList = bcNames.length > 0
 				? bcNames.map(n => "  - " + n).join("\n")
 				: "  - (to be defined during architecture planning)";
@@ -1229,9 +1236,11 @@ export default function (pi: ExtensionAPI) {
 				return resultLines.join("\n");
 			}
 			if (trimmed.startsWith("--enrich")) {
-				const sessionId = trimmed.slice("--enrich".length).trim();
+				const restE = trimmed.slice("--enrich".length).trim();
+				const forceEnrich = restE.includes("--force");
+				const sessionId = restE.split(/\s+/)[0] || "";
 				if (!sessionId) {
-					ctx.ui.notify("Usage: /domain --enrich <session-id>", "error");
+					ctx.ui.notify("Usage: /domain --enrich <session-id> [--force]", "error");
 					return "(domain command handled)";
 				}
 
@@ -1244,9 +1253,45 @@ export default function (pi: ExtensionAPI) {
 					return "(domain command handled)";
 				}
 
-				const moduleFiles = fs.readdirSync(modulesDir).filter(f => f.endsWith(".md") && f !== "module-template.md");
+				// Enrichment is SESSION-SCOPED: only module docs that belong to THIS
+				// 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, "");
+				let sessionModules: string[] = [];
+				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));
+					} catch { /* ignore */ }
+				}
+				if (sessionModules.length === 0) {
+					// fallback: session md bounded-contexts table
+					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));
+					}
+				}
+				const preserved: string[] = [];
+				const moduleFiles = sessionModules.filter((f) => {
+					if (fs.existsSync(path.join(modulesDir, f)) && !forceEnrich) {
+						preserved.push(f);
+						return false;
+					}
+					return true;
+				});
+				if (preserved.length > 0) {
+					ctx.ui.notify("Preserving existing module docs (use --force to enrich): " + preserved.join(", "), "info");
+				}
 				if (moduleFiles.length === 0) {
-					ctx.ui.notify("No module docs found. Run /domain --architect-scaffold " + sessionId + " first.", "error");
+					ctx.ui.notify("No new module docs for this session. Existing docs preserved — no enrich needed (or pass --force).", "error");
 					return "(domain command handled)";
 				}
 

package/templates/pi/preflight_report.json

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

package/templates/pi/scripts/languages/java/check_model_judgment.sh

@@ -109,7 +109,7 @@ if [ -d ".pi/architecture/modules" ]; then
                                 # concrete impl markers (Jdbc*/Jpa*/Local*/InMemory*/Hibernate*/...);
                                 # in tactical modules ANY .infrastructure. import from web layer is a leak
                                 case "$cls" in
-                                    Jdbc*|Jpa*|Local*|InMemory*|Hibernate*|Sql*|FileStore*|OutboxStore*)
+                                    Jdbc*|Jpa*|Local*|InMemory*|Hibernate*|Sql*)
                                         report "$f" "$ln" "web-layer-leak" "web layer imports CONCRETE infrastructure impl $cls — depend on a port/interface via the application layer"
                                         ;;
                                 esac
@@ -149,6 +149,12 @@ if [ -d ".pi/architecture/modules" ]; then
                     [ -n "$n" ] || continue
                     case " $names " in *" $n "*) ;; *) names="$names $n" ;; esac
                 done
+                # infix markers: MoneyOutIntentJdbcRepository -> MoneyOutIntentRepository
+                for marker in Jpa Jdbc Hibernate Spring; do
+                    n="${stem//$marker/}"
+                    [ -n "$n" ] || continue
+                    case " $names " in *" $n "*) ;; *) names="$names $n" ;; esac
+                done
                 found=""
                 for n in $names; do
                     if grep -rqiE "interface ${n}\\b|class ${n}\\b" "$match_dir/domain" --include="*.java" 2>/dev/null; then