guardian-framework 0.1.112 → 0.1.114

package/dist/cli.js

@@ -3202,7 +3202,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.112", 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.114", 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 = {
     ".": {

package/dist/exports.js

@@ -1987,7 +1987,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.112", 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.114", 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 = {
     ".": {

package/package.json

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

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;
@@ -675,32 +797,58 @@ export default function (pi: ExtensionAPI) {
 				// Using sendMessage with triggerTurn=true causes the agent to process
 				// this as a new conversation turn, not as a command response.
 				const analysisPrompt = [
-					"I need you to analyze the following business domain using Domain-Driven Design.",
-					"I have created stub files in .pi/domain/exploration.md and .pi/domain/ubiquitous-language.md.",
+					"Analyze this business domain with Domain-Driven Design. You MUST work in SMALL",
+					"incremental steps — never produce the whole model in one message, or you will be",
+					"truncated mid-JSON and lose work.",
 					"",
-					"Your task:",
-					"1. READ .pi/domain/exploration.md — it has the business context and empty tables",
-					"2. ANALYZE the domain: actors, FR/NFR, assumptions, bounded contexts, entities, events , glossary",
-					"3. FILL IN all empty tables in .pi/domain/exploration.md with your analysis",
-					"4. UPDATE .pi/domain/ubiquitous-language.md with the glossary terms",
+					"Session: " + sessionId,
+					"Business Context: " + sanitized,
 					"",
-					"Business Context:",
-					sanitized,
+					"STEP PROTOCOL (strict — one step per message, each message <= ~1,500 tokens of JSON):",
+					"",
+					"1. STRATEGIC PASS (this message): reply with ONLY this JSON, nothing else —",
+					'```json',
+					'{',
+					'  "actors": [{ "name": "...", "description": "...", "interactions": "..." }],',
+					'  "assumptions": [{ "assumption": "...", "impactIfWrong": "...", "mitigation": "..." }],',
+					'  "boundedContexts": [',
+					'    { "name": "...", "description": "...", "entities": ["..."],',
+					'      "subdomainType": "core|supporting|generic", "subdomainRationale": "one line" }',
+					'  ],',
+					'  "contextMap": [{ "from": "A", "to": "B", "relationship": "partnership|shared-kernel|conformist|anticorruption-layer|open-host", "note": "..." }],',
+					'  "openQuestions": "..."',
+					'}',
+					'```',
+					"then call domain_save_result with { sessionId, responseJson: <that JSON> }. It merges;",
+					"the file is saved for you. Do NOT also edit exploration.md by hand.",
 					"",
-					"Use this JSON schema as a reference for structuring your analysis:",
+					"2. PER-CONTEXT PASS (repeat for EACH core/tactical bounded context, one context per message):",
+					"reply with ONLY this JSON for one context, then call domain_save_result again:",
 					'```json',
-					"{",
-					'  "actors": [{ "name": "", "description": "", "interactions": "" }],',
-					'  "functionalRequirements": [{ "id": "FR-001", "requirement": "", "priority": "critical|high|medium|low", "boundedContext": "" }],',
-					'  "nonFunctionalRequirements": [{ "id": "NFR-001", "requirement": "", "category": "performance|security|scalability|availability|maintainability", "target": "" }],',
-					'  "assumptions": [{ "assumption": "", "impactIfWrong": "", "mitigation": "" }],',
-					'  "boundedContexts": [{ "name": "", "description": "", "entities": [""] }],',
-					'  "entities": [{ "name": "", "context": "", "type": "entity|value-object|aggregate-root", "description": "" }],',
-					'  "domainEvents": [{ "name": "", "context": "", "description": "", "triggeredBy": "" }],',
-					'  "ubiquitousLanguage": [{ "term": "", "definition": "", "boundedContext": "", "aliases": [""], "examples": "" }]',
-					"}",
+					'{',
+					'  "boundedContexts": [{ "name": "TheContext", "description": "...", "entities": ["Entity1"],',
+					'    "invariants": [{ "rule": "...", "illegalStatePrevented": "..." }] }],',
+					'  "entities": [',
+					'    { "name": "Entity1", "context": "TheContext", "type": "entity|value-object|aggregate-root",',
+					'      "description": "...",',
+					'      "justification": { "identityPersists": true, "immutable": false, "equalByState": false } }',
+					'  ],',
+					'  "domainEvents": [',
+					'    { "name": "Event", "context": "TheContext", "description": "...", "triggeredBy": "...",',
+					'      "triage": { "domainExpertCares": true, "crossesAggregateBoundary": false, "needsAudit": false } }',
+					'  ],',
+					'  "ubiquitousLanguage": [{ "term": "...", "definition": "...", "boundedContext": "TheContext", "aliases": [], "examples": "" }]',
+					'}',
 					'```',
+					"Supporting/generic contexts need no detail pass — the strategic entry is enough.",
+					"",
+					"RULES:",
+					"- If a message of yours is cut off mid-JSON, continue from exactly where you stopped in the",
+					"  NEXT message (never restart the whole model).",
+					"- Never emit the full model in one response and never exceed ~1,500 tokens of JSON per message.",
+					"- After the last context, run /domain --validate " + sessionId + " and report the checks.",
 				].join("\n");
+				
 
 				try {
 					pi.sendMessage(

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-04T16:02:56Z",
+  "timestamp": "2026-09-04T18:20:52Z",
   "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",