specweave 0.13.6 → 0.15.0

package/dist/utils/spec-splitter.js

@@ -0,0 +1,332 @@
+/**
+ * Spec Splitter - Split Monolithic Specs into Project-Specific Files
+ *
+ * Takes a comprehensive spec file covering multiple projects and intelligently
+ * splits it into project-specific spec files (FE/, BE/, MOBILE/, etc.)
+ *
+ * @module spec-splitter
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { splitSpecByProject, DEFAULT_PROJECT_RULES } from './project-mapper.js';
+/**
+ * Normalize metadata fields (prefers camelCase over snake_case)
+ *
+ * @param metadata Raw metadata with potential snake_case fields
+ * @returns Normalized metadata with camelCase fields
+ */
+export function normalizeMetadata(metadata) {
+    return {
+        ...metadata,
+        specId: metadata.specId || metadata.spec_id,
+        lastUpdated: metadata.lastUpdated || metadata.last_updated,
+        estimatedEffort: metadata.estimatedEffort || metadata.estimated_effort,
+        targetRelease: metadata.targetRelease || metadata.target_release,
+        jiraSync: metadata.jiraSync !== undefined ? metadata.jiraSync : metadata.jira_sync,
+        jiraProjects: metadata.jiraProjects || metadata.jira_projects
+    };
+}
+/**
+ * Parse spec file into structured format
+ *
+ * @param specPath Path to spec.md file
+ * @returns Parsed spec structure
+ */
+export async function parseSpecFile(specPath) {
+    const content = await fs.readFile(specPath, 'utf-8');
+    // Extract frontmatter
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch) {
+        throw new Error('No frontmatter found in spec file');
+    }
+    const rawMetadata = parseFrontmatter(frontmatterMatch[1]);
+    const metadata = normalizeMetadata(rawMetadata);
+    // Extract sections
+    const sections = extractSections(content);
+    // Parse user stories
+    const userStories = parseUserStories(sections.userStories || '');
+    return {
+        metadata,
+        executiveSummary: sections.executiveSummary || '',
+        problemStatement: sections.problemStatement || '',
+        userStories,
+        functionalRequirements: sections.functionalRequirements || '',
+        nonFunctionalRequirements: sections.nonFunctionalRequirements || '',
+        successMetrics: sections.successMetrics || '',
+        technicalArchitecture: sections.technicalArchitecture || '',
+        testStrategy: sections.testStrategy || '',
+        riskAnalysis: sections.riskAnalysis || '',
+        futureRoadmap: sections.futureRoadmap || '',
+        appendices: sections.appendices || ''
+    };
+}
+/**
+ * Parse YAML frontmatter into metadata object
+ */
+function parseFrontmatter(frontmatter) {
+    const lines = frontmatter.split('\n');
+    const metadata = {};
+    let currentKey = null;
+    let currentArray = [];
+    for (const line of lines) {
+        // Check for array items (starts with -)
+        if (currentKey && line.trim().startsWith('-')) {
+            const value = line.trim().slice(1).trim();
+            currentArray.push(value);
+            continue;
+        }
+        // If we were collecting an array, save it
+        if (currentKey && currentArray.length > 0) {
+            metadata[currentKey] = currentArray;
+            currentArray = [];
+            currentKey = null;
+        }
+        // Parse key: value line
+        const match = line.match(/^(\w+):\s*(.*)$/);
+        if (match) {
+            const key = match[1];
+            const value = match[2].trim();
+            // Handle arrays (JSON format like ["a", "b"])
+            if (value.startsWith('[')) {
+                metadata[key] = JSON.parse(value);
+            }
+            // Handle empty array (key: with nothing after)
+            else if (!value || value === '') {
+                currentKey = key;
+                currentArray = [];
+            }
+            // Handle boolean
+            else if (value === 'true' || value === 'false') {
+                metadata[key] = value === 'true';
+            }
+            // Handle string
+            else {
+                metadata[key] = value.replace(/^["']|["']$/g, '');
+            }
+        }
+    }
+    // Save any remaining array
+    if (currentKey && currentArray.length > 0) {
+        metadata[currentKey] = currentArray;
+    }
+    return metadata;
+}
+/**
+ * Extract sections from spec markdown
+ */
+function extractSections(content) {
+    const sections = {};
+    // Remove frontmatter
+    const withoutFrontmatter = content.replace(/^---\n[\s\S]*?\n---\n/, '');
+    // Split by h2 headers (##)
+    const parts = withoutFrontmatter.split(/^## /m);
+    for (const part of parts) {
+        if (!part.trim())
+            continue;
+        const lines = part.split('\n');
+        const sectionName = lines[0].trim();
+        const sectionContent = lines.slice(1).join('\n').trim();
+        // Normalize section names
+        const normalizedName = sectionName
+            .replace(/[^a-zA-Z0-9\s]/g, '')
+            .replace(/\s+/g, '')
+            .replace(/^(.)/, (m) => m.toLowerCase());
+        sections[normalizedName] = sectionContent;
+    }
+    return sections;
+}
+/**
+ * Parse user stories from spec section
+ */
+function parseUserStories(userStoriesSection) {
+    const stories = [];
+    // Split by h3 headers (###)
+    const storyParts = userStoriesSection.split(/^### /m);
+    for (const part of storyParts) {
+        if (!part.trim())
+            continue;
+        const lines = part.split('\n');
+        const titleLine = lines[0].trim();
+        // Extract US-XXX: Title
+        const match = titleLine.match(/^(US-\d+):\s*(.+?)(?:\s*\(Priority|$)/);
+        if (!match)
+            continue;
+        const id = match[1];
+        const title = match[2].trim();
+        // Extract description (As a... I want... So that...)
+        const descriptionMatch = part.match(/\*\*As a\*\*\s+(.+?)\n\*\*I want\*\*\s+(.+?)\n\*\*So that\*\*\s+(.+?)(?:\n|$)/s);
+        const description = descriptionMatch
+            ? `As a ${descriptionMatch[1].trim()} I want ${descriptionMatch[2].trim()} So that ${descriptionMatch[3].trim()}`
+            : '';
+        // Extract acceptance criteria
+        const acceptanceCriteria = [];
+        const acMatches = part.matchAll(/\*\*AC-[A-Z0-9-]+\*\*:\s*(.+?)(?:\n-|\n\*\*|$)/gs);
+        for (const acMatch of acMatches) {
+            acceptanceCriteria.push(acMatch[1].trim());
+        }
+        // Extract technical context (if present)
+        const technicalContextMatch = part.match(/#### Technical Context\n\n([\s\S]+?)(?:\n####|\n---|\n###|$)/);
+        const technicalContext = technicalContextMatch ? technicalContextMatch[1].trim() : undefined;
+        stories.push({
+            id,
+            title,
+            description,
+            acceptanceCriteria,
+            technicalContext
+        });
+    }
+    return stories;
+}
+/**
+ * Split spec into project-specific files
+ *
+ * @param specPath Path to monolithic spec.md
+ * @param outputDir Directory to write project-specific specs (e.g., .specweave/docs/internal/specs/)
+ * @param projectRules Custom project mapping rules (optional)
+ * @returns Map of projectId → output file path
+ */
+export async function splitSpecIntoProjects(specPath, outputDir, projectRules = DEFAULT_PROJECT_RULES) {
+    // Parse spec
+    const parsedSpec = await parseSpecFile(specPath);
+    // Split user stories by project
+    const projectStories = splitSpecByProject(parsedSpec.userStories, projectRules);
+    // Create output map
+    const outputMap = new Map();
+    // Generate project-specific specs
+    for (const [projectId, stories] of projectStories.entries()) {
+        const projectDir = path.join(outputDir, projectId);
+        await fs.ensureDir(projectDir);
+        const specId = (parsedSpec.metadata.specId || '0001').replace(/^SPEC-/, '');
+        const outputPath = path.join(projectDir, `spec-${specId.toLowerCase()}-${projectId.toLowerCase()}.md`);
+        const projectSpec = generateProjectSpec(parsedSpec, projectId, stories);
+        await fs.writeFile(outputPath, projectSpec, 'utf-8');
+        outputMap.set(projectId, outputPath);
+    }
+    return outputMap;
+}
+/**
+ * Generate project-specific spec file
+ */
+function generateProjectSpec(parsedSpec, projectId, userStories) {
+    const lines = [];
+    // Frontmatter
+    lines.push('---');
+    lines.push(`spec_id: ${parsedSpec.metadata.specId}`);
+    lines.push(`project: ${projectId}`);
+    lines.push(`title: "${parsedSpec.metadata.title} - ${projectId}"`);
+    lines.push(`version: ${parsedSpec.metadata.version}`);
+    lines.push(`status: ${parsedSpec.metadata.status}`);
+    lines.push(`created: ${parsedSpec.metadata.created}`);
+    lines.push(`last_updated: ${parsedSpec.metadata.lastUpdated}`);
+    lines.push(`authors:`);
+    for (const author of parsedSpec.metadata.authors) {
+        lines.push(`  - ${author}`);
+    }
+    lines.push(`priority: ${parsedSpec.metadata.priority}`);
+    lines.push(`estimated_effort: ${parsedSpec.metadata.estimatedEffort}`);
+    lines.push(`target_release: ${parsedSpec.metadata.targetRelease}`);
+    if (parsedSpec.metadata.jiraSync) {
+        lines.push(`jira_sync: true`);
+        lines.push(`jira_project: ${projectId}`);
+    }
+    lines.push('---');
+    lines.push('');
+    // Title
+    lines.push(`# SPEC-${parsedSpec.metadata.specId}: ${parsedSpec.metadata.title} - ${projectId}`);
+    lines.push('');
+    // Executive Summary (project-specific)
+    lines.push('## Executive Summary');
+    lines.push('');
+    lines.push(`**Project**: ${projectId}`);
+    lines.push(`**Scope**: ${userStories.length} user stories for ${projectId} component`);
+    lines.push('');
+    lines.push(parsedSpec.executiveSummary);
+    lines.push('');
+    // User Stories (filtered for this project)
+    lines.push('## User Stories');
+    lines.push('');
+    for (const story of userStories) {
+        lines.push(`### ${story.id}: ${story.title}`);
+        lines.push('');
+        lines.push(story.description);
+        lines.push('');
+        if (story.acceptanceCriteria.length > 0) {
+            lines.push('#### Acceptance Criteria');
+            lines.push('');
+            for (const ac of story.acceptanceCriteria) {
+                lines.push(`**${ac}**`);
+                lines.push('');
+            }
+        }
+        if (story.technicalContext) {
+            lines.push('#### Technical Context');
+            lines.push('');
+            lines.push(story.technicalContext);
+            lines.push('');
+        }
+        lines.push('---');
+        lines.push('');
+    }
+    // Shared sections (include full content from original spec)
+    if (parsedSpec.functionalRequirements) {
+        lines.push('## Functional Requirements (Shared)');
+        lines.push('');
+        lines.push('*See main spec for complete functional requirements*');
+        lines.push('');
+    }
+    if (parsedSpec.nonFunctionalRequirements) {
+        lines.push('## Non-Functional Requirements (Shared)');
+        lines.push('');
+        lines.push('*See main spec for complete non-functional requirements*');
+        lines.push('');
+    }
+    if (parsedSpec.technicalArchitecture) {
+        lines.push('## Technical Architecture');
+        lines.push('');
+        lines.push(parsedSpec.technicalArchitecture);
+        lines.push('');
+    }
+    // Footer
+    lines.push('---');
+    lines.push('');
+    lines.push('**Document End**');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Create multi-project folder structure
+ *
+ * @param specsDir Base specs directory (.specweave/docs/internal/specs/)
+ * @param projectIds Array of project IDs (e.g., ['FE', 'BE', 'MOBILE'])
+ */
+export async function createMultiProjectFolderStructure(specsDir, projectIds) {
+    await fs.ensureDir(specsDir);
+    for (const projectId of projectIds) {
+        const projectDir = path.join(specsDir, projectId);
+        await fs.ensureDir(projectDir);
+        // Create README.md for project
+        const readme = `# ${projectId} Specifications
+
+This folder contains specifications for the **${projectId}** project.
+
+## Organization
+
+- \`spec-NNNN-*.md\` - Project-specific specifications (living docs)
+- Each spec is permanently archived here after increment completion
+- Specs are auto-generated from increment specs and split by project
+
+## External Sync
+
+${projectId} specs sync to:
+- **JIRA**: Project ${projectId} (Epics)
+- **GitHub**: Issues tagged with \`${projectId}\` label
+
+## Maintenance
+
+- Specs are auto-updated via living docs sync hooks
+- Manual edits should be made in increment specs, not here
+`;
+        await fs.writeFile(path.join(projectDir, 'README.md'), readme, 'utf-8');
+    }
+}
+//# sourceMappingURL=spec-splitter.js.map

package/dist/utils/spec-splitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-splitter.js","sourceRoot":"","sources":["../../src/utils/spec-splitter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.13.6",
+  "version": "0.15.0",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/hooks/lib/update-status-line.sh

@@ -0,0 +1,138 @@
+#!/usr/bin/env bash
+#
+# update-status-line.sh
+#
+# Updates the status line cache with current increment progress.
+# Called by post-task-completion hook.
+#
+# Performance: 10-50ms (runs async in hook, user doesn't wait)
+#
+# Cache format (.specweave/state/status-line.json):
+# {
+#   "incrementId": "0017-sync-architecture-fix",
+#   "incrementName": "sync-architecture-fix",
+#   "totalTasks": 30,
+#   "completedTasks": 15,
+#   "percentage": 50,
+#   "currentTask": {
+#     "id": "T-016",
+#     "title": "Update documentation"
+#   },
+#   "lastUpdate": "2025-11-10T15:30:00Z",
+#   "lastModified": 1699632600
+# }
+
+set -euo pipefail
+
+# Find project root
+find_project_root() {
+  local dir="$PWD"
+  while [[ "$dir" != "/" ]]; do
+    if [[ -d "$dir/.specweave" ]]; then
+      echo "$dir"
+      return 0
+    fi
+    dir=$(dirname "$dir")
+  done
+  echo "$PWD"
+}
+
+PROJECT_ROOT=$(find_project_root)
+CACHE_FILE="$PROJECT_ROOT/.specweave/state/status-line.json"
+STATE_FILE="$PROJECT_ROOT/.specweave/state/active-increment.json"
+
+# Ensure state directory exists
+mkdir -p "$PROJECT_ROOT/.specweave/state"
+
+# Check if there's an active increment
+if [[ ! -f "$STATE_FILE" ]]; then
+  # No active increment = clear cache
+  echo '{}' > "$CACHE_FILE"
+  exit 0
+fi
+
+# Get active increment ID
+INCREMENT_ID=$(jq -r '.id // empty' "$STATE_FILE" 2>/dev/null || echo "")
+if [[ -z "$INCREMENT_ID" ]]; then
+  echo '{}' > "$CACHE_FILE"
+  exit 0
+fi
+
+TASKS_FILE="$PROJECT_ROOT/.specweave/increments/$INCREMENT_ID/tasks.md"
+
+# No tasks file yet? (Planning phase)
+if [[ ! -f "$TASKS_FILE" ]]; then
+  echo '{}' > "$CACHE_FILE"
+  exit 0
+fi
+
+# Get tasks.md mtime for invalidation detection
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  # macOS
+  MTIME=$(stat -f %m "$TASKS_FILE" 2>/dev/null || echo 0)
+else
+  # Linux
+  MTIME=$(stat -c %Y "$TASKS_FILE" 2>/dev/null || echo 0)
+fi
+
+# Parse tasks.md (THIS is the slow part: 10-50ms)
+TOTAL_TASKS=$(grep -c '^## T-' "$TASKS_FILE" 2>/dev/null || echo 0)
+COMPLETED_TASKS=$(grep -c '^\[x\]' "$TASKS_FILE" 2>/dev/null || echo 0)
+
+# Calculate percentage
+if [[ "$TOTAL_TASKS" -gt 0 ]]; then
+  PERCENTAGE=$(( COMPLETED_TASKS * 100 / TOTAL_TASKS ))
+else
+  PERCENTAGE=0
+fi
+
+# Find current task (first incomplete task)
+# Strategy: Find first [ ] checkbox, then get the task heading above it
+CURRENT_TASK_LINE=$(grep -B1 '^\[ \]' "$TASKS_FILE" 2>/dev/null | grep '^## T-' | head -1 || echo "")
+CURRENT_TASK_ID=""
+CURRENT_TASK_TITLE=""
+
+if [[ -n "$CURRENT_TASK_LINE" ]]; then
+  # Extract task ID (T-NNN)
+  CURRENT_TASK_ID=$(echo "$CURRENT_TASK_LINE" | grep -o 'T-[0-9][0-9]*' || echo "")
+
+  # Extract task title (after "## T-NNN: ")
+  # Use parameter expansion to remove prefix
+  TEMP="${CURRENT_TASK_LINE#*: }"
+  CURRENT_TASK_TITLE=$(echo "$TEMP" | head -c 50)
+fi
+
+# Extract increment name (remove leading 4-digit number and dash)
+INCREMENT_NAME=$(echo "$INCREMENT_ID" | sed 's/^[0-9]\{4\}-//')
+
+# Build current task JSON
+if [[ -n "$CURRENT_TASK_ID" ]]; then
+  CURRENT_TASK_JSON=$(jq -n \
+    --arg id "$CURRENT_TASK_ID" \
+    --arg title "$CURRENT_TASK_TITLE" \
+    '{id: $id, title: $title}')
+else
+  CURRENT_TASK_JSON="null"
+fi
+
+# Write cache atomically using jq
+jq -n \
+  --arg id "$INCREMENT_ID" \
+  --arg name "$INCREMENT_NAME" \
+  --argjson total "$TOTAL_TASKS" \
+  --argjson completed "$COMPLETED_TASKS" \
+  --argjson percentage "$PERCENTAGE" \
+  --argjson task "$CURRENT_TASK_JSON" \
+  --argjson mtime "$MTIME" \
+  '{
+    incrementId: $id,
+    incrementName: $name,
+    totalTasks: $total,
+    completedTasks: $completed,
+    percentage: $percentage,
+    currentTask: $task,
+    lastUpdate: (now | strftime("%Y-%m-%dT%H:%M:%SZ")),
+    lastModified: $mtime
+  }' > "$CACHE_FILE"
+
+exit 0

package/plugins/specweave/hooks/post-task-completion.sh

@@ -289,6 +289,16 @@ play_sound() {
   esac
 }
 
+# ============================================================================
+# STATUS LINE UPDATE
+# ============================================================================
+# Update status line cache BEFORE playing sound (async, non-blocking)
+# Cache will be read by status line renderer for fast display (<1ms)
+
+echo "[$(date)] 📊 Updating status line cache" >> "$DEBUG_LOG" 2>/dev/null || true
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+bash "$HOOK_DIR/lib/update-status-line.sh" 2>/dev/null || true
+
 if [ "$SESSION_ENDING" = "true" ]; then
   echo "[$(date)] 🔔 Playing completion sound" >> "$DEBUG_LOG" 2>/dev/null || true
   play_sound