guardian-framework 0.1.24 → 0.1.26

package/dist/cli.js

@@ -1335,7 +1335,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.24", 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.26", 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 = {
     ".": {
@@ -9821,6 +9821,115 @@ Respond with ONLY valid JSON matching this exact structure. Do not include markd
   "aggregateRoots": "Which entities are aggregate roots and why"
 }`;
 }
+function buildFrontendExplorationPrompt(context) {
+  const sanitized = sanitizeBusinessContext(context);
+  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.
+
+Business Context:
+${sanitized}
+
+Respond with ONLY valid JSON matching this exact structure. Do not include markdown formatting, code fences, or explanatory text:
+
+{
+  "sessionId": "auto-generated-uuid",
+  "businessContext": "original description",
+  "status": "draft",
+  "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's 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 (Tailwind, MUI, custom)",
+    "theming": "How theming works (dark mode, branding)",
+    "accessibility": "Accessibility requirements"
+  }
+}`;
+}
 function parseExplorationResponse(rawResponse, sessionId) {
   try {
     let cleaned = rawResponse.trim();
@@ -9902,6 +10011,14 @@ function coerceEntityType(val) {
     return "value-object";
   if (val === "aggregate-root")
     return "aggregate-root";
+  if (val === "ui-concept")
+    return "ui-concept";
+  if (val === "user-intent")
+    return "user-intent";
+  if (val === "design-token")
+    return "design-token";
+  if (val === "app-shell")
+    return "app-shell";
   return "entity";
 }
 function coerceFrPriority(val) {
@@ -9986,8 +10103,20 @@ async function exploreDomain(context, options) {
   if (!fs.existsSync(explorationDir)) {
     fs.mkdirSync(explorationDir, { recursive: true });
   }
+  let lang = options?.language;
+  if (!lang) {
+    try {
+      const manifestPath = path.join(projectDir, "guardian-manifest.json");
+      if (fs.existsSync(manifestPath)) {
+        const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+        if (manifest.language)
+          lang = manifest.language;
+      }
+    } catch {}
+  }
   const sanitized = sanitizeBusinessContext(context);
-  const prompt = buildExplorationPrompt(sanitized);
+  const isFrontend = lang === "nextjs" || lang === "angular";
+  const prompt = isFrontend ? buildFrontendExplorationPrompt(sanitized) : buildExplorationPrompt(sanitized);
   const promptContent = [
     "# Domain Exploration Prompt",
     "",
@@ -10140,6 +10269,18 @@ function extractTable(body, sectionName) {
 function scaffoldFromExploration(sessionId, options) {
   const projectDir = options?.projectDir ?? process.cwd();
   const dryRun = options?.dryRun ?? false;
+  let lang = options?.language;
+  if (!lang) {
+    try {
+      const manifestPath = path.join(projectDir, "guardian-manifest.json");
+      if (fs.existsSync(manifestPath)) {
+        const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+        if (manifest.language)
+          lang = manifest.language;
+      }
+    } catch {}
+  }
+  const isFrontend = lang === "nextjs" || lang === "angular";
   const sessionResult = readExplorationSession(sessionId, projectDir);
   if (!sessionResult) {
     throw new Error(`Exploration session not found: ${sessionId}`);
@@ -10261,76 +10402,239 @@ function scaffoldFromExploration(sessionId, options) {
 `;
       }
     }
-    let content = `# ${bc.name}
+    let content = "";
+    if (isFrontend) {
+      const uiConcepts = contextEntities.filter((e2) => e2.type === "ui-concept");
+      const userIntents = contextEntities.filter((e2) => e2.type === "user-intent");
+      const designTokens = contextEntities.filter((e2) => e2.type === "design-token");
+      const appShells = contextEntities.filter((e2) => e2.type === "app-shell");
+      content = `# ${bc.name}
 
 `;
-    content += `## Module Status
+      content += `## Module Status
 
 `;
-    content += `**Status:** Planned
+      content += `**Status:** Planned
 `;
-    content += `**Last reviewed:** ${timestamp}
+      content += `**Last reviewed:** ${timestamp}
 `;
-    content += `**Source session:** ${sessionId}
+      content += `**Source session:** ${sessionId}
 
 `;
-    content += `## Description
+      content += `## Description
 
 ${bc.description}
 
 `;
-    content += `## Components
+      content += `## UI Concepts
 
-${componentsSection}
 `;
-    content += `## Domain Events
+      if (uiConcepts.length === 0) {
+        content += `None defined yet.
 
 `;
-    if (contextEvents.length === 0) {
-      content += `None defined yet.
+      } else {
+        for (const uc of uiConcepts) {
+          content += `### ${uc.name}
+`;
+          content += `**Description:** ${uc.description}
 
 `;
-    } else {
-      for (const ev of contextEvents) {
-        content += `- **${ev.name}** - ${ev.description} (triggered by: ${ev.triggeredBy})
+        }
+      }
+      content += `## User Intents
+
 `;
+      if (userIntents.length === 0) {
+        content += `None defined yet.
+
+`;
+      } else {
+        for (const ui of userIntents) {
+          content += `### ${ui.name}
+`;
+          content += `**Description:** ${ui.description}
+
+`;
+        }
       }
+      if (designTokens.length > 0) {
+        content += `## Design Tokens
+
+`;
+        for (const dt of designTokens) {
+          content += `- **${dt.name}** - ${dt.description}
+`;
+        }
+        content += `
+`;
+      }
+      if (appShells.length > 0) {
+        content += `## App Shell Integration
+
+`;
+        for (const as of appShells) {
+          content += `- **${as.name}** - ${as.description}
+`;
+        }
+        content += `
+`;
+      }
+      content += `## Design Principles
+
+`;
+      content += `- The Web application is not responsible for enforcing business rules.
+`;
+      content += `- The Web application is optimistic.
+`;
+      content += `- The Web application is resilient.
+`;
+      content += `- The Web application is accessible.
+`;
+      content += `- The Web application is stateless whenever possible.
+`;
+      content += `- The Web application delegates authority to Enterprise.
+`;
+      content += `- The Web application enhances productivity rather than exposing implementation details.
+`;
       content += `
 `;
-    }
-    content += `## Ubiquitous Language
+      content += `## Navigation Philosophy
+
+`;
+      content += `- The user shall never lose context.
+`;
+      content += `- Every screen belongs to a Brain. Every Brain belongs to a Workspace.
+`;
+      content += `- Every action should expose the current path.
+`;
+      content += `- Deep linking shall exist for every page.
+`;
+      content += `- Browser navigation shall always work.
+`;
+      content += `- Multiple tabs shall be supported.
+`;
+      content += `
+`;
+      content += `## Degradation Strategy
+
+`;
+      content += `- If a feature API is unavailable, navigation still works.
+`;
+      content += `- Editing still works.
+`;
+      content += `- AI features are disabled gracefully, not causing errors.
+`;
+      content += `- The application renders a degraded UI instead of crashing.
+`;
+      content += `
+`;
+      content += `## Ubiquitous Language
 
 `;
-    if (contextTerms.length === 0) {
-      content += `None defined yet.
+      if (contextTerms.length === 0) {
+        content += `None defined yet.
+
+`;
+      } else {
+        content += `| Term | Definition | Aliases |
+`;
+        content += `|------|-----------|---------|
+`;
+        for (const t of contextTerms) {
+          content += `| ${t.term} | ${t.definition} | ${t.aliases.join(", ")} |
+`;
+        }
+        content += `
+`;
+      }
+      content += `## Dependencies
+
+`;
+      content += `${depsSection}
+`;
+      content += `## Key Files
+
+None yet
+
+`;
+      content += `## ADRs
+
+None yet
 
 `;
     } else {
-      content += `| Term | Definition | Aliases |
+      content = `# ${bc.name}
+
 `;
-      content += `|------|-----------|---------|
+      content += `## Module Status
+
+`;
+      content += `**Status:** Planned
+`;
+      content += `**Last reviewed:** ${timestamp}
 `;
-      for (const t of contextTerms) {
-        content += `| ${t.term} | ${t.definition} | ${t.aliases.join(", ")} |
+      content += `**Source session:** ${sessionId}
+
+`;
+      content += `## Description
+
+${bc.description}
+
+`;
+      content += `## Components
+
+${componentsSection}
+`;
+      content += `## Domain Events
+
+`;
+      if (contextEvents.length === 0) {
+        content += `None defined yet.
+
+`;
+      } else {
+        for (const ev of contextEvents) {
+          content += `- **${ev.name}** - ${ev.description} (triggered by: ${ev.triggeredBy})
+`;
+        }
+        content += `
 `;
       }
-      content += `
+      content += `## Ubiquitous Language
+
 `;
-    }
-    content += `## Dependencies
+      if (contextTerms.length === 0) {
+        content += `None defined yet.
+
+`;
+      } else {
+        content += `| Term | Definition | Aliases |
+`;
+        content += `|------|-----------|---------|
+`;
+        for (const t of contextTerms) {
+          content += `| ${t.term} | ${t.definition} | ${t.aliases.join(", ")} |
+`;
+        }
+        content += `
+`;
+      }
+      content += `## Dependencies
 
 ${depsSection}
 `;
-    content += `## Key Files
+      content += `## Key Files
 
 None yet
 
 `;
-    content += `## ADRs
+      content += `## ADRs
 
 None yet
 
 `;
+    }
     if (!dryRun) {
       fs.mkdirSync(modulesDir, { recursive: true });
       const tempPath = `${filePath}.tmp`;