guardian-framework 0.1.111 → 0.1.113

package/dist/cli.js

@@ -3202,7 +3202,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.111", 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.113", 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 = {
     ".": {
@@ -3211,7 +3211,7 @@ var init_package = __esm(() => {
     }
   };
   bin = {
-    "guardian-framework": "./dist/cli.js"
+    "guardian-framework": "dist/cli.js"
   };
   files = ["dist/", "templates/"];
   engines = {
@@ -3237,7 +3237,7 @@ var init_package = __esm(() => {
   };
   repository = {
     type: "git",
-    url: "https://github.com/arman-jalili/guardian-framework"
+    url: "git+https://github.com/arman-jalili/guardian-framework.git"
   };
   bugs = {
     url: "https://github.com/arman-jalili/guardian-framework/issues"
@@ -11851,7 +11851,21 @@ function parseExplorationResponse(rawResponse, sessionId) {
     if (jsonMatch) {
       cleaned = jsonMatch[1].trim();
     }
-    const parsed = JSON.parse(cleaned);
+    let parsed;
+    try {
+      parsed = JSON.parse(cleaned);
+    } catch (err) {
+      if (isTruncatedJson(cleaned)) {
+        return {
+          ok: false,
+          error: "Exploration response was truncated before completion (incomplete JSON). " + "Retry with a higher model output limit, ask the model to continue from " + "exactly where it stopped (parseContinuedExplorationResponse), or split the " + "exploration into phases (strategic model first, then per-core-context enrichment)."
+        };
+      }
+      return {
+        ok: false,
+        error: `Invalid exploration response: ${err instanceof Error ? err.message : String(err)}`
+      };
+    }
     const result = {
       sessionId: sessionId ?? parsed.sessionId ?? crypto.randomUUID(),
       businessContext: coerceString(parsed.businessContext, ""),
@@ -11929,6 +11943,33 @@ function parseExplorationResponse(rawResponse, sessionId) {
     };
   }
 }
+function isTruncatedJson(text2) {
+  const stack = [];
+  let inString = false;
+  let escaped = false;
+  for (let i2 = 0;i2 < text2.length; i2++) {
+    const ch = text2[i2];
+    if (inString) {
+      if (escaped)
+        escaped = false;
+      else if (ch === "\\")
+        escaped = true;
+      else if (ch === '"')
+        inString = false;
+      continue;
+    }
+    if (ch === '"')
+      inString = true;
+    else if (ch === "{" || ch === "[")
+      stack.push(ch);
+    else if (ch === "}" || ch === "]") {
+      const open = stack.pop();
+      if (ch === "}" && open !== "{" || ch === "]" && open !== "[")
+        return false;
+    }
+  }
+  return inString || stack.length > 0;
+}
 function coerceString(val, fallback) {
   if (typeof val === "string")
     return val;

package/dist/exports.js

@@ -1987,7 +1987,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.111", 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.113", 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 = {
     ".": {
@@ -1996,7 +1996,7 @@ var init_package = __esm(() => {
     }
   };
   bin = {
-    "guardian-framework": "./dist/cli.js"
+    "guardian-framework": "dist/cli.js"
   };
   files = ["dist/", "templates/"];
   engines = {
@@ -2022,7 +2022,7 @@ var init_package = __esm(() => {
   };
   repository = {
     type: "git",
-    url: "https://github.com/arman-jalili/guardian-framework"
+    url: "git+https://github.com/arman-jalili/guardian-framework.git"
   };
   bugs = {
     url: "https://github.com/arman-jalili/guardian-framework/issues"
@@ -12175,7 +12175,21 @@ function parseExplorationResponse(rawResponse, sessionId) {
     if (jsonMatch) {
       cleaned = jsonMatch[1].trim();
     }
-    const parsed = JSON.parse(cleaned);
+    let parsed;
+    try {
+      parsed = JSON.parse(cleaned);
+    } catch (err) {
+      if (isTruncatedJson(cleaned)) {
+        return {
+          ok: false,
+          error: "Exploration response was truncated before completion (incomplete JSON). " + "Retry with a higher model output limit, ask the model to continue from " + "exactly where it stopped (parseContinuedExplorationResponse), or split the " + "exploration into phases (strategic model first, then per-core-context enrichment)."
+        };
+      }
+      return {
+        ok: false,
+        error: `Invalid exploration response: ${err instanceof Error ? err.message : String(err)}`
+      };
+    }
     const result = {
       sessionId: sessionId ?? parsed.sessionId ?? crypto4.randomUUID(),
       businessContext: coerceString(parsed.businessContext, ""),
@@ -12253,6 +12267,33 @@ function parseExplorationResponse(rawResponse, sessionId) {
     };
   }
 }
+function isTruncatedJson(text2) {
+  const stack = [];
+  let inString = false;
+  let escaped = false;
+  for (let i2 = 0;i2 < text2.length; i2++) {
+    const ch = text2[i2];
+    if (inString) {
+      if (escaped)
+        escaped = false;
+      else if (ch === "\\")
+        escaped = true;
+      else if (ch === '"')
+        inString = false;
+      continue;
+    }
+    if (ch === '"')
+      inString = true;
+    else if (ch === "{" || ch === "[")
+      stack.push(ch);
+    else if (ch === "}" || ch === "]") {
+      const open = stack.pop();
+      if (ch === "}" && open !== "{" || ch === "]" && open !== "[")
+        return false;
+    }
+  }
+  return inString || stack.length > 0;
+}
 function coerceString(val, fallback) {
   if (typeof val === "string")
     return val;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.111",
+	"version": "0.1.113",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",
@@ -12,7 +12,7 @@
 	},
 	"types": "dist/exports.d.ts",
 	"bin": {
-		"guardian-framework": "./dist/cli.js"
+		"guardian-framework": "dist/cli.js"
 	},
 	"files": ["dist/", "templates/"],
 	"engines": {
@@ -38,7 +38,7 @@
 	},
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/arman-jalili/guardian-framework"
+		"url": "git+https://github.com/arman-jalili/guardian-framework.git"
 	},
 	"homepage": "https://github.com/arman-jalili/guardian-framework#readme",
 	"bugs": {

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

@@ -136,6 +136,100 @@ function sanitizeContext(context: string): string {
 		.slice(0, 5000);
 }
 
+// True when a JSON string was cut off mid-output (unclosed structures or a
+// mid-string cut) — distinguishes truncation from invalid-but-complete JSON.
+function isTruncatedJsonText(text: string): boolean {
+	const stack: string[] = [];
+	let inString = false;
+	let escaped = false;
+	for (let i = 0; i < text.length; i++) {
+		const ch = text[i];
+		if (inString) {
+			if (escaped) escaped = false;
+			else if (ch === "\\") escaped = true;
+			else if (ch === '"') inString = false;
+			continue;
+		}
+		if (ch === '"') inString = true;
+		else if (ch === "{" || ch === "[") stack.push(ch);
+		else if (ch === "}" || ch === "]") {
+			const open = stack.pop();
+			if ((ch === "}" && open !== "{") || (ch === "]" && open !== "[")) return false;
+		}
+	}
+	return inString || stack.length > 0;
+}
+
+function pickKey(item: Record<string, unknown>, keys: string[]): string {
+	return keys.map((k) => String(item[k] ?? "")).join("|");
+}
+
+function mergeArrayById(
+	existing: Record<string, unknown>[],
+	incoming: Record<string, unknown>[],
+	keys: string[],
+): Record<string, unknown>[] {
+	const out = new Map<string, Record<string, unknown>>();
+	for (const item of existing) out.set(pickKey(item, keys), item);
+	for (const item of incoming) {
+		const k = pickKey(item, keys);
+		const prev = out.get(k);
+		if (prev) out.set(k, { ...prev, ...item });
+		else out.set(k, item);
+	}
+	return Array.from(out.values());
+}
+
+// Merge a repeated domain_save_result call into a previously saved session so
+// large domains can be saved in parts without a single oversized response.
+function mergeRawJson(existing: Record<string, unknown>, incoming: Record<string, unknown>): Record<string, unknown> {
+	const merged: Record<string, unknown> = { ...existing, ...incoming };
+	const mergeArr = (key: string, keys: string[]) => {
+		const a = Array.isArray(existing[key]) ? (existing[key] as Record<string, unknown>[]) : [];
+		const b = Array.isArray(incoming[key]) ? (incoming[key] as Record<string, unknown>[]) : [];
+		merged[key] = mergeArrayById(a, b, keys);
+	};
+	mergeArr("actors", ["name"]);
+	mergeArr("functionalRequirements", ["id"]);
+	mergeArr("nonFunctionalRequirements", ["id"]);
+	mergeArr("assumptions", ["assumption"]);
+	mergeArr("domainEvents", ["name", "context"]);
+	mergeArr("ubiquitousLanguage", ["term", "boundedContext"]);
+	// entities dedupe by (context, name)
+	const entA = Array.isArray(existing.entities) ? (existing.entities as Record<string, unknown>[]) : [];
+	const entB = Array.isArray(incoming.entities) ? (incoming.entities as Record<string, unknown>[]) : [];
+	merged.entities = mergeArrayById(entA, entB, ["name", "context"]);
+	// bounded contexts: merge by name; union entity lists + invariants
+	const bcA = Array.isArray(existing.boundedContexts) ? (existing.boundedContexts as Record<string, unknown>[]) : [];
+	const bcB = Array.isArray(incoming.boundedContexts) ? (incoming.boundedContexts as Record<string, unknown>[]) : [];
+	const bcMap = new Map<string, Record<string, unknown>>();
+	for (const bc of [...bcA, ...bcB]) {
+		const name = String(bc.name ?? "");
+		if (!name) continue;
+		const prev = bcMap.get(name);
+		if (!prev) { bcMap.set(name, { ...bc }); continue; }
+		const entities = new Set<string>([
+			...(Array.isArray(prev.entities) ? prev.entities.map(String) : []),
+			...(Array.isArray(bc.entities) ? bc.entities.map(String) : []),
+		]);
+		const invariants = Array.isArray(bc.invariants) && bc.invariants.length > 0
+			? bc.invariants
+			: prev.invariants;
+		bcMap.set(name, {
+			...prev,
+			...bc,
+			entities: Array.from(entities),
+			invariants: invariants ?? [],
+		});
+	}
+	merged.boundedContexts = Array.from(bcMap.values());
+	for (const key of ["businessContext", "openQuestions", "aggregateRoots", "status"]) {
+		const v = incoming[key];
+		if (v !== undefined && String(v).trim() !== "" && String(v).trim() !== "None") merged[key] = v;
+	}
+	return merged;
+}
+
 function buildExplorationPrompt(context: string): string {
 	return [
 		"You are a Domain-Driven Design expert. Analyze the following business",
@@ -288,8 +382,10 @@ export default function (pi: ExtensionAPI) {
 		label: "Domain Save Result",
 		description:
 			"Save the agent's domain analysis JSON as a structured exploration session. " +
-			"As a fallback for agents that prefer tool calls over direct file writes. " +
-			"Parses JSON, writes exploration.md and updates ubiquitous-language.md.",
+			"Incremental: repeated calls merge into the session, so large domains can be " +
+			"delivered in parts (boundedContexts first, then per-context enrichments) instead of " +
+			"one oversized response that truncates. Writes exploration.md, session file and .raw.json; " +
+			"updates ubiquitous-language.md.",
 		parameters: Type.Object({
 			sessionId: Type.String({ description: "Session ID from --explore" }),
 			responseJson: Type.String({ description: "Domain analysis JSON from the agent" }),
@@ -305,7 +401,27 @@ export default function (pi: ExtensionAPI) {
 			if (jsonMatch) cleaned = jsonMatch[1].trim();
 			let parsedJson: Record<string, unknown>;
 			try { parsedJson = JSON.parse(cleaned) as Record<string, unknown>; }
-			catch (e) { return { content: [{ type: "text" as const, text: "ERROR: Failed to parse JSON: " + String(e) }] }; }
+			catch (e) {
+				if (isTruncatedJsonText(cleaned)) {
+					return { content: [{ type: "text" as const, text:
+						"ERROR: domain JSON was truncated before completion. Never resend a partial model as final. " +
+						"Options: (1) retry with the full completed JSON; (2) for large domains save IN PARTS — " +
+						"domain_save_result merges: send boundedContexts first, then per-context enrichments " +
+						"(entities/events/UL/invariants) across several calls; (3) reduce model output strain by " +
+						"phasing the exploration." }] };
+				}
+				return { content: [{ type: "text" as const, text: "ERROR: Failed to parse JSON: " + String(e) }] };
+			}
+
+			// Incremental: merge into any previously saved structured session
+			// (<session>.raw.json) so large domains can be saved in parts.
+			const rawPath = path.join(ctx.cwd, ".pi", "domain", "exploration", sessionId + ".raw.json");
+			if (fs.existsSync(rawPath)) {
+				try {
+					const existing = JSON.parse(fs.readFileSync(rawPath, "utf-8")) as Record<string, unknown>;
+					parsedJson = mergeRawJson(existing, parsedJson);
+				} catch { /* ignore unreadable prior state */ }
+			}
 
 			const now = new Date().toISOString().split("T")[0];
 			const explorationDir = path.join(ctx.cwd, ".pi", "domain", "exploration");
@@ -369,6 +485,12 @@ export default function (pi: ExtensionAPI) {
 			fs.writeFileSync(tmpSession, sessionContent, "utf-8");
 			fs.renameSync(tmpSession, sessionPath);
 
+			// Persist the merged structured result (enables incremental saves +
+			// downstream depth validators that read .raw.json)
+			const rawTmp = rawPath + ".tmp";
+			fs.writeFileSync(rawTmp, JSON.stringify(parsedJson, null, 2), "utf-8");
+			fs.renameSync(rawTmp, rawPath);
+
 			// Update ubiquitous-language.md with new terms
 			const glPath = path.join(ctx.cwd, ".pi", "domain", "ubiquitous-language.md");
 			const ulRaw = parsedJson.ubiquitousLanguage as Array<Record<string, unknown>> | undefined;

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-04T15:30:01Z",
+  "timestamp": "2026-09-04T16:15:16Z",
   "mode": "all",
   "stages_run": [],
   "summary": {
@@ -8,7 +8,7 @@
     "failed": 1,
     "skipped": 12
   },
-  "duration_seconds": 0,
+  "duration_seconds": 1,
   "results": [
   {
     "name": "check_mr_traceability.sh",