@aisdlc/core 1.3.0 → 1.3.2

package/dist/index.js

@@ -722,6 +722,12 @@ function walkMdFiles(dir, fileList = [], excludeDirs = [
   "node_modules",
   ".git",
   "dist",
+  "bin",
+  "obj",
+  "build",
+  "out",
+  "target",
+  "coverage",
   ".changeset",
   "scratch",
   "test-scaffold",
@@ -733,7 +739,9 @@ function walkMdFiles(dir, fileList = [], excludeDirs = [
   ".claude",
   ".cursor",
   ".github",
-  ".vscode"
+  ".vscode",
+  ".vs",
+  ".idea"
 ]) {
   try {
     if (!fs6.existsSync(dir)) return fileList;
@@ -2052,6 +2060,7 @@ var TYPE_TO_SCHEMA_MAP = {
   "security-requirement": "schemas/security/security-req.schema.json",
   "threat-actor": "schemas/security/threat-actor.schema.json",
   // Architecture
+  "architecture-introduction": "schemas/architecture/introduction-and-goals.schema.json",
   "architecture-decision-record": "schemas/architecture/adr.schema.json",
   component: "schemas/architecture/component.schema.json",
   // Safety
@@ -2095,6 +2104,7 @@ var PREFIX_TAXONOMY = [
   ["HAZ-", "hazard"],
   ["SAF-REQ-", "safety-requirement"],
   ["SAF-", "safety-requirement"],
+  ["ARCH-INTRO-", "architecture-introduction"],
   ["ADR-", "architecture-decision-record"],
   ["CMP-", "component"],
   ["MAN-USER-", "user-manual"],
@@ -3284,10 +3294,18 @@ var SKIPPED_DIR_NAMES = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
   "dist",
+  "bin",
+  "obj",
+  "build",
+  "out",
+  "target",
+  "coverage",
   "scratch",
   "fixtures",
   "templates",
-  "examples"
+  "examples",
+  ".vs",
+  ".idea"
 ]);
 function shouldSkipDir(name) {
   return SKIPPED_DIR_NAMES.has(name) || name.startsWith("temp-");
@@ -3389,8 +3407,14 @@ function verifyTraceability(options = {}) {
           });
         }
       }
-      if (relFile.includes("architecture/") || relFile.includes("06_runtime_view") || relFile.includes("08_security_concept") || relFile.includes("09_decisions")) {
-        architectureViews.push({ file: relFile, content });
+      const isArchIntro = frontmatter.type === "architecture-introduction" || frontmatter.id !== void 0 && String(frontmatter.id).trim().startsWith("ARCH-INTRO-");
+      if (!isArchIntro && (relFile.includes("architecture/") || relFile.includes("06_runtime_view") || relFile.includes("08_security_concept") || relFile.includes("09_decisions"))) {
+        architectureViews.push({
+          file: relFile,
+          id: frontmatter.id ? String(frontmatter.id).trim() : void 0,
+          type: typeof frontmatter.type === "string" ? frontmatter.type.trim() : void 0,
+          content
+        });
       }
     } catch {
     }
@@ -3473,6 +3497,14 @@ function verifyTraceability(options = {}) {
         productTraces.push(...associatedHandoff.subgraph.abuseCases);
       }
     }
+    for (const [artId, artEntry] of artifactMap.entries()) {
+      if (artEntry.type === "architecture-introduction" || artId.startsWith("ARCH-INTRO-")) {
+        const citedGoals = artEntry.frontmatter["cites-quality-goals"];
+        if (Array.isArray(citedGoals) && citedGoals.includes(reqId)) {
+          productTraces.push(artId);
+        }
+      }
+    }
     const validProductTraces = Array.from(
       new Set(productTraces.filter((id) => artifactMap.has(id)))
     );
@@ -3493,8 +3525,9 @@ function verifyTraceability(options = {}) {
     }
     for (const view of architectureViews) {
       if (view.content.includes(reqId)) {
-        const viewName = path8.basename(view.file);
-        if (!archTraces.includes(viewName)) archTraces.push(viewName);
+        const isEntityWithId = view.type === "component" || view.type === "adr" || view.type === "architecture-decision-record" || view.type === "security-enclave" || view.id !== void 0 && (view.id.startsWith("CMP-") || view.id.startsWith("ADR-") || view.id.startsWith("SEC-ENC-"));
+        const viewIdentifier = isEntityWithId && view.id ? view.id : path8.basename(view.file);
+        if (!archTraces.includes(viewIdentifier)) archTraces.push(viewIdentifier);
       }
     }
     const uniqueArchTraces = Array.from(new Set(archTraces));
@@ -3831,7 +3864,7 @@ function scanAllTestArtifacts(rootDir) {
     for (const e of entries) {
       const fullPath = path8.join(dir, e.name);
       if (e.isDirectory()) {
-        if (!["node_modules", ".git", "dist", ".changeset", "scratch", "fixtures", "templates", "examples"].includes(e.name)) {
+        if (!["node_modules", ".git", "dist", "bin", "obj", "build", "out", "target", "coverage", ".changeset", "scratch", "fixtures", "templates", "examples", ".vs", ".idea"].includes(e.name)) {
           walk(fullPath);
         }
       } else {
@@ -7136,7 +7169,31 @@ function buildGraphElements(rootDir = process.cwd()) {
   for (const n of pdac.drifts) {
     driftTargets.add(n.targetId);
   }
+  const NON_GRAPH_TYPES = /* @__PURE__ */ new Set([
+    "term",
+    "handoff",
+    "agent-handoff",
+    "tasks",
+    "task-plan",
+    "spec-change-proposal",
+    "proposal",
+    "spec-design",
+    "spec-change-design",
+    "design",
+    "delivery-spec",
+    "spec",
+    "pre-merge-audit-report",
+    "user-design-feedback",
+    "release-kpis",
+    "session-telemetry",
+    "license-manifest",
+    "mcp-config",
+    "user-manual",
+    "production-manual",
+    "architecture-glossary"
+  ]);
   const scannedArtifactsMap = /* @__PURE__ */ new Map();
+  const archViewByBasename = /* @__PURE__ */ new Map();
   const artifactDirs = ["product", "architecture", "specs", "security"];
   for (const dirName of artifactDirs) {
     const fullDirPath = path8.join(rootDir, dirName);
@@ -7146,6 +7203,7 @@ function buildGraphElements(rootDir = process.cwd()) {
         try {
           const fileContent = fs6.readFileSync(f, "utf-8");
           const relPath = path8.relative(rootDir, f).replace(/\\/g, "/");
+          if (relPath.includes("/changes/") || relPath.startsWith("changes/")) continue;
           const match = fileContent.match(/^---\r?\n([\s\S]*?)\r?\n---/);
           if (!match) continue;
           let fm = {};
@@ -7157,8 +7215,14 @@ function buildGraphElements(rootDir = process.cwd()) {
           const id = typeof fm.id === "string" ? fm.id.trim() : void 0;
           if (!id) continue;
           let type = typeof fm.type === "string" ? fm.type.trim() : "";
+          if (NON_GRAPH_TYPES.has(type) || id.startsWith("TERM-") || id.startsWith("HOF-") || id.startsWith("AHOF-") || id.startsWith("CHG-") || id.startsWith("DSG-") || id.startsWith("SPEC-") || id.startsWith("TSK-") || id.startsWith("UDF-") || id.startsWith("AUDIT-")) {
+            continue;
+          }
           let layer = "product";
-          if (id.startsWith("JRN-") || type === "journey") {
+          if (id.startsWith("ARCH-INTRO-") || type === "architecture-introduction") {
+            type = "architecture-introduction";
+            layer = "product";
+          } else if (id.startsWith("JRN-") || type === "journey") {
             type = "journey";
             layer = "product";
           } else if (id.startsWith("ACT-THREAT-") || type === "threat-actor") {
@@ -7191,16 +7255,19 @@ function buildGraphElements(rootDir = process.cwd()) {
           } else if (id.startsWith("SEC-REQ-") || type === "security-requirement") {
             type = "security-requirement";
             layer = "requirement";
-          } else if (id.startsWith("FR-") || id.startsWith("QR-") || id.startsWith("CON-") || type === "requirement") {
+          } else if (id.startsWith("FR-") || id.startsWith("QR-") || id.startsWith("CON-") || type === "requirement" || type === "functional-requirement" || type === "quality-requirement") {
             type = "requirement";
             layer = "requirement";
+          } else if (id.startsWith("ARCH-") || relPath.includes("architecture/")) {
+            type = "architecture";
+            layer = "architecture";
           } else {
             type = type || "product";
             layer = "product";
           }
           const title = typeof fm.title === "string" ? fm.title.trim() : id;
           const content = fileContent.replace(/^---\r?\n[\s\S]*?\r?\n---/, "").trim();
-          scannedArtifactsMap.set(id, {
+          const scannedArt = {
             id,
             type,
             title,
@@ -7208,7 +7275,12 @@ function buildGraphElements(rootDir = process.cwd()) {
             filePath: relPath,
             content,
             frontmatter: fm
-          });
+          };
+          if (layer === "architecture" && type === "architecture") {
+            archViewByBasename.set(path8.basename(relPath), scannedArt);
+          } else {
+            scannedArtifactsMap.set(id, scannedArt);
+          }
         } catch {
         }
       }
@@ -7217,7 +7289,7 @@ function buildGraphElements(rootDir = process.cwd()) {
   for (const r of trace.rows) {
     const isOk = (r.productStatus === "COMPLIANT" || r.productStatus === "CONFORME") && (r.archStatus === "COMPLIANT" || r.archStatus === "CONFORME") && (r.testStatus === "COMPLIANT" || r.testStatus === "CONFORME");
     const status = isOk ? "COMPLIANT" : "ORPHAN";
-    const reqType = r.id.startsWith("SEC-REQ-") ? "security-requirement" : r.type || "requirement";
+    const reqType = r.id.startsWith("SEC-REQ-") ? "security-requirement" : "requirement";
     nodeMap.set(r.id, {
       id: r.id,
       label: r.id,
@@ -7243,16 +7315,18 @@ function buildGraphElements(rootDir = process.cwd()) {
       const u = up.trim();
       if (u && u !== "NINGUNO" && u !== "NONE") {
         const isAbuse = u.startsWith("ABUSE-");
+        const isArchIntro = u.startsWith("ARCH-INTRO-");
+        const rel = isAbuse ? "mitigated-by" : isArchIntro ? "defines-goal" : "derives-from";
         addEdge({
           id: `edge-${u}-${r.id}`,
           source: u,
           target: r.id,
-          label: isAbuse ? "mitigated-by" : "derives-from",
-          relation: isAbuse ? "mitigated-by" : "derives-from",
+          label: rel,
+          relation: rel,
           status
         });
         if (!nodeMap.has(u)) {
-          const upType = u.startsWith("ACT-") ? "actor" : u.startsWith("UC-") ? "use-case" : u.startsWith("BR-") ? "business-rule" : u.startsWith("ABUSE-") ? "abuse-case" : "product";
+          const upType = u.startsWith("ARCH-INTRO-") ? "architecture-introduction" : u.startsWith("ACT-") ? "actor" : u.startsWith("UC-") ? "use-case" : u.startsWith("BR-") ? "business-rule" : u.startsWith("ABUSE-") ? "abuse-case" : "product";
           nodeMap.set(u, {
             id: u,
             label: u,
@@ -7277,13 +7351,16 @@ function buildGraphElements(rootDir = process.cwd()) {
         });
         if (!nodeMap.has(a)) {
           const aType = a.startsWith("CMP-") ? "component" : a.startsWith("ADR-") ? "adr" : a.startsWith("SEC-ENC-") ? "security-enclave" : "architecture";
+          const viewArt = archViewByBasename.get(a);
           nodeMap.set(a, {
             id: a,
             label: a,
-            title: a,
+            title: viewArt?.title || a,
             type: aType,
             layer: "architecture",
-            status: "COMPLIANT"
+            status: "COMPLIANT",
+            filePath: viewArt?.filePath,
+            content: viewArt?.content
           });
         }
       }
@@ -7347,7 +7424,80 @@ function buildGraphElements(rootDir = process.cwd()) {
   }
   for (const art of scannedArtifactsMap.values()) {
     const fm = art.frontmatter;
-    if (art.type === "journey") {
+    if (art.type === "architecture-introduction") {
+      const citedActors = Array.isArray(fm["cites-product-actors"]) ? fm["cites-product-actors"] : [];
+      for (const actId of citedActors) {
+        if (typeof actId === "string" && actId.trim()) {
+          const a = actId.trim();
+          if (!nodeMap.has(a)) {
+            nodeMap.set(a, {
+              id: a,
+              label: a,
+              title: a,
+              type: "actor",
+              layer: "product",
+              status: "COMPLIANT"
+            });
+          }
+          addEdge({
+            id: `edge-${art.id}-${a}`,
+            source: art.id,
+            target: a,
+            label: "identifies",
+            relation: "identifies",
+            status: "COMPLIANT"
+          });
+        }
+      }
+      const citedUcs = Array.isArray(fm["cites-use-cases"]) ? fm["cites-use-cases"] : [];
+      for (const ucId of citedUcs) {
+        if (typeof ucId === "string" && ucId.trim()) {
+          const u = ucId.trim();
+          if (!nodeMap.has(u)) {
+            nodeMap.set(u, {
+              id: u,
+              label: u,
+              title: u,
+              type: "use-case",
+              layer: "product",
+              status: "COMPLIANT"
+            });
+          }
+          addEdge({
+            id: `edge-${art.id}-${u}`,
+            source: art.id,
+            target: u,
+            label: "envisions",
+            relation: "envisions",
+            status: "COMPLIANT"
+          });
+        }
+      }
+      const citedGoals = Array.isArray(fm["cites-quality-goals"]) ? fm["cites-quality-goals"] : [];
+      for (const qrId of citedGoals) {
+        if (typeof qrId === "string" && qrId.trim()) {
+          const q = qrId.trim();
+          if (!nodeMap.has(q)) {
+            nodeMap.set(q, {
+              id: q,
+              label: q,
+              title: q,
+              type: q.startsWith("SEC-REQ-") ? "security-requirement" : "requirement",
+              layer: "requirement",
+              status: "COMPLIANT"
+            });
+          }
+          addEdge({
+            id: `edge-${art.id}-${q}`,
+            source: art.id,
+            target: q,
+            label: "defines-goal",
+            relation: "defines-goal",
+            status: "COMPLIANT"
+          });
+        }
+      }
+    } else if (art.type === "journey") {
       const persona = typeof fm.persona === "string" ? fm.persona : typeof fm.actor === "string" ? fm.actor : void 0;
       if (persona) {
         if (!nodeMap.has(persona)) {
@@ -7415,7 +7565,31 @@ function buildGraphElements(rootDir = process.cwd()) {
           status: "COMPLIANT"
         });
       }
-      const governedBy = Array.isArray(fm["governed-by"]) ? fm["governed-by"] : [];
+      const supportingActors = Array.isArray(fm["supporting-actors"]) ? fm["supporting-actors"] : Array.isArray(fm["secondary-actors"]) ? fm["secondary-actors"] : [];
+      for (const actorId of supportingActors) {
+        if (typeof actorId === "string" && actorId.trim()) {
+          const a = actorId.trim();
+          if (!nodeMap.has(a)) {
+            nodeMap.set(a, {
+              id: a,
+              label: a,
+              title: a,
+              type: "actor",
+              layer: "product",
+              status: "COMPLIANT"
+            });
+          }
+          addEdge({
+            id: `edge-${a}-${art.id}`,
+            source: a,
+            target: art.id,
+            label: "initiates",
+            relation: "initiates",
+            status: "COMPLIANT"
+          });
+        }
+      }
+      const governedBy = Array.isArray(fm["governed-by"]) ? fm["governed-by"] : Array.isArray(fm["business-rules"]) ? fm["business-rules"] : [];
       for (const ruleId of governedBy) {
         if (typeof ruleId === "string" && ruleId.trim()) {
           const r = ruleId.trim();
@@ -7476,7 +7650,31 @@ function buildGraphElements(rootDir = process.cwd()) {
           status: "COMPLIANT"
         });
       }
-      const rawTargets = fm["targets-use-case"] ? [fm["targets-use-case"]] : Array.isArray(fm["targets-use-cases"]) ? fm["targets-use-cases"] : Array.isArray(fm["targets"]) ? fm["targets"] : [];
+      const secondaryThreatActors = Array.isArray(fm["secondary-actors"]) ? fm["secondary-actors"] : Array.isArray(fm["supporting-actors"]) ? fm["supporting-actors"] : [];
+      for (const secActor of secondaryThreatActors) {
+        if (typeof secActor === "string" && secActor.trim()) {
+          const sa = secActor.trim();
+          if (!nodeMap.has(sa)) {
+            nodeMap.set(sa, {
+              id: sa,
+              label: sa,
+              title: sa,
+              type: sa.startsWith("ACT-THREAT-") ? "threat-actor" : "actor",
+              layer: "product",
+              status: "COMPLIANT"
+            });
+          }
+          addEdge({
+            id: `edge-${sa}-${art.id}`,
+            source: sa,
+            target: art.id,
+            label: "threatens",
+            relation: "threatens",
+            status: "COMPLIANT"
+          });
+        }
+      }
+      const rawTargets = Array.isArray(fm["targets-use-case"]) ? fm["targets-use-case"] : typeof fm["targets-use-case"] === "string" ? [fm["targets-use-case"]] : Array.isArray(fm["targets-use-cases"]) ? fm["targets-use-cases"] : Array.isArray(fm["targets"]) ? fm["targets"] : [];
       for (const tgt of rawTargets) {
         if (typeof tgt === "string" && tgt.trim()) {
           const t = tgt.trim();
@@ -7541,6 +7739,40 @@ function buildGraphElements(rootDir = process.cwd()) {
           });
         }
       }
+    } else if (art.type === "adr") {
+      const affectedComponents = Array.isArray(fm["affects-components"]) ? fm["affects-components"] : typeof fm["affects-components"] === "string" ? [fm["affects-components"]] : [];
+      for (const cmpId of affectedComponents) {
+        if (typeof cmpId === "string" && cmpId.trim()) {
+          const c = cmpId.trim();
+          if (nodeMap.has(c)) {
+            addEdge({
+              id: `edge-${art.id}-${c}`,
+              source: art.id,
+              target: c,
+              label: "governs",
+              relation: "governs",
+              status: "COMPLIANT"
+            });
+          }
+        }
+      }
+    } else if (art.type === "security-enclave") {
+      const enforcedBy = Array.isArray(fm["enforced-by"]) ? fm["enforced-by"] : typeof fm["enforced-by"] === "string" ? [fm["enforced-by"]] : [];
+      for (const secReq of enforcedBy) {
+        if (typeof secReq === "string" && secReq.trim()) {
+          const s = secReq.trim();
+          if (nodeMap.has(s)) {
+            addEdge({
+              id: `edge-${s}-${art.id}`,
+              source: s,
+              target: art.id,
+              label: "satisfies",
+              relation: "satisfies",
+              status: "COMPLIANT"
+            });
+          }
+        }
+      }
     }
   }
   for (const [id, node] of nodeMap.entries()) {
@@ -7690,6 +7922,9 @@ function collectDashboardMetrics(rootDir) {
 function escapeHtml(str) {
   return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
+function safeJsonForScript(data) {
+  return JSON.stringify(data).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
 function renderAutonomyModeSection(mode, statusIcon, count, roleDescription, allTasks = []) {
   const modeTasks = (allTasks || []).filter(
     (t) => (t.task?.autonomyMode || "").toUpperCase() === mode
@@ -7801,14 +8036,14 @@ function renderAutonomyModeSection(mode, statusIcon, count, roleDescription, all
 }
 function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard Interactivo de Trazabilidad y Calidad") {
   const cytoscapeScript = getCytoscapeScript();
-  const elementsJson = JSON.stringify(graphData.elements);
+  const elementsJson = safeJsonForScript(graphData.elements);
   const now = (/* @__PURE__ */ new Date()).toISOString();
   return `<!DOCTYPE html>
 <html lang="es">
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${title}</title>
+  <title>${escapeHtml(title)}</title>
   <style>
     :root {
       --bg-dark: #0f172a;
@@ -8111,6 +8346,7 @@ function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard
           <div class="tool-row">
             <select id="type-filter" class="tool-select" onchange="filterType(this.value)">
               <option value="all">All Typologies</option>
+              <option value="architecture-introduction">Vision &amp; Goals (ARCH-INTRO)</option>
               <option value="journey">Journeys (JRN)</option>
               <option value="actor">Actors (ACT)</option>
               <option value="use-case">Use Cases (UC)</option>
@@ -8145,6 +8381,7 @@ function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard
         <div class="graph-legend">
           <div class="legend-header">Node Typologies</div>
           <div class="legend-items">
+            <div class="legend-item"><span class="legend-dot" style="background:#0f766e; border:2px solid #2dd4bf;"></span><strong>Vision / Goals</strong> (ARCH-INTRO)</div>
             <div class="legend-item"><span class="legend-dot" style="background:#581c87; border:2px solid #c084fc;"></span><strong>Journey</strong> (JRN)</div>
             <div class="legend-item"><span class="legend-dot" style="background:#065f46; border:2px solid #34d399; border-radius:50%;"></span><strong>Actor</strong> (ACT)</div>
             <div class="legend-item"><span class="legend-dot" style="background:#0369a1; border:2px solid #38bdf8;"></span><strong>Use Case</strong> (UC)</div>
@@ -8183,12 +8420,12 @@ function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard
             ${metricsData.trace.rows.map((r) => {
     const isRowOk = (r.productStatus === "COMPLIANT" || r.productStatus === "CONFORME") && (r.archStatus === "COMPLIANT" || r.archStatus === "CONFORME") && (r.testStatus === "COMPLIANT" || r.testStatus === "CONFORME");
     return `
-              <tr onclick="focusNode('${r.id}')" onmouseenter="startRowTooltip(event, '${r.id}')" onmouseleave="cancelRowTooltip()" onmousemove="updateRowTooltipPos(event)" style="cursor: pointer;">
-                <td><strong><code>${r.id}</code></strong></td>
-                <td>${r.title}</td>
-                <td><code>${r.productTraces}</code></td>
-                <td><code>${r.archTraces}</code></td>
-                <td><code>${r.testTraces}</code></td>
+              <tr onclick="focusNode('${escapeHtml(String(r.id || ""))}')" onmouseenter="startRowTooltip(event, '${escapeHtml(String(r.id || ""))}')" onmouseleave="cancelRowTooltip()" onmousemove="updateRowTooltipPos(event)" style="cursor: pointer;">
+                <td><strong><code>${escapeHtml(String(r.id || ""))}</code></strong></td>
+                <td>${escapeHtml(String(r.title || ""))}</td>
+                <td><code>${escapeHtml(String(r.productTraces || ""))}</code></td>
+                <td><code>${escapeHtml(String(r.archTraces || ""))}</code></td>
+                <td><code>${escapeHtml(String(r.testTraces || ""))}</code></td>
                 <td><span class="badge ${isRowOk ? "badge-green" : "badge-amber"}">${isRowOk ? "COMPLIANT" : "ORPHAN"}</span></td>
               </tr>
             `;
@@ -8401,7 +8638,7 @@ function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard
   </script>
   <script>
     var elements = ${elementsJson};
-    var govTasks = ${JSON.stringify(metricsData.gov.tasks || [])};
+    var govTasks = ${safeJsonForScript(metricsData.gov.tasks || [])};
     var cy = null;
 
     var reqHoverTimer = null;
@@ -8564,6 +8801,19 @@ function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard
             }
           },
           // Typology Styles
+          {
+            selector: 'node.type-architecture-introduction',
+            style: {
+              'shape': 'round-rectangle',
+              'background-color': '#0f766e',
+              'border-color': '#2dd4bf',
+              'border-width': 3,
+              'width': 92,
+              'height': 44,
+              'font-weight': 'bold',
+              'text-max-width': '86px'
+            }
+          },
           {
             selector: 'node.type-journey',
             style: {
@@ -8680,7 +8930,7 @@ function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard
           },
           // Fallback Layer styles if type is missing
           {
-            selector: 'node.layer-product:not(.type-journey):not(.type-actor):not(.type-use-case):not(.type-usecase):not(.type-business-rule):not(.type-rule):not(.type-abuse-case):not(.type-threat-actor)',
+            selector: 'node.layer-product:not(.type-architecture-introduction):not(.type-journey):not(.type-actor):not(.type-use-case):not(.type-usecase):not(.type-business-rule):not(.type-rule):not(.type-abuse-case):not(.type-threat-actor)',
             style: { 'shape': 'diamond', 'background-color': '#0e7490', 'border-color': '#38bdf8', 'width': 50, 'height': 50 }
           },
           {
@@ -8709,6 +8959,10 @@ function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard
             }
           },
           // Semantic Edge Relations
+          {
+            selector: 'edge.relation-identifies, edge.relation-envisions, edge.relation-defines-goal',
+            style: { 'line-color': '#2dd4bf', 'target-arrow-color': '#2dd4bf', 'width': 2 }
+          },
           {
             selector: 'edge.relation-pursues',
             style: { 'line-color': '#c084fc', 'target-arrow-color': '#c084fc', 'width': 2 }
@@ -8849,7 +9103,10 @@ function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard
         var typeName = (data.type || data.layer || 'node').toLowerCase();
         var typeBadgeColor = '#334155';
         var typeTitle = (data.type || data.layer || 'NODE').toUpperCase();
-        if (typeName === 'journey') {
+        if (typeName === 'architecture-introduction') {
+          typeBadgeColor = '#0f766e';
+          typeTitle = 'VISION & GOALS (ARCH-INTRO)';
+        } else if (typeName === 'journey') {
           typeBadgeColor = '#581c87';
           typeTitle = 'JOURNEY (JRN)';
         } else if (typeName === 'actor') {
@@ -8915,6 +9172,11 @@ function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard
       if (!cy) return;
       if (type === 'all') {
         cy.elements().show();
+      } else if (type === 'architecture-introduction') {
+        cy.elements().hide();
+        var nodes = cy.nodes('.type-architecture-introduction');
+        nodes.show();
+        nodes.connectedEdges().show();
       } else if (type === 'journey') {
         cy.elements().hide();
         var nodes = cy.nodes('.type-journey');
@@ -9034,9 +9296,10 @@ function renderDashboardHtml(graphData, metricsData, title = "AI-SDLC: Dashboard
 
     function switchTab(name) {
       hideTooltip();
-      document.querySelectorAll('.tab-btn').forEach(function(b) { b.classList.remove('active'); });
+      document.querySelectorAll('.tab-btn').forEach(function(b) {
+        b.classList.toggle('active', b.getAttribute('onclick') === "switchTab('" + name + "')");
+      });
       document.querySelectorAll('.tab-panel').forEach(function(p) { p.classList.remove('active'); });
-      event.target?.classList?.add('active');
       var p = document.getElementById('tab-' + name);
       if (p) p.classList.add('active');
       if (name === 'graph' && cy) {
@@ -9250,14 +9513,20 @@ var SPECIALIZED_AGENT_TEMPLATES = [
   {
     id: "agent-product-analyst",
     title: "Product Analyst / Scribe",
-    description: "Assist the human Product Owner in exploring, modeling, and refining product definition using ProductShape (ACT-*, UC-*, FR-*, QR-*, BR-*).",
-    globs: "product/**, specs/product/**, templates/product/**",
+    description: "Assist the human Product Owner in exploring, modeling, and refining product definition using NAF v4 Enterprise & Capability Vision (ARCH-INTRO-*) and ProductShape (ACT-*, UC-*, FR-*, QR-*, BR-*).",
+    globs: "product/**, specs/product/**, templates/product/**, templates/architecture/introduction-and-goals.template.md",
     body: `## Role & Mission
 - **Role**: Product Analyst Agent (\`agent-product-analyst\`) and Technical Scribe (AI as Scribe) of the AI-SDLC framework.
-- **Mission**: Transform natural language business intent into canonical ProductShape artifacts (\`ACT-*\`, \`JRN-*\`, \`UC-*\`, \`BR-*\`, \`TERM-*\`, \`FR-*\`, \`QR-*\`) 100% compliant with JSON schemas.
+- **Mission**: Capture new product intent via NAF v4 Enterprise & Capability Vision (\`ARCH-INTRO-*\`) and transform natural language business intent into canonical ProductShape artifacts (\`ACT-*\`, \`JRN-*\`, \`UC-*\`, \`BR-*\`, \`TERM-*\`, \`FR-*\`, \`QR-*\`) 100% compliant with JSON schemas.
+
+## Phase 0: Greenfield Product Inception (New Product Intent)
+- **Trigger**: When the user expresses intent to create a new product from scratch with the framework (or when \`specs/product/\` has no baseline product model yet), initiate **Phase 0** before any SDD change (\`change:new\`) or implementation:
+  1. **Structured Discovery Interview (3\u20135 Questions)**: Ask a concise 3\u20135 question interview to clarify: (a) core problem and mission statement, (b) primary actors/stakeholders (\`ACT-*\`), (c) essential MVP capabilities/use cases (\`UC-*\`), and (d) top 3\u20135 priority quality goals and constraints (\`QR-*\`, \`CON-*\`).
+  2. **Enterprise & Capability Vision (\`ARCH-INTRO-001\`)**: Draft the root vision artifact (\`type: architecture-introduction\`, \`naf-perspective: "Enterprise & Capability"\`, \`status: draft\`) using \`templates/architecture/introduction-and-goals.template.md\` (\`schemas/architecture/introduction-and-goals.schema.json\`).
+  3. **ProductShape Derivation**: Derive the initial draft artifacts (\`ACT-*\`, \`UC-*\`, \`BR-*\`, \`FR-*\`, \`QR-*\` with \`status: draft\`) in \`specs/product/\` linked to \`ARCH-INTRO-001\` for human Product Owner review.
 
 ## Operational Directives & Guardrails
-- Every generated artifact must strictly adhere to the canonical Markdown and YAML frontmatter format in \`schemas/product/\`.
+- Every generated artifact must strictly adhere to the canonical Markdown and YAML frontmatter format in \`schemas/product/\` and \`schemas/architecture/introduction-and-goals.schema.json\`.
 - \`status\` ALWAYS starts as \`draft\`. Creating artifacts directly as \`active\` or \`approved\` is forbidden.
 - Always write relationships in their single canonical direction (\`derives-from: [UC-*]\`, \`primary-actor: ACT-*\`).
 - In \`UC-*\`, format section \`1. Intent and Outcome\` under the standard English structure: \`As a <ACT-ID>... I want <action>... To <outcome>...\`.
@@ -9505,9 +9774,10 @@ This file defines the operational rules and specialized role mappings for Google
 ## 2. Specialized Roles Mapping
 
 ### 1. \`agent-product-analyst\` (Product Analyst / Scribe)
-- **Mission**: Assist in defining and refining the product model using ProductShape.
+- **Mission**: Capture new product intent via NAF v4 Enterprise & Capability Vision (\`ARCH-INTRO-*\`) and define/refine the product model using ProductShape.
+- **Phase 0 (Greenfield Product Inception)**: When creating a new product from scratch (or when \`specs/product/\` has no baseline), run a concise 3\u20135 question discovery interview (mission/problem, actors \`ACT-*\`, MVP capabilities \`UC-*\`, priority quality goals \`QR-*\`), draft \`ARCH-INTRO-001\` (\`templates/architecture/introduction-and-goals.template.md\`), and derive initial \`ACT-*\`, \`UC-*\`, \`BR-*\`, \`FR-*\`, and \`QR-*\` drafts.
 - **Input**: Business intent or natural language specification.
-- **Output**: Markdown artifacts with YAML frontmatter compliant with \`schemas/product/\` (\`ACT-*\`, \`UC-*\`, \`FR-*\`, \`QR-*\`, \`BR-*\`).
+- **Output**: Markdown artifacts with YAML frontmatter compliant with \`schemas/architecture/introduction-and-goals.schema.json\` (\`ARCH-INTRO-*\`) and \`schemas/product/\` (\`ACT-*\`, \`UC-*\`, \`FR-*\`, \`QR-*\`, \`BR-*\`).
 - **Guardrails**:
   - \`status\` always starts in \`draft\`.
   - In \`UC-*\`, format section \`1. Intent and Outcome\` under the standard English structure: \`As a <ACT-ID>... I want <action>... To <outcome>...\`.
@@ -9638,7 +9908,7 @@ Before finalizing changes or proposing commits:
 ## 4. Specialized Roles Mapping
 | Role | Mission (summary) |
 | :--- | :--- |
-| \`agent-product-analyst\` | ProductShape artifacts (\`ACT-*\`, \`UC-*\`, \`FR-*\`, \`QR-*\`, \`BR-*\`); status starts \`draft\`. |
+| \`agent-product-analyst\` | Phase 0 NAF v4 Enterprise & Capability Vision (\`ARCH-INTRO-*\`, 3\u20135 question interview) + ProductShape artifacts (\`ACT-*\`, \`UC-*\`, \`FR-*\`, \`QR-*\`, \`BR-*\`); status starts \`draft\`. |
 | \`agent-threat-modeler\` | STRIDE/OWASP threat triad (\`ACT-THREAT-*\`, \`ABUSE-*\`, \`SEC-REQ-*\`). |
 | \`agent-system-architect\` | Modular arc42 + NAF v4 architecture (\`CMP-*\`, Mermaid diagrams, \`ADR-*\`). |
 | \`agent-qa-engineer\` | FAILING BDD/Gherkin suites before \`agent-developer\` writes code. |
@@ -9673,6 +9943,7 @@ Canonical Reference: [\`process/09_agent_protocols.md\`](process/09_agent_protoc
 
 ## 1. Identifier Taxonomy and JSON Schemas
 Every generated or modified artifact must follow canonical naming and satisfy its schema in \`schemas/\`:
+- Enterprise & Capability Vision (Phase 0): \`ARCH-INTRO-[NUM3]\` (\`schemas/architecture/introduction-and-goals.schema.json\`)
 - Product Actors: \`ACT-[SUFFIX]\` (\`schemas/product/actor.schema.json\`)
 - Use Cases: \`UC-[SUFFIX]\` (\`schemas/product/use-case.schema.json\`)
 - Functional Requirements: \`FR-[SUFFIX]-[NUM3]\` (\`schemas/product/requirement.schema.json\`)
@@ -9683,6 +9954,7 @@ Every generated or modified artifact must follow canonical naming and satisfy it
 - Security Requirements: \`SEC-REQ-[SUFFIX]\` (\`schemas/security/security-req.schema.json\`)
 
 ## 2. "AI as Scribe" Protocol Rules
+- **Phase 0 (New Product Inception)**: When starting a new product, conduct a 3\u20135 question discovery interview, instantiate \`ARCH-INTRO-001\` (\`naf-perspective: "Enterprise & Capability"\`) in \`draft\`, and derive \`ACT-*\`, \`UC-*\`, \`BR-*\`, \`FR-*\`, and \`QR-*\`.
 - **Initial Status**: Every new artifact strictly starts with \`status: draft\`. Creating artifacts directly as \`active\` or \`approved\` is forbidden.
 - **Gherkin Acceptance Criteria**: In every \`FR-*\` requirement, include a \`\`\`gherkin block with tags \`@<ID> @automated @regression\` and at least one \`Scenario Outline\` with an \`Examples\` data table.
 - **Security Mitigations**: Every \`SEC-REQ-*\` must include negative Gherkin tests (\`@security @mitigation\`).
@@ -9764,9 +10036,10 @@ npx tsx packages/cli/src/index.ts sdd integrate --change <chg-id>
 ## 3. Specialized Roles Mapping
 
 ### 1. \`agent-product-analyst\` (Product Analyst / Scribe)
-- **Mission**: Assist in defining and refining the product model using ProductShape.
+- **Mission**: Capture new product intent via NAF v4 Enterprise & Capability Vision (\`ARCH-INTRO-*\`) and define/refine the product model using ProductShape.
+- **Phase 0 (Greenfield Product Inception)**: When creating a new product from scratch (or when \`specs/product/\` has no baseline), run a concise 3\u20135 question discovery interview (mission/problem, actors \`ACT-*\`, MVP capabilities \`UC-*\`, priority quality goals \`QR-*\`), draft \`ARCH-INTRO-001\` (\`templates/architecture/introduction-and-goals.template.md\`), and derive initial \`ACT-*\`, \`UC-*\`, \`BR-*\`, \`FR-*\`, and \`QR-*\` drafts.
 - **Input**: Business intent or natural language specification.
-- **Output**: Markdown artifacts with YAML frontmatter compliant with \`schemas/product/\` (\`ACT-*\`, \`UC-*\`, \`FR-*\`, \`QR-*\`, \`BR-*\`).
+- **Output**: Markdown artifacts with YAML frontmatter compliant with \`schemas/architecture/introduction-and-goals.schema.json\` (\`ARCH-INTRO-*\`) and \`schemas/product/\` (\`ACT-*\`, \`UC-*\`, \`FR-*\`, \`QR-*\`, \`BR-*\`).
 - **Guardrails**: \`status\` always starts in \`draft\`. Mandatory Gherkin criteria with \`@<ID> @automated @regression\`.
 
 ### 2. \`agent-threat-modeler\` (Threat Modeler and Security Specialist)
@@ -9925,7 +10198,7 @@ Non-Negotiable Quality Thresholds (\`quality-policy.yaml\`):
 
 | Role | Mission (summary) |
 | :--- | :--- |
-| \`agent-product-analyst\` | ProductShape artifacts (\`ACT-*\`, \`UC-*\`, \`FR-*\`, \`QR-*\`, \`BR-*\`); \`status\` starts \`draft\`. |
+| \`agent-product-analyst\` | Phase 0 NAF v4 Enterprise & Capability Vision (\`ARCH-INTRO-*\`, 3\u20135 question interview) + ProductShape artifacts (\`ACT-*\`, \`UC-*\`, \`FR-*\`, \`QR-*\`, \`BR-*\`); \`status\` starts \`draft\`. |
 | \`agent-threat-modeler\` | STRIDE/OWASP threat triad (\`ACT-THREAT-*\`, \`ABUSE-*\`, \`SEC-REQ-*\`). |
 | \`agent-system-architect\` | Modular arc42 + NAF v4 architecture (\`CMP-*\`, Mermaid diagrams, \`ADR-*\`). |
 | \`agent-qa-engineer\` | FAILING BDD/Gherkin suites before \`agent-developer\` writes production code. |
@@ -10733,7 +11006,7 @@ var ALL_ARCHITECTURE_TEMPLATES = [
   { filename: "cross-cutting-concepts.template.md", content: STARTER_ARCH_CROSS_CUTTING_CONCEPTS, isMinimal: false },
   { filename: "deployment-view.template.md", content: STARTER_ARCH_DEPLOYMENT_VIEW, isMinimal: false },
   { filename: "glossary.template.md", content: STARTER_ARCH_GLOSSARY, isMinimal: false },
-  { filename: "introduction-and-goals.template.md", content: STARTER_ARCH_INTRODUCTION_AND_GOALS, isMinimal: false },
+  { filename: "introduction-and-goals.template.md", content: STARTER_ARCH_INTRODUCTION_AND_GOALS, isMinimal: true },
   { filename: "level-1-whitebox.template.md", content: STARTER_ARCH_LEVEL_1_WHITEBOX, isMinimal: false },
   { filename: "quality-requirements.template.md", content: STARTER_ARCH_QUALITY_REQUIREMENTS, isMinimal: false },
   { filename: "risks-and-technical-debt.template.md", content: STARTER_ARCH_RISKS_AND_TECHNICAL_DEBT, isMinimal: false },