iikit-dashboard 1.7.0 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iikit-dashboard",
-  "version": "1.7.0",
+  "version": "2.0.0",
   "description": "Real-time dashboard for Intent Integrity Kit (IIKit) — visualizes every phase of specification-driven AI development",
   "main": "src/generate-dashboard.js",
   "bin": {

package/src/generate-dashboard.js

@@ -11,7 +11,7 @@ const { computePipelineState } = require('./pipeline');
 const { computeStoryMapState } = require('./storymap');
 const { computePlanViewState } = require('./planview');
 const { computeChecklistViewState } = require('./checklist');
-const { computeTestifyState } = require('./testify');
+const { computeTestifyState, getFeatureFiles } = require('./testify');
 const { computeAnalyzeState } = require('./analyze');
 const { computeBugsState } = require('./bugs');
 
@@ -62,7 +62,6 @@ function getBoardState(projectPath, featureId) {
   const featureDir = path.join(projectPath, 'specs', featureId);
   const specPath = path.join(featureDir, 'spec.md');
   const tasksPath = path.join(featureDir, 'tasks.md');
-  const testSpecsPath = path.join(featureDir, 'tests', 'test-specs.md');
   const contextPath = path.join(featureDir, 'context.json');
 
   const specContent = fs.existsSync(specPath) ? fs.readFileSync(specPath, 'utf-8') : '';
@@ -73,9 +72,10 @@ function getBoardState(projectPath, featureId) {
   const board = computeBoardState(stories, tasks);
 
   let integrity = { status: 'missing', currentHash: null, storedHash: null };
-  if (fs.existsSync(testSpecsPath)) {
-    const testSpecsContent = fs.readFileSync(testSpecsPath, 'utf-8');
-    const currentHash = computeAssertionHash(testSpecsContent);
+  const featureFiles = getFeatureFiles(featureDir);
+  if (featureFiles.length > 0) {
+    const allFeatureContent = featureFiles.map(f => fs.readFileSync(f, 'utf-8')).join('\n');
+    const currentHash = computeAssertionHash(allFeatureContent);
     let storedHash = null;
     if (fs.existsSync(contextPath)) {
       try {
@@ -260,6 +260,7 @@ async function main() {
 
     const watchGlobs = [
       path.join(projectPath, 'specs', '**', '*.md'),
+      path.join(projectPath, 'specs', '**', '*.feature'),
       path.join(projectPath, 'CONSTITUTION.md'),
       path.join(projectPath, 'PREMISE.md')
     ];

package/src/integrity.js

@@ -3,10 +3,13 @@
 const crypto = require('crypto');
 
 /**
- * Extract Given/When/Then lines from test-specs.md,
- * normalize whitespace, sort, and compute SHA256 hash.
+ * Extract Gherkin step lines (Given/When/Then/And/But) from .feature content,
+ * normalize whitespace, and compute SHA256 hash.
  *
- * @param {string} content - Raw content of test-specs.md
+ * Order is preserved (deterministic ordering comes from sorted filenames — caller
+ * concatenates all .feature file contents sorted by filename before calling).
+ *
+ * @param {string} content - Concatenated content of .feature files
  * @returns {string|null} SHA256 hex hash, or null if no assertions found
  */
 function computeAssertionHash(content) {
@@ -16,23 +19,15 @@ function computeAssertionHash(content) {
   const assertionLines = [];
 
   for (const line of lines) {
-    const trimmed = line.trim();
-    if (
-      trimmed.startsWith('**Given**:') ||
-      trimmed.startsWith('**When**:') ||
-      trimmed.startsWith('**Then**:')
-    ) {
+    if (/^\s*(Given|When|Then|And|But) /.test(line)) {
       // Normalize whitespace: collapse multiple spaces to single space
-      const normalized = trimmed.replace(/\s+/g, ' ').trim();
+      const normalized = line.replace(/\s+/g, ' ').trim();
       assertionLines.push(normalized);
     }
   }
 
   if (assertionLines.length === 0) return null;
 
-  // Sort for deterministic ordering
-  assertionLines.sort();
-
   const joined = assertionLines.join('\n');
   return crypto.createHash('sha256').update(joined, 'utf8').digest('hex');
 }
@@ -40,7 +35,7 @@ function computeAssertionHash(content) {
 /**
  * Compare current assertion hash against stored hash.
  *
- * @param {string|null} currentHash - Hash computed from current test-specs.md
+ * @param {string|null} currentHash - Hash computed from current .feature files
  * @param {string|null} storedHash - Hash from context.json
  * @returns {{status: string, currentHash: string|null, storedHash: string|null}}
  */

package/src/parser.js

@@ -881,58 +881,64 @@ function parseResearchDecisions(content) {
 }
 
 /**
- * Parse tests/test-specs.md to extract test specification entries.
- * Pattern: ### TS-XXX: Title, then **Type**: value, **Priority**: value, **Traceability**: refs
+ * Parse Gherkin .feature file content to extract test specification entries.
+ * Collects @tags before Scenario:/Scenario Outline: lines.
+ * Tags: @TS-XXX (id), @P1/@P2/@P3 (priority), @acceptance/@contract/@validation (type),
+ *        @FR-XXX/@SC-XXX (traceability — @US-XXX filtered out).
  *
- * @param {string} content - Raw markdown content of test-specs.md
+ * @param {string} content - Raw content of one or more .feature files
  * @returns {Array<{id: string, title: string, type: string, priority: string, traceability: string[]}>}
  */
 function parseTestSpecs(content) {
   if (!content || typeof content !== 'string') return [];
 
   const specs = [];
-  const headingRegex = /### TS-(\d+): (.+)/g;
-  const headingStarts = [];
-  let match;
+  const lines = content.split('\n');
+  let pendingTags = [];
 
-  while ((match = headingRegex.exec(content)) !== null) {
-    headingStarts.push({
-      id: `TS-${match[1]}`,
-      title: match[2].trim(),
-      index: match.index
-    });
-  }
+  for (const line of lines) {
+    const trimmed = line.trim();
 
-  for (let i = 0; i < headingStarts.length; i++) {
-    const start = headingStarts[i].index;
-    const end = i + 1 < headingStarts.length ? headingStarts[i + 1].index : content.length;
-    const section = content.substring(start, end);
+    // Collect tag lines (may have multiple tags per line)
+    if (trimmed.startsWith('@')) {
+      const tags = trimmed.match(/@[\w-]+/g) || [];
+      pendingTags.push(...tags);
+      continue;
+    }
+
+    // Match Scenario or Scenario Outline
+    const scenarioMatch = trimmed.match(/^Scenario(?: Outline)?:\s*(.+)/);
+    if (scenarioMatch && pendingTags.length > 0) {
+      const title = scenarioMatch[1].trim();
+
+      // Extract id from @TS-XXX
+      const idTag = pendingTags.find(t => /^@TS-\d+$/.test(t));
+      const id = idTag ? idTag.slice(1) : null;
+      if (!id) { pendingTags = []; continue; }
+
+      // Extract type from @acceptance/@contract/@validation
+      const typeTag = pendingTags.find(t => /^@(acceptance|contract|validation)$/.test(t));
+      const type = typeTag ? typeTag.slice(1) : 'validation';
+
+      // Extract priority from @P1/@P2/@P3
+      const priorityTag = pendingTags.find(t => /^@P\d+$/.test(t));
+      const priority = priorityTag ? priorityTag.slice(1) : 'P3';
 
-    // Extract type
-    const typeMatch = section.match(/\*\*Type\*\*:\s*(acceptance|contract|validation)/);
-    const type = typeMatch ? typeMatch[1] : 'validation';
-
-    // Extract priority
-    const priorityMatch = section.match(/\*\*Priority\*\*:\s*(P\d+)/);
-    const priority = priorityMatch ? priorityMatch[1] : 'P3';
-
-    // Extract traceability — comma-separated IDs, filter to FR-/SC- only
-    let traceability = [];
-    const traceMatch = section.match(/\*\*Traceability\*\*:\s*(.+)/);
-    if (traceMatch) {
-      traceability = traceMatch[1]
-        .split(/,\s*/)
-        .map(s => s.trim())
-        .filter(s => /^(FR|SC)-\d+$/.test(s));
+      // Extract traceability from @FR-XXX/@SC-XXX (filter out @US-XXX)
+      const traceability = pendingTags
+        .filter(t => /^@(FR|SC)-\d+$/.test(t))
+        .map(t => t.slice(1));
+
+      specs.push({ id, title, type, priority, traceability });
+      pendingTags = [];
+      continue;
     }
 
-    specs.push({
-      id: headingStarts[i].id,
-      title: headingStarts[i].title,
-      type,
-      priority,
-      traceability
-    });
+    // Skip Background:, Rule:, Feature:, Examples: — just reset tags on non-tag, non-scenario lines
+    if (trimmed.startsWith('Feature:') || trimmed.startsWith('Background:') ||
+        trimmed.startsWith('Rule:') || trimmed.startsWith('Examples:')) {
+      pendingTags = [];
+    }
   }
 
   return specs;

package/src/pipeline.js

@@ -3,6 +3,7 @@
 const fs = require('fs');
 const path = require('path');
 const { parseTasks, parseChecklists, parseConstitutionTDD, hasClarifications } = require('./parser');
+const { getFeatureFiles } = require('./testify');
 
 /**
  * Compute pipeline phase states for a feature by examining artifacts on disk.
@@ -17,7 +18,6 @@ function computePipelineState(projectPath, featureId) {
   const specPath = path.join(featureDir, 'spec.md');
   const planPath = path.join(featureDir, 'plan.md');
   const checklistDir = path.join(featureDir, 'checklists');
-  const testSpecsPath = path.join(featureDir, 'tests', 'test-specs.md');
   const tasksPath = path.join(featureDir, 'tasks.md');
 
   const analysisPath = path.join(featureDir, 'analysis.md');
@@ -25,7 +25,7 @@ function computePipelineState(projectPath, featureId) {
   const specExists = fs.existsSync(specPath);
   const planExists = fs.existsSync(planPath);
   const tasksExists = fs.existsSync(tasksPath);
-  const testSpecsExists = fs.existsSync(testSpecsPath);
+  const testSpecsExists = getFeatureFiles(featureDir).length > 0;
   const constitutionExists = fs.existsSync(constitutionPath);
   const premiseExists = fs.existsSync(path.join(projectPath, 'PREMISE.md'));
   const analysisExists = fs.existsSync(analysisPath);

package/src/public/index.html

@@ -5331,7 +5331,7 @@
           case 'missing':
             textEl.textContent = 'Missing';
             badge.setAttribute('aria-label', 'Test integrity: no hash data available');
-            badge.title = 'No test-specs.md or context.json found';
+            badge.title = 'No test specifications or context.json found';
             break;
         }
       }

package/src/testify.js

@@ -5,6 +5,21 @@ const fs = require('fs');
 const { parseRequirements, parseSuccessCriteria, parseTestSpecs, parseTasks, parseTaskTestRefs } = require('./parser');
 const { computeAssertionHash, checkIntegrity } = require('./integrity');
 
+/**
+ * Get sorted list of .feature file paths in a feature's tests/features/ directory.
+ *
+ * @param {string} featureDir - Path to the feature directory (e.g., specs/001-auth)
+ * @returns {string[]} Sorted absolute paths to .feature files
+ */
+function getFeatureFiles(featureDir) {
+  const featuresDir = path.join(featureDir, 'tests', 'features');
+  if (!fs.existsSync(featuresDir)) return [];
+  return fs.readdirSync(featuresDir)
+    .filter(f => f.endsWith('.feature'))
+    .sort()
+    .map(f => path.join(featuresDir, f));
+}
+
 /**
  * Build edges between requirements, test specs, and tasks.
  * Only creates edges where both source and target nodes exist.
@@ -98,7 +113,6 @@ function buildPyramid(testSpecs) {
 function computeTestifyState(projectPath, featureId) {
   const featureDir = path.join(projectPath, 'specs', featureId);
   const specPath = path.join(featureDir, 'spec.md');
-  const testSpecsPath = path.join(featureDir, 'tests', 'test-specs.md');
   const tasksPath = path.join(featureDir, 'tasks.md');
   const contextPath = path.join(featureDir, 'context.json');
 
@@ -125,10 +139,14 @@ function computeTestifyState(projectPath, featureId) {
   const scReqs = parseSuccessCriteria(specContent);
   const requirements = [...frReqs, ...scReqs];
 
-  // Parse test specs
-  const testSpecsExist = fs.existsSync(testSpecsPath);
-  const testSpecsContent = testSpecsExist ? fs.readFileSync(testSpecsPath, 'utf-8') : '';
-  const testSpecs = testSpecsExist ? parseTestSpecs(testSpecsContent) : [];
+  // Parse test specs from .feature files
+  const featureFiles = getFeatureFiles(featureDir);
+  const testSpecsExist = featureFiles.length > 0;
+  const featureContents = featureFiles.map(f => fs.readFileSync(f, 'utf-8'));
+  const allFeatureContent = featureContents.join('\n');
+  const testSpecs = testSpecsExist
+    ? featureContents.reduce((acc, content) => acc.concat(parseTestSpecs(content)), [])
+    : [];
 
   // Parse tasks and extract test spec refs
   const tasksContent = fs.existsSync(tasksPath) ? fs.readFileSync(tasksPath, 'utf-8') : '';
@@ -148,7 +166,7 @@ function computeTestifyState(projectPath, featureId) {
   // Integrity check
   let integrity = { status: 'missing', currentHash: null, storedHash: null };
   if (testSpecsExist) {
-    const currentHash = computeAssertionHash(testSpecsContent);
+    const currentHash = computeAssertionHash(allFeatureContent);
 
     let storedHash = null;
     if (fs.existsSync(contextPath)) {
@@ -175,4 +193,4 @@ function computeTestifyState(projectPath, featureId) {
   };
 }
 
-module.exports = { buildEdges, findGaps, buildPyramid, computeTestifyState };
+module.exports = { buildEdges, findGaps, buildPyramid, computeTestifyState, getFeatureFiles };