@aisdlc/core 1.3.1 → 1.3.2

package/dist/index.cjs

@@ -2088,6 +2088,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
@@ -2131,6 +2132,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"],
@@ -3433,7 +3435,8 @@ function verifyTraceability(options = {}) {
           });
         }
       }
-      if (relFile.includes("architecture/") || relFile.includes("06_runtime_view") || relFile.includes("08_security_concept") || relFile.includes("09_decisions")) {
+      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,
@@ -3522,6 +3525,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)))
     );
@@ -7236,7 +7247,10 @@ function buildGraphElements(rootDir = process.cwd()) {
             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") {
@@ -7329,16 +7343,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,
@@ -7436,7 +7452,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)) {
@@ -8285,6 +8374,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>
@@ -8319,6 +8409,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>
@@ -8738,6 +8829,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: {
@@ -8854,7 +8958,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 }
           },
           {
@@ -8883,6 +8987,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 }
@@ -9023,7 +9131,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') {
@@ -9089,6 +9200,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');
@@ -9425,14 +9541,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>...\`.
@@ -9680,9 +9802,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>...\`.
@@ -9813,7 +9936,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. |
@@ -9848,6 +9971,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\`)
@@ -9858,6 +9982,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\`).
@@ -9939,9 +10064,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)
@@ -10100,7 +10226,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. |
@@ -10908,7 +11034,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 },