specweave 0.17.1 → 0.17.3

package/dist/plugins/specweave-jira/lib/project-selector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"project-selector.js","sourceRoot":"","sources":["../../../../plugins/specweave-jira/lib/project-selector.ts"],"names":[],"mappings":"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"}

package/dist/project-mapper.js

@@ -1,272 +0,0 @@
-/**
- * Project Mapper - Intelligent User Story to Project Classification
- *
- * Analyzes user story content, tech stack mentions, and component architecture
- * to intelligently map user stories to the correct projects (FE, BE, MOBILE, etc.)
- *
- * @module project-mapper
- */
-/**
- * Default project mapping rules
- * These can be customized via .specweave/config.json
- */
-export const DEFAULT_PROJECT_RULES = [
-    {
-        id: 'FE',
-        name: 'Frontend (Web)',
-        keywords: [
-            'ui', 'ux', 'web', 'browser', 'chart', 'graph', 'visualization',
-            'dashboard', 'button', 'form', 'input', 'page', 'view', 'screen',
-            'modal', 'dropdown', 'navigation', 'menu', 'search', 'filter',
-            'responsive', 'desktop', 'tablet', 'css', 'styling', 'theme',
-            'dark mode', 'light mode', 'component', 'state management'
-        ],
-        techStack: [
-            'react', 'vue', 'angular', 'next.js', 'gatsby', 'svelte',
-            'typescript', 'javascript', 'html', 'css', 'scss', 'tailwind',
-            'mui', 'material-ui', 'antd', 'chakra', 'redux', 'zustand',
-            'recharts', 'd3', 'chart.js', 'plotly'
-        ],
-        componentTypes: [
-            'component', 'hook', 'context', 'provider', 'hoc', 'page',
-            'layout', 'template', 'widget'
-        ]
-    },
-    {
-        id: 'BE',
-        name: 'Backend (API)',
-        keywords: [
-            'api', 'endpoint', 'rest', 'graphql', 'database', 'query',
-            'migration', 'schema', 'model', 'service', 'controller',
-            'authentication', 'authorization', 'jwt', 'session', 'token',
-            'validation', 'sanitization', 'rate limiting', 'caching',
-            'redis', 'queue', 'job', 'worker', 'webhook', 'integration',
-            'third-party', 'external api', 'data processing', 'batch',
-            'cron', 'scheduler', 'background'
-        ],
-        techStack: [
-            'node.js', 'express', 'fastify', 'nestjs', 'koa',
-            'python', 'fastapi', 'django', 'flask',
-            'java', 'spring boot',
-            '.net', 'asp.net',
-            'go', 'gin',
-            'rust', 'actix',
-            'postgresql', 'mysql', 'mongodb', 'redis',
-            'prisma', 'typeorm', 'sequelize', 'sqlalchemy'
-        ],
-        componentTypes: [
-            'controller', 'service', 'repository', 'middleware',
-            'route', 'handler', 'util', 'helper', 'validator'
-        ]
-    },
-    {
-        id: 'MOBILE',
-        name: 'Mobile (iOS/Android)',
-        keywords: [
-            'mobile', 'ios', 'android', 'app', 'native', 'cross-platform',
-            'push notification', 'offline', 'sync', 'device', 'camera',
-            'gps', 'location', 'gesture', 'touch', 'swipe', 'navigation',
-            'tab bar', 'bottom sheet', 'drawer', 'stack', 'screen transition',
-            'deep linking', 'universal link', 'app store', 'play store'
-        ],
-        techStack: [
-            'react native', 'expo', 'flutter', 'swift', 'swiftui',
-            'kotlin', 'jetpack compose', 'xamarin', 'cordova', 'ionic',
-            'react-navigation', 'react-native-reanimated', 'asyncstorage'
-        ],
-        componentTypes: [
-            'screen', 'navigator', 'modal', 'bottom-sheet', 'drawer'
-        ],
-        excludeKeywords: ['web']
-    },
-    {
-        id: 'INFRA',
-        name: 'Infrastructure',
-        keywords: [
-            'deployment', 'ci/cd', 'docker', 'kubernetes', 'helm',
-            'terraform', 'cloudformation', 'infrastructure', 'devops',
-            'monitoring', 'logging', 'metrics', 'alerting', 'slo', 'sli',
-            'scalability', 'load balancing', 'cdn', 'dns', 'ssl', 'tls',
-            'security', 'firewall', 'vpc', 'network', 'backup', 'disaster recovery'
-        ],
-        techStack: [
-            'aws', 'azure', 'gcp', 'kubernetes', 'docker', 'terraform',
-            'ansible', 'jenkins', 'github actions', 'gitlab ci', 'circleci',
-            'prometheus', 'grafana', 'datadog', 'new relic', 'sentry'
-        ],
-        componentTypes: [
-            'pipeline', 'manifest', 'helm chart', 'terraform module'
-        ]
-    }
-];
-/**
- * Analyze user story content and map to projects
- *
- * @param userStory User story to analyze
- * @param projectRules Project mapping rules (defaults to DEFAULT_PROJECT_RULES)
- * @returns Array of project mappings sorted by confidence (highest first)
- */
-export function mapUserStoryToProjects(userStory, projectRules = DEFAULT_PROJECT_RULES) {
-    const mappings = [];
-    // Combine all user story text for analysis
-    const fullText = [
-        userStory.title,
-        userStory.description,
-        ...userStory.acceptanceCriteria,
-        userStory.technicalContext || ''
-    ].join(' ').toLowerCase();
-    for (const rule of projectRules) {
-        const reasoning = [];
-        let score = 0;
-        let maxScore = 0;
-        // Keyword matching (40% weight)
-        const keywordMatches = rule.keywords.filter(keyword => fullText.includes(keyword.toLowerCase()));
-        const keywordScore = keywordMatches.length * 0.4;
-        score += keywordScore;
-        maxScore += rule.keywords.length * 0.4;
-        if (keywordMatches.length > 0) {
-            reasoning.push(`Keywords: ${keywordMatches.slice(0, 5).join(', ')}`);
-        }
-        // Tech stack matching (40% weight)
-        const techStackMatches = rule.techStack.filter(tech => fullText.includes(tech.toLowerCase()));
-        const techScore = techStackMatches.length * 0.4;
-        score += techScore;
-        maxScore += rule.techStack.length * 0.4;
-        if (techStackMatches.length > 0) {
-            reasoning.push(`Tech stack: ${techStackMatches.slice(0, 5).join(', ')}`);
-        }
-        // Component type matching (20% weight)
-        const componentMatches = rule.componentTypes.filter(component => fullText.includes(component.toLowerCase()));
-        const componentScore = componentMatches.length * 0.2;
-        score += componentScore;
-        maxScore += rule.componentTypes.length * 0.2;
-        if (componentMatches.length > 0) {
-            reasoning.push(`Components: ${componentMatches.slice(0, 3).join(', ')}`);
-        }
-        // Exclude keywords (penalty)
-        if (rule.excludeKeywords) {
-            const excludeMatches = rule.excludeKeywords.filter(keyword => fullText.includes(keyword.toLowerCase()));
-            if (excludeMatches.length > 0) {
-                score *= 0.5; // 50% penalty
-                reasoning.push(`Penalty: ${excludeMatches.join(', ')} (not primary focus)`);
-            }
-        }
-        // Normalize confidence (0.0-1.0)
-        const confidence = maxScore > 0 ? Math.min(score / (maxScore * 0.3), 1.0) : 0;
-        // Only include mappings with confidence > 0.1
-        if (confidence > 0.1) {
-            mappings.push({
-                projectId: rule.id,
-                confidence,
-                reasoning
-            });
-        }
-    }
-    // Sort by confidence (highest first)
-    mappings.sort((a, b) => b.confidence - a.confidence);
-    return mappings;
-}
-/**
- * Determine primary project for a user story
- * (highest confidence mapping)
- *
- * @param userStory User story to analyze
- * @param projectRules Project mapping rules
- * @returns Primary project mapping or null if no confident match
- */
-export function getPrimaryProject(userStory, projectRules = DEFAULT_PROJECT_RULES) {
-    const mappings = mapUserStoryToProjects(userStory, projectRules);
-    // Require at least 30% confidence for primary project
-    return mappings.length > 0 && mappings[0].confidence >= 0.3
-        ? mappings[0]
-        : null;
-}
-/**
- * Split spec into project-specific specs based on user story mappings
- *
- * @param userStories Array of user stories
- * @param projectRules Project mapping rules
- * @returns Map of projectId → user stories
- */
-export function splitSpecByProject(userStories, projectRules = DEFAULT_PROJECT_RULES) {
-    const projectSpecs = new Map();
-    for (const userStory of userStories) {
-        const primaryProject = getPrimaryProject(userStory, projectRules);
-        if (primaryProject) {
-            const existing = projectSpecs.get(primaryProject.projectId) || [];
-            existing.push(userStory);
-            projectSpecs.set(primaryProject.projectId, existing);
-        }
-        else {
-            // No confident match - assign to "SHARED" or primary project
-            const shared = projectSpecs.get('SHARED') || [];
-            shared.push(userStory);
-            projectSpecs.set('SHARED', shared);
-        }
-    }
-    return projectSpecs;
-}
-/**
- * Suggest JIRA item type hierarchy based on user story scope
- *
- * @param userStory User story to analyze
- * @returns Suggested JIRA item type (Epic, Story, Task, Subtask)
- */
-export function suggestJiraItemType(userStory) {
-    const storyPoints = estimateStoryPoints(userStory);
-    // Epic: > 13 story points (large feature area)
-    if (storyPoints > 13) {
-        return 'Epic';
-    }
-    // Story: 3-13 story points (standard user story)
-    if (storyPoints >= 3) {
-        return 'Story';
-    }
-    // Task: 1-2 story points (small implementation task)
-    if (storyPoints >= 1) {
-        return 'Task';
-    }
-    // Subtask: < 1 story point (granular work)
-    return 'Subtask';
-}
-/**
- * Estimate story points based on acceptance criteria count and complexity
- *
- * @param userStory User story to estimate
- * @returns Estimated story points (1-21)
- */
-function estimateStoryPoints(userStory) {
-    const acCount = userStory.acceptanceCriteria.length;
-    // Simple heuristic: 1 AC ≈ 1 story point, max 21
-    return Math.min(acCount, 21);
-}
-/**
- * Format project mapping report (for display to user)
- *
- * @param userStory User story
- * @param mappings Project mappings
- * @returns Formatted markdown report
- */
-export function formatProjectMappingReport(userStory, mappings) {
-    const lines = [];
-    lines.push(`## ${userStory.id}: ${userStory.title}`);
-    lines.push('');
-    if (mappings.length === 0) {
-        lines.push('❌ **No project match** (assign to SHARED)');
-        return lines.join('\n');
-    }
-    lines.push(`✅ **Primary Project**: ${mappings[0].projectId} (${(mappings[0].confidence * 100).toFixed(0)}% confidence)`);
-    lines.push('');
-    lines.push('**Reasoning**:');
-    for (const reason of mappings[0].reasoning) {
-        lines.push(`- ${reason}`);
-    }
-    if (mappings.length > 1) {
-        lines.push('');
-        lines.push('**Secondary Matches**:');
-        for (const mapping of mappings.slice(1, 3)) {
-            lines.push(`- ${mapping.projectId} (${(mapping.confidence * 100).toFixed(0)}%)`);
-        }
-    }
-    return lines.join('\n');
-}

package/dist/scripts/split-spec-by-project.js

@@ -1,105 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Split Monolithic Spec into Project-Specific Files
- *
- * Usage: node dist/scripts/split-spec-by-project.js <spec-path> <output-dir>
- */
-
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-import {
-  parseSpecFile,
-  splitSpecIntoProjects,
-  createMultiProjectFolderStructure
-} from '../utils/spec-splitter.js';
-import {
-  mapUserStoryToProjects,
-  formatProjectMappingReport
-} from '../utils/project-mapper.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-async function main() {
-  const args = process.argv.slice(2);
-
-  if (args.length < 2) {
-    console.error('Usage: node dist/scripts/split-spec-by-project.js <spec-path> <output-dir>');
-    process.exit(1);
-  }
-
-  const [specPath, outputDir] = args;
-
-  console.log('🔍 Analyzing spec file...\n');
-
-  // Parse spec
-  const parsedSpec = await parseSpecFile(specPath);
-
-  console.log(`✓ Parsed spec: ${parsedSpec.metadata.title}`);
-  console.log(`  User stories: ${parsedSpec.userStories.length}`);
-  console.log('');
-
-  // Analyze user stories
-  console.log('📊 Classifying user stories by project...\n');
-
-  const projectStats = new Map();
-
-  for (const userStory of parsedSpec.userStories) {
-    const mappings = mapUserStoryToProjects(userStory);
-
-    if (mappings.length > 0) {
-      const primary = mappings[0];
-      console.log(formatProjectMappingReport(userStory, mappings));
-      console.log('');
-
-      projectStats.set(primary.projectId, (projectStats.get(primary.projectId) || 0) + 1);
-    } else {
-      console.log(`❌ ${userStory.id}: ${userStory.title} → NO MATCH (assign to SHARED)`);
-      console.log('');
-      projectStats.set('SHARED', (projectStats.get('SHARED') || 0) + 1);
-    }
-  }
-
-  // Print summary
-  console.log('📈 Project Distribution:\n');
-  const totalStories = parsedSpec.userStories.length;
-
-  for (const [projectId, count] of projectStats.entries()) {
-    const percentage = ((count / totalStories) * 100).toFixed(0);
-    console.log(`  ${projectId}: ${count} user stories (${percentage}%)`);
-  }
-
-  console.log('');
-
-  // Create folder structure
-  console.log('📁 Creating multi-project folder structure...\n');
-
-  const allProjectIds = [...projectStats.keys()];
-  await createMultiProjectFolderStructure(outputDir, allProjectIds);
-
-  console.log('✓ Folder structure created\n');
-
-  // Split spec
-  console.log('✂️  Splitting spec into project-specific files...\n');
-
-  const outputMap = await splitSpecIntoProjects(specPath, outputDir);
-
-  for (const [projectId, filePath] of outputMap.entries()) {
-    console.log(`✓ ${projectId}: ${filePath}`);
-  }
-
-  console.log('');
-  console.log('✅ Spec splitting complete!');
-  console.log('');
-  console.log('Next steps:');
-  console.log('1. Review project-specific specs in:', outputDir);
-  console.log('2. Configure JIRA sync for each project');
-  console.log('3. Run /specweave-jira:sync to create JIRA items');
-}
-
-main().catch((error) => {
-  console.error('❌ Error:', error.message);
-  console.error(error.stack);
-  process.exit(1);
-});

package/dist/spec-splitter.js

@@ -1,283 +0,0 @@
-/**
- * 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 * as fs from 'fs-extra';
-import * as path from 'path';
-import { splitSpecByProject, DEFAULT_PROJECT_RULES } from './project-mapper.js';
-/**
- * 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 metadata = parseFrontmatter(frontmatterMatch[1]);
-    // 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 = {};
-    for (const line of lines) {
-        const match = line.match(/^(\w+):\s*(.+)$/);
-        if (match) {
-            const key = match[1];
-            const value = match[2].trim();
-            // Handle arrays
-            if (value.startsWith('[')) {
-                metadata[key] = JSON.parse(value);
-            }
-            else {
-                metadata[key] = value.replace(/^["']|["']$/g, '');
-            }
-        }
-    }
-    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 outputPath = path.join(projectDir, `spec-${parsedSpec.metadata.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');
-    }
-}