guardian-framework 0.1.42 → 0.1.44

package/dist/cli.js

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

@@ -995,7 +995,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.42", 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.44", 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.42",
+	"version": "0.1.44",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

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

@@ -6,6 +6,7 @@
  * Pi extension providing:
  *   /domain --explore — Returns DDD analysis instructions + agent writes files directly
  *   /domain --architect-scaffold — Generate architecture directories from exploration
+ *   /domain --enrich — Enrich module stubs with full DDD content
  *   /domain --validate — Validate exploration session structure
  *   domain_explore tool — (deprecated, use /domain --explore instead)
  *   domain_validate tool — Validate exploration sessions against glossary + source code
@@ -75,7 +76,7 @@ type ExtensionAPI = {
 			toolCallId: string,
 			params: Record<string, unknown>,
 			signal: AbortSignal,
-			onUpdate: (update: { content: Array<{ type: string; text: string }> }) => void,
+			onUpdate: (update: { type: string; message: string }) => void,
 			ctx: ExtensionContext,
 		): unknown | Promise<unknown>;
 	}): void;
@@ -190,132 +191,6 @@ function buildExplorationPrompt(context: string): string {
 	].join("\n");
 }
 
-function readLanguage(cwd: string): string {
-	try {
-		const manifestPath = path.join(cwd, "guardian-manifest.json");
-		if (fs.existsSync(manifestPath)) {
-			const raw = fs.readFileSync(manifestPath, "utf-8");
-			const manifest = JSON.parse(raw) as { language?: string };
-			if (manifest.language) return manifest.language;
-		}
-	} catch {}
-	return "typescript";
-}
-
-function buildFrontendExplorationPrompt(context: string): string {
-	return [
-		"You are a frontend architecture expert. Analyze the following web application",
-		"description and extract a structured model focused on user experience,",
-		"UI concepts, and design principles. Respond with valid JSON only.",
-		"",
-		"## Business Context",
-		"",
-		context,
-		"",
-		"## Output Format (JSON)",
-		"",
-		"\`\`\`json",
-		"{",
-		'  "businessContext": "Brief one-line summary",',
-		'  "actors": [',
-		"    {",
-		'      "name": "UserRole",',
-		'      "description": "Who this user is",',
-		'      "interactions": "What they do in the application"',
-		"    }",
-		"  ],",
-		'  "functionalRequirements": [',
-		"    {",
-		'      "id": "FR-001",',
-		'      "requirement": "The user shall be able to...",',
-		'      "priority": "critical|high|medium|low",',
-		'      "boundedContext": "FeatureName"',
-		"    }",
-		"  ],",
-		'  "nonFunctionalRequirements": [',
-		"    {",
-		'      "id": "NFR-001",',
-		'      "requirement": "The application shall...",',
-		'      "category": "performance|accessibility|usability|security|maintainability",',
-		'      "target": "Specific measurable target"',
-		"    }",
-		"  ],",
-		'  "assumptions": [',
-		"    {",
-		'      "assumption": "We assume that...",',
-		'      "impactIfWrong": "What breaks if this is false",',
-		'      "mitigation": "How we handle it being wrong"',
-		"    }",
-		"  ],",
-		'  "boundedContexts": [',
-		"    {",
-		'      "name": "FeatureName",',
-		'      "description": "Brief description of this app feature/section",',
-		'      "entities": ["UIConcept1", "UIConcept2"]',
-		"    }",
-		"  ],",
-		'  "entities": [',
-		"    {",
-		'      "name": "UIConceptName",',
-		'      "context": "FeatureName",',
-		'      "type": "ui-concept | user-intent | design-token | app-shell | value-object",',
-		'      "description": "What this UI concept represents"',
-		"    }",
-		"  ],",
-		'  "userIntents": [',
-		"    {",
-		'      "name": "UserIntentName",',
-		'      "context": "FeatureName",',
-		'      "description": "What the user is trying to do",',
-		'      "triggeredBy": "What UI action triggers this intent"',
-		"    }",
-		"  ],",
-		'  "designPrinciples": [',
-		"    {",
-		'      "principle": "The application is...",',
-		'      "description": "What this principle means in practice",',
-		'      "rationale": "Why this principle exists"',
-		"    }",
-		"  ],",
-		'  "navigationPhilosophy": {',
-		'    "contextPreservation": "How the user never loses context",',
-		'    "deepLinking": "How every page is deep-linkable",',
-		'    "multiTab": "How multiple tabs are supported"',
-		"  },",
-		'  "appShell": {',
-		'    "navigation": "Navigation structure",',
-		'    "header": "Header content",',
-		'    "sidebar": "Sidebar content",',
-		'    "commandPalette": "Command palette actions",',
-		'    "globalSearch": "Global search behavior"',
-		"  },",
-		'  "degradationStrategy": [',
-		"    {",
-		'      "feature": "FeatureName",',
-		'      "whenUnavailable": "What happens when this feature API is down",',
-		'      "degradesTo": "What still works"',
-		"    }",
-		"  ],",
-		'  "ubiquitousLanguage": [',
-		"    {",
-		'      "term": "CanonicalTerm",',
-		'      "definition": "Clear definition",',
-		'      "boundedContext": "FeatureName",',
-		'      "aliases": ["AlternativeName1"],',
-		'      "examples": "Usage example"',
-		"    }",
-		"  ],",
-		'  "openQuestions": "Any open questions about the application",',
-		'  "designSystem": {',
-		'    "componentLibrary": "Which component library or approach",',
-		'    "theming": "How theming works",',
-		'    "accessibility": "Accessibility requirements"',
-		"  }",
-		"}",
-		"\`\`\`",
-	].join("\n");
-}
-
 // ── Domain Explore Tool (deprecated) ──
 
 export default function (pi: ExtensionAPI) {
@@ -599,9 +474,7 @@ export default function (pi: ExtensionAPI) {
 					return "(domain command handled)";
 				}
 				const sanitized = sanitizeContext(context);
-				const lang = readLanguage(ctx.cwd);
-				const isFrontend = lang === "nextjs" || lang === "angular";
-				const prompt = isFrontend ? buildFrontendExplorationPrompt(sanitized) : buildExplorationPrompt(sanitized);
+				const prompt = buildExplorationPrompt(sanitized);
 				const sessionId = crypto.randomUUID();
 				const explorationDir = path.join(ctx.cwd, ".pi", "domain", "exploration");
 				fs.mkdirSync(explorationDir, { recursive: true });
@@ -630,237 +503,99 @@ export default function (pi: ExtensionAPI) {
 
 				// Write stub exploration.md with business context filled in
 				const explorationMdPath = path.join(ctx.cwd, ".pi", "domain", "exploration.md");
-				const stubContent = isFrontend
-					? [
-						"---",
-						"session_id: " + sessionId,
-						"created: " + new Date().toISOString().split("T")[0],
-						'business_context: "' + sanitized.replace(/"/g, '\\"') + '"',
-						"status: draft",
-						"---",
-						"",
-						"# Domain Exploration: " + sessionId,
-						"",
-						"> **Status:** draft — agent needs to fill in the analysis below.",
-						"",
-						"---",
-						"",
-						"## Business Context",
-						"",
-						sanitized,
-						"",
-						"---",
-						"",
-						"## Actors & Roles",
-						"",
-						"| Actor | Description | Interactions |",
-						"|-------|-------------|-------------|",
-						"| | | |",
-						"",
-						"---",
-						"",
-						"## Functional Requirements",
-						"",
-						"| ID | Requirement | Priority | Feature |",
-						"|----|-------------|----------|--------|",
-						"| | | | |",
-						"",
-						"---",
-						"",
-						"## Non-Functional Requirements",
-						"",
-						"| ID | Requirement | Category | Target |",
-						"|----|-------------|----------|--------|",
-						"| | | | |",
-						"",
-						"---",
-						"",
-						"## Assumptions",
-						"",
-						"| Assumption | Impact if Wrong | Mitigation |",
-						"|------------|----------------|-----------|",
-						"| | | |",
-						"",
-						"---",
-						"",
-						"## Features (Bounded Contexts)",
-						"",
-						"| Feature | Description | UI Concepts |",
-						"|---------|-------------|------------|",
-						"| | | |",
-						"",
-						"---",
-						"",
-						"## UI Concepts",
-						"",
-						"| Concept | Feature | Type | Description |",
-						"|---------|---------|------|-------------|",
-						"| | | | |",
-						"",
-						"---",
-						"",
-						"## User Intents",
-						"",
-						"| Intent | Feature | Description | Triggered By |",
-						"|--------|---------|-------------|-------------|",
-						"| | | | |",
-						"",
-						"---",
-						"",
-						"## Design Principles",
-						"",
-						"| Principle | Description | Rationale |",
-						"|-----------|-------------|----------|",
-						"| | | |",
-						"",
-						"---",
-						"",
-						"## Navigation Philosophy",
-						"",
-						"| Aspect | Description |",
-						"|--------|-------------|",
-						"| Context Preservation | |",
-						"| Deep Linking | |",
-						"| Multi-Tab Support | |",
-						"",
-						"---",
-						"",
-						"## App Shell",
-						"",
-						"| Component | Description |",
-						"|-----------|-------------|",
-						"| Navigation | |",
-						"| Header | |",
-						"| Sidebar | |",
-						"| Command Palette | |",
-						"| Global Search | |",
-						"| Status Bar | |",
-						"",
-						"---",
-						"",
-						"## Degradation Strategy",
-						"",
-						"| Feature | When Unavailable | Degrades To |",
-						"|---------|-----------------|-------------|",
-						"| | | |",
-						"",
-						"---",
-						"",
-						"## Ubiquitous Language",
-						"",
-						"| Term | Definition | Feature | Aliases/Synonyms |",
-						"|------|-----------|---------|-----------------|",
-						"| | | | |",
-						"",
-						"---",
-						"",
-						"## Design System",
-						"",
-						"| Aspect | Decision |",
-						"|--------|----------|",
-						"| Component Library | |",
-						"| Theming | |",
-						"| Accessibility | |",
-						"",
-						"---",
-						"",
-						"## Open Questions",
-						"",
-						"",
-					  ].join("\n")
-					: [
-						"---",
-						"session_id: " + sessionId,
-						"created: " + new Date().toISOString().split("T")[0],
-						'business_context: "' + sanitized.replace(/"/g, '\\"') + '"',
-						"status: draft",
-						"---",
-						"",
-						"# Domain Exploration: " + sessionId,
-						"",
-						"> **Status:** draft — agent needs to fill in the analysis below.",
-						"",
-						"---",
-						"",
-						"## Business Context",
-						"",
-						sanitized,
-						"",
-						"---",
-						"",
-						"## Actors & Roles",
-						"",
-						"| Actor | Description | Interactions |",
-						"|-------|-------------|-------------|",
-						"| | | |",
-						"",
-						"---",
-						"",
-						"## Functional Requirements",
-						"",
-						"| ID | Requirement | Priority | Bounded Context |",
-						"|----|-------------|----------|----------------|",
-						"| | | | |",
-						"",
-						"---",
-						"",
-						"## Non-Functional Requirements",
-						"",
-						"| ID | Requirement | Category | Target |",
-						"|----|-------------|----------|--------|",
-						"| | | | |",
-						"",
-						"---",
-						"",
-						"## Assumptions",
-						"",
-						"| Assumption | Impact if Wrong | Mitigation |",
-						"|------------|----------------|-----------|",
-						"| | | |",
-						"",
-						"---",
-						"",
-						"## Bounded Contexts",
-						"",
-						"| Context | Description | Entities |",
-						"|---------|-------------|----------|",
-						"| | | |",
-						"",
-						"---",
-						"",
-						"## Entities",
-						"",
-						"| Entity | Context | Type | Description |",
-						"|--------|---------|------|-------------|",
-						"| | | | |",
-						"",
-						"---",
-						"",
-						"## Domain Events",
-						"",
-						"| Event | Context | Description | Triggered By |",
-						"|-------|---------|-------------|-------------|",
-						"| | | | |",
-						"",
-						"---",
-						"",
-						"## Ubiquitous Language",
-						"",
-						"| Term | Definition | Bounded Context | Aliases/Synonyms |",
-						"|------|-----------|----------------|-----------------|",
-						"| | | | |",
-						"",
-						"---",
-						"",
-						"## Open Questions",
-						"",
-						"",
-						"---",
-						"",
-						"## Aggregate Roots",
-						"",
-						"",
-					  ].join("\n");
+				const stubContent = [
+					"---",
+					"session_id: " + sessionId,
+					"created: " + new Date().toISOString().split("T")[0],
+					'business_context: "' + sanitized.replace(/"/g, '\\"') + '"',
+					"status: draft",
+					"---",
+					"",
+					"# Domain Exploration: " + sessionId,
+					"",
+					"> **Status:** draft — agent needs to fill in the analysis below.",
+					"",
+					"---",
+					"",
+					"## Business Context",
+					"",
+					sanitized,
+					"",
+					"---",
+					"",
+					"## Actors & Roles",
+					"",
+					"| Actor | Description | Interactions |",
+					"|-------|-------------|-------------|",
+					"| | | |",
+					"",
+					"---",
+					"",
+					"## Functional Requirements",
+					"",
+					"| ID | Requirement | Priority | Bounded Context |",
+					"|----|-------------|----------|----------------|",
+					"| | | | |",
+					"",
+					"---",
+					"",
+					"## Non-Functional Requirements",
+					"",
+					"| ID | Requirement | Category | Target |",
+					"|----|-------------|----------|--------|",
+					"| | | | |",
+					"",
+					"---",
+					"",
+					"## Assumptions",
+					"",
+					"| Assumption | Impact if Wrong | Mitigation |",
+					"|------------|----------------|-----------|",
+					"| | | |",
+					"",
+					"---",
+					"",
+					"## Bounded Contexts",
+					"",
+					"| Context | Description | Entities |",
+					"|---------|-------------|----------|",
+					"| | | |",
+					"",
+					"---",
+					"",
+					"## Entities",
+					"",
+					"| Entity | Context | Type | Description |",
+					"|--------|---------|------|-------------|",
+					"| | | | |",
+					"",
+					"---",
+					"",
+					"## Domain Events",
+					"",
+					"| Event | Context | Description | Triggered By |",
+					"|-------|---------|-------------|-------------|",
+					"| | | | |",
+					"",
+					"---",
+					"",
+					"## Ubiquitous Language",
+					"",
+					"| Term | Definition | Bounded Context | Aliases/Synonyms |",
+					"|------|-----------|----------------|-----------------|",
+					"| | | | |",
+					"",
+					"---",
+					"",
+					"## Open Questions",
+					"",
+					"",
+					"---",
+					"",
+					"## Aggregate Roots",
+					"",
+					"",
+				].join("\n");
 				fs.writeFileSync(explorationMdPath + ".tmp", stubContent, "utf-8");
 				fs.renameSync(explorationMdPath + ".tmp", explorationMdPath);
 
@@ -892,18 +627,12 @@ 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.",
+					"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.",
 					"",
-					"IMPORTANT: Read .pi/domain/exploration.md FIRST. It contains empty tables.",
-					"FILL IN the existing tables exactly as structured. Do NOT change the section names or table columns.",
-					"Do NOT add new sections that aren't in the stub. Do NOT use 'Domain Events' or 'Aggregate Roots' — those are backend concepts.",
-					"",
 					"Your task:",
 					"1. READ .pi/domain/exploration.md — it has the business context and empty tables",
-					(isFrontend
-						? "2. ANALYZE the domain: actors, FR/NFR, assumptions, features (bounded contexts), UI concepts, user intents, glossary"
-						: "2. ANALYZE the domain: actors, FR/NFR, assumptions, bounded contexts, entities, events, glossary"),
+					"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",
 					"",
@@ -911,40 +640,18 @@ export default function (pi: ExtensionAPI) {
 					sanitized,
 					"",
 					"Use this JSON schema as a reference for structuring your analysis:",
-					isFrontend
-						? [
-								'\`\`\`json',
-								"{",
-								'  "actors": [{ "name": "", "description": "", "interactions": "" }],',
-								'  "functionalRequirements": [{ "id": "FR-001", "requirement": "", "priority": "critical|high|medium|low", "boundedContext": "" }],',
-								'  "nonFunctionalRequirements": [{ "id": "NFR-001", "requirement": "", "category": "performance|accessibility|usability|security|maintainability", "target": "" }],',
-								'  "assumptions": [{ "assumption": "", "impactIfWrong": "", "mitigation": "" }],',
-								'  "boundedContexts": [{ "name": "", "description": "", "entities": [""] }],',
-								'  "entities": [{ "name": "", "context": "", "type": "ui-concept|user-intent|design-token|app-shell|value-object", "description": "" }],',
-								'  "userIntents": [{ "name": "", "context": "", "description": "", "triggeredBy": "" }],',
-								'  "designPrinciples": [{ "principle": "", "description": "", "rationale": "" }],',
-								'  "navigationPhilosophy": { "contextPreservation": "", "deepLinking": "", "multiTab": "" },',
-								'  "appShell": { "navigation": "", "header": "", "sidebar": "", "commandPalette": "", "globalSearch": "" },',
-								'  "degradationStrategy": [{ "feature": "", "whenUnavailable": "", "degradesTo": "" }],',
-								'  "ubiquitousLanguage": [{ "term": "", "definition": "", "boundedContext": "", "aliases": [""], "examples": "" }],',
-								'  "designSystem": { "componentLibrary": "", "theming": "", "accessibility": "" }',
-								"}",
-								'\`\`\`',
-						  ].join("\n")
-						: [
-								'\`\`\`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": "" }]',
-								"}",
-								'\`\`\`',
-						  ].join("\n"),
+					'```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": "" }]',
+					"}",
+					'```',
 				].join("\n");
 
 				try {
@@ -1017,6 +724,15 @@ export default function (pi: ExtensionAPI) {
 				}
 
 				// Parse bounded context names from (now synced) session content
+				// Strip markdown formatting (**bold**, *italic*, `code`) from a string
+				function stripMarkdown(text: string): string {
+					return text
+						.replace(/\*\*(.+?)\*\*/g, "$1")
+						.replace(/\*(.+?)\*/g, "$1")
+						.replace(/`(.+?)`/g, "$1")
+						.trim();
+				}
+
 				const bcNames: string[] = [];
 				const sourceForBC = analysisContent || sessionContent;
 				const bcSection = sourceForBC.match(/## Bounded Contexts[\s\S]*?(?=\n## |$)/);
@@ -1028,7 +744,7 @@ export default function (pi: ExtensionAPI) {
 						if (!inData || !line.startsWith("|")) continue;
 						const cells = line.split("|").map(c => c.trim()).filter(c => c);
 						if (cells.length >= 1 && cells[0] !== "Context" && cells[0] !== "Bounded Context") {
-							bcNames.push(cells[0]);
+							bcNames.push(stripMarkdown(cells[0]));
 						}
 					}
 				}
@@ -1202,27 +918,151 @@ export default function (pi: ExtensionAPI) {
 				}
 
 				resultLines.push("", "### Next Steps");
-				resultLines.push("1. Review the module docs in .pi/architecture/modules/");
-				resultLines.push("2. Review ADR-001 in .pi/architecture/decisions/");
-				resultLines.push("3. Review the system diagram in .pi/architecture/diagrams/");
-				resultLines.push("4. Use /epic-plan --overview or /architect to plan implementation");
+				resultLines.push("1. Review ADR-001 in .pi/architecture/decisions/");
+				resultLines.push("2. Review the system diagram in .pi/architecture/diagrams/");
+				resultLines.push("3. Use /epic-plan --overview or /architect to plan implementation");
 				resultLines.push("");
-				resultLines.push("Or run through the full delivery pipeline:");
-				resultLines.push("  1. /domain --validate " + sessionId + "    (validate exploration)");
-				resultLines.push("  2. (architecture scaffold just completed)");
-				resultLines.push("  3. guardian project create --lang <lang>   (Epic 0 - greenfield only)");
-				resultLines.push("  4. /epic-plan --module <module>    (plan each module)");
+				resultLines.push("To enrich stubs with full DDD content: /domain --enrich " + sessionId);
+
+				ctx.ui.notify("Architecture scaffold complete", "success");
+				return resultLines.join("\n");
+			}
+			if (trimmed.startsWith("--enrich")) {
+				const sessionId = trimmed.slice("--enrich".length).trim();
+				if (!sessionId) {
+					ctx.ui.notify("Usage: /domain --enrich <session-id>", "error");
+					return "(domain command handled)";
+				}
+
+				const explorationDir = path.join(ctx.cwd, ".pi", "domain", "exploration");
+				const sessionPath = path.join(explorationDir, sessionId + ".md");
+				const modulesDir = path.join(ctx.cwd, ".pi", "architecture", "modules");
+
+				if (!fs.existsSync(sessionPath)) {
+					ctx.ui.notify("Session not found: " + sessionId + ". Run /domain --explore first.", "error");
+					return "(domain command handled)";
+				}
+
+				const moduleFiles = fs.readdirSync(modulesDir).filter(f => f.endsWith(".md") && f !== "module-template.md");
+				if (moduleFiles.length === 0) {
+					ctx.ui.notify("No module docs found. Run /domain --architect-scaffold " + sessionId + " first.", "error");
+					return "(domain command handled)";
+				}
+
+				ctx.ui.notify("Enriching " + moduleFiles.length + " module docs from session " + sessionId, "info");
+				const lang = readLanguage(ctx.cwd);
+
+				const enrichPrompt = [
+					"## Task: Complete Architecture Package",
+					"",
+					"The scaffold generated basic stubs. Your task is to produce a **complete, interconnected architecture package**",
+					"that an implementation agent can build from.",
+					"",
+					"**YOU MUST FOLLOW THESE 3 STEPS IN ORDER. Do not skip steps or reorder them.**",
+					"",
+					"### Source Data",
+					"",
+					"- Domain exploration: `.pi/domain/exploration/" + sessionId + ".md`",
+					"- Ubiquitous Language: `.pi/domain/ubiquitous-language.md`",
+					"- Current ADR-001: `.pi/architecture/decisions/ADR-001-architecture-pattern.md`",
+					"- System diagram: `.pi/architecture/diagrams/system-context.md`",
+					"- Module stubs: `.pi/architecture/modules/` (" + moduleFiles.length + " files)",
+					"",
+					"### STEP 1: Generate All ADRs",
+					"",
+					"**Do this first, before touching any module docs.** Module enrichment needs ADR references.",
+					"",
+					"Create these ADR files in `.pi/architecture/decisions/`:",
+					"",
+					"- ADR-001: Architecture Pattern (DDD Modular Monolith) — review and update if needed",
+					"- ADR-002: Data Storage Strategy (Postgres + SQLx per context)",
+					"- ADR-003: Cross-Context Communication (Domain Events)",
+					"- ADR-004: API Design (REST + JSON, versioning strategy)",
+					"- ADR-005: Authentication & Authorization (API Keys + Scopes)",
+					"- ADR-006: Cost Tracking & Usage Metering",
+					"- ADR-007: Compliance Engine Architecture",
+					"",
+					"Each ADR file must follow the format: **Status, Date, Context, Decision, Consequences, Alternatives**",
+					"Stop after generating ALL ADR files before proceeding.",
+					"",
+					"### STEP 2: Generate Diagrams",
+					"",
+					"**After all ADRs are created, generate diagrams.**",
+					"",
+					"#### System-Level (in `.pi/architecture/diagrams/`)",
+					"",
+					"1. Update `system-context.md` with clean names",
+					"2. Create `event-flow.md` — Mermaid flowchart showing domain events between all bounded contexts",
+					"",
+					"#### Module-Level (embedded in each module doc)",
+					"",
+					"In EACH module doc under `## Diagrams`, add these 4 mermaid diagrams:",
+					"",
+					"1. **Data Flow** — flowchart: inputs → processing → outputs → storage",
+					"2. **Entity Relationship** — classDiagram: aggregates, entities, VOs, fields, relationships",
+					"3. **Aggregate State** — stateDiagram-v2: states and transitions for each aggregate root",
+					"4. **Key Use Case Sequence** — sequenceDiagram: Actor → Interface → App → Domain → Infra",
+					"",
+					"Stop after creating diagrams before proceeding.",
+					"",
+					"### STEP 3: Enrich Each Module Doc",
+					"",
+					"**After ADRs and diagrams are done, enhance each module doc.**",
+					"",
+					"For each file in `.pi/architecture/modules/*.md`, add:",
+					"",
+					"1. **## Related ADRs** — Links to ADR files with descriptions of relevance",
+					"2. **## Diagrams** — Embed the 4 mermaid diagrams from Step 2",
+					"3. **## Components** — Expand each aggregate with " + lang + " stubs, methods, invariants keep `status:` and `depends:` markers",
+					"4. **Domain Events** — Table: Event, Description, Trigger, Payload, Published By",
+					"5. **API Endpoints** — Table: Method, Path, Handler, Input, Output, Auth",
+					"6. **Ubiquitous Language** — Terms for this context from `.pi/domain/ubiquitous-language.md`",
+					"7. **Dependencies** — Depends On + Used By",
+					"8. **Implementation Sequence** — Ordered build list",
+					"",
+					"### STEP 4: Generate Implementation Roadmap",
+					"",
+					"**After all module docs are enriched, generate the implementation roadmap.**",
+					"",
+					"Read each module doc's dependency section and create `.pi/architecture/implementation-roadmap.md`",
+					"with `## Phase N: Name (Days N-N)` sections, each having:",
+					"- Goal, Modules table, Dependencies, Database Migrations, Acceptance Criteria",
+					"",
+					"Organize phases by dependency chain:",
+					"- Phase 0: Foundation (no upstream deps)",
+					"- Phase 1: Core services depending on Phase 0",
+					"- Phase 2+: Following the dependency chain",
+					"",
+					"Also add: Dependency Graph, Effort Estimates table, Key Milestones",
+					"",
+					"### STEP 5: Fill Architecture CHANGELOG",
+					"",
+					"Read `.pi/architecture/CHANGELOG.md` and add an entry for each enriched module.",
+					"Each entry should note: Module, what was defined (aggregates, events, endpoints),",
+					"and update the Sync Status table at the bottom.",
+					"",
+					"### Scope Rules",
+					"",
+					"- CREATE new ADRs in `.pi/architecture/decisions/`",
+					"- CREATE new diagram md files in `.pi/architecture/diagrams/`",
+					"- CREATE `.pi/architecture/implementation-roadmap.md` with phased plan",
+					"- EDIT `.pi/architecture/CHANGELOG.md` — add entries for each module",
+					"- EDIT existing module docs in `.pi/architecture/modules/`",
+					"- Do NOT create any source code files",
+					"- Use " + lang + " syntax for code stubs",
+					"- Use Mermaid for all diagrams",
+				].join("\n");
 
-				// Send the results as a follow-up message so the agent sees them
 				try {
 					pi.sendMessage(
-						{ content: resultLines.join("\n"), display: true },
+						{ content: enrichPrompt, display: true },
 						{ deliverAs: "followUp", triggerTurn: true },
 					);
 				} catch (e) {
-					return resultLines.join("\n");
+					return enrichPrompt;
 				}
-				return "Architecture scaffold dispatched. Session: " + sessionId;
+				ctx.ui.notify("Enrich task dispatched to agent for " + moduleFiles.length + " modules", "success");
+				return "Enrich task dispatched. Session: " + sessionId;
 			}
 			if (trimmed.startsWith("--validate")) {
 				const sessionId = trimmed.slice("--validate".length).trim();
@@ -1262,6 +1102,7 @@ export default function (pi: ExtensionAPI) {
 					"Usage:",
 					'  /domain --explore "Business context description"',
 					"  /domain --architect-scaffold <session-id>",
+					"  /domain --enrich <session-id>",
 					"  /domain --validate <session-id>",
 				].join("\n"),
 				"info",
@@ -1276,8 +1117,11 @@ export default function (pi: ExtensionAPI) {
 				"  /domain --architect-scaffold <session-id>",
 				"    Generate architecture directories from exploration",
 				"",
+				"  /domain --enrich <session-id>",
+				"    Enrich module stubs with full DDD architecture content",
+				"",
 				"  /domain --validate <session-id>",
-				"    Validate exploration session structure",
+				"    Validate exploration session structure",}]}
 			].join("\n");
 		},
 	});

package/templates/pi/extensions/pipeline.ts

@@ -404,6 +404,7 @@ class PipelineManager {
 			this.state.status = "done";
 			this.state.currentItemIndex = this.state.items.length;
 			this.state.currentStepIndex = 0;
+			this.syncRoadmapState();
 			changed = true;
 		}
 
@@ -608,16 +609,8 @@ class PipelineManager {
 	advanceStep(): void {
 		if (!this.state) return;
 
-		// Before advancing, verify the current step's work actually happened
+		// Auto-run acceptance gates for validate steps
 		if (this.state.currentStepIndex < this.state.steps.length) {
-			const { verified, reason } = this.verifyCurrentStep();
-			if (!verified) {
-				// Reality disagrees with state — reconcile from git and refuse to advance
-				this.reconcile();
-				return; // don't advance, state was wrong
-			}
-
-			// Auto-run acceptance gates for validate steps
 			const step = this.state.steps[this.state.currentStepIndex];
 			if (step.name === "validate" && step.acceptance.type !== "none") {
 				const { allPassed, errors } = this.runAcceptanceGates(step);
@@ -661,12 +654,54 @@ class PipelineManager {
 
 			if (this.state.currentItemIndex >= this.state.items.length) {
 				this.state.status = "done";
+				this.syncRoadmapState();
 			}
 		}
 
 		savePipelineState(this.cwd, this.state);
 	}
 
+	/**
+	 * When pipeline completes, sync the roadmap state file to reflect done phases.
+	 */
+	private syncRoadmapState(): void {
+		try {
+			const roadmapPath = join(this.cwd, ".pi", ".guardian-roadmap-state.json");
+			if (!existsSync(roadmapPath)) return;
+			const raw = readFileSync(roadmapPath, "utf-8");
+			const roadmap = JSON.parse(raw) as { phases?: { index: number; status: string }[] };
+			if (!roadmap.phases) return;
+			for (const phase of roadmap.phases) {
+				const phaseModules = this.state!.items.filter((item) =>
+					item.toLowerCase().includes(`phase${phase.index}`) ||
+					this.isItemInPhase(item, phase.index)
+				);
+				const allDone = phaseModules.every((item) => {
+					const r = this.state!.results.find((res) => res.item === item);
+					return r && r.status === "done";
+				});
+				if (allDone && phaseModules.length > 0) {
+					phase.status = "done";
+				}
+			}
+			writeFileSync(roadmapPath, JSON.stringify(roadmap, null, 2));
+		} catch { /* roadmap file may not exist */ }
+	}
+
+	private isItemInPhase(item: string, phaseIndex: number): boolean {
+		try {
+			const roadmapPath = join(this.cwd, ".pi", "architecture", "implementation-roadmap.md");
+			if (!existsSync(roadmapPath)) return false;
+			const content = readFileSync(roadmapPath, "utf-8");
+			// Check if item appears under the phase section
+			const phaseSection = content.match(
+				new RegExp(`## Phase ${phaseIndex}:.*?\\n(?:.|\\n)*?(?=\\n## Phase|$)`),
+			);
+			if (!phaseSection) return false;
+			return phaseSection[0].includes(item);
+		} catch { return false; }
+	}
+
 	/**
 	 * Run acceptance gates for a step and return pass/fail.
 	 */

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-04T06:14:58Z",
+  "timestamp": "2026-07-04T06:43:47Z",
   "mode": "all",
   "stages_run": [],
   "summary": {