@dedesfr/prompter 0.9.0 → 1.0.0

package/src/core/converters/json-converter.ts

@@ -1,62 +0,0 @@
-import { readFileSync } from 'fs';
-import path from 'path';
-import { MarkdownParser } from '../parsers/markdown-parser.js';
-import { ChangeParser } from '../parsers/change-parser.js';
-import { Spec, Change } from '../schemas/index.js';
-import { FileSystemUtils } from '../../utils/file-system.js';
-
-export class JsonConverter {
-  convertSpecToJson(filePath: string): string {
-    const content = readFileSync(filePath, 'utf-8');
-    const parser = new MarkdownParser(content);
-    const specName = this.extractNameFromPath(filePath);
-    
-    const spec = parser.parseSpec(specName);
-    
-    const jsonSpec = {
-      ...spec,
-      metadata: {
-        ...spec.metadata,
-        sourcePath: filePath,
-      },
-    };
-    
-    return JSON.stringify(jsonSpec, null, 2);
-  }
-
-  async convertChangeToJson(filePath: string): Promise<string> {
-    const content = readFileSync(filePath, 'utf-8');
-    const changeName = this.extractNameFromPath(filePath);
-    const changeDir = path.dirname(filePath);
-    const parser = new ChangeParser(content, changeDir);
-    
-    const change = await parser.parseChangeWithDeltas(changeName);
-    
-    const jsonChange = {
-      ...change,
-      metadata: {
-        ...change.metadata,
-        sourcePath: filePath,
-      },
-    };
-    
-    return JSON.stringify(jsonChange, null, 2);
-  }
-
-  private extractNameFromPath(filePath: string): string {
-    const normalizedPath = FileSystemUtils.toPosixPath(filePath);
-    const parts = normalizedPath.split('/');
-    
-    for (let i = parts.length - 1; i >= 0; i--) {
-      if (parts[i] === 'specs' || parts[i] === 'changes') {
-        if (i < parts.length - 1) {
-          return parts[i + 1];
-        }
-      }
-    }
-    
-    const fileName = parts[parts.length - 1] ?? '';
-    const dotIndex = fileName.lastIndexOf('.');
-    return dotIndex > 0 ? fileName.slice(0, dotIndex) : fileName;
-  }
-}

package/src/core/global-config.ts

@@ -1,136 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as os from 'node:os';
-
-// Constants
-export const GLOBAL_CONFIG_DIR_NAME = 'prompter';
-export const GLOBAL_CONFIG_FILE_NAME = 'config.json';
-export const GLOBAL_DATA_DIR_NAME = 'prompter';
-
-// TypeScript interfaces
-export interface GlobalConfig {
-  featureFlags?: Record<string, boolean>;
-}
-
-const DEFAULT_CONFIG: GlobalConfig = {
-  featureFlags: {}
-};
-
-/**
- * Gets the global configuration directory path following XDG Base Directory Specification.
- *
- * - All platforms: $XDG_CONFIG_HOME/prompter/ if XDG_CONFIG_HOME is set
- * - Unix/macOS fallback: ~/.config/prompter/
- * - Windows fallback: %APPDATA%/prompter/
- */
-export function getGlobalConfigDir(): string {
-  // XDG_CONFIG_HOME takes precedence on all platforms when explicitly set
-  const xdgConfigHome = process.env.XDG_CONFIG_HOME;
-  if (xdgConfigHome) {
-    return path.join(xdgConfigHome, GLOBAL_CONFIG_DIR_NAME);
-  }
-
-  const platform = os.platform();
-
-  if (platform === 'win32') {
-    // Windows: use %APPDATA%
-    const appData = process.env.APPDATA;
-    if (appData) {
-      return path.join(appData, GLOBAL_CONFIG_DIR_NAME);
-    }
-    // Fallback for Windows if APPDATA is not set
-    return path.join(os.homedir(), 'AppData', 'Roaming', GLOBAL_CONFIG_DIR_NAME);
-  }
-
-  // Unix/macOS fallback: ~/.config
-  return path.join(os.homedir(), '.config', GLOBAL_CONFIG_DIR_NAME);
-}
-
-/**
- * Gets the global data directory path following XDG Base Directory Specification.
- * Used for user data like schema overrides.
- *
- * - All platforms: $XDG_DATA_HOME/prompter/ if XDG_DATA_HOME is set
- * - Unix/macOS fallback: ~/.local/share/prompter/
- * - Windows fallback: %LOCALAPPDATA%/prompter/
- */
-export function getGlobalDataDir(): string {
-  // XDG_DATA_HOME takes precedence on all platforms when explicitly set
-  const xdgDataHome = process.env.XDG_DATA_HOME;
-  if (xdgDataHome) {
-    return path.join(xdgDataHome, GLOBAL_DATA_DIR_NAME);
-  }
-
-  const platform = os.platform();
-
-  if (platform === 'win32') {
-    // Windows: use %LOCALAPPDATA%
-    const localAppData = process.env.LOCALAPPDATA;
-    if (localAppData) {
-      return path.join(localAppData, GLOBAL_DATA_DIR_NAME);
-    }
-    // Fallback for Windows if LOCALAPPDATA is not set
-    return path.join(os.homedir(), 'AppData', 'Local', GLOBAL_DATA_DIR_NAME);
-  }
-
-  // Unix/macOS fallback: ~/.local/share
-  return path.join(os.homedir(), '.local', 'share', GLOBAL_DATA_DIR_NAME);
-}
-
-/**
- * Gets the path to the global config file.
- */
-export function getGlobalConfigPath(): string {
-  return path.join(getGlobalConfigDir(), GLOBAL_CONFIG_FILE_NAME);
-}
-
-/**
- * Loads the global configuration from disk.
- * Returns default configuration if file doesn't exist or is invalid.
- * Merges loaded config with defaults to ensure new fields are available.
- */
-export function getGlobalConfig(): GlobalConfig {
-  const configPath = getGlobalConfigPath();
-
-  try {
-    if (!fs.existsSync(configPath)) {
-      return { ...DEFAULT_CONFIG };
-    }
-
-    const content = fs.readFileSync(configPath, 'utf-8');
-    const parsed = JSON.parse(content);
-
-    // Merge with defaults (loaded values take precedence)
-    return {
-      ...DEFAULT_CONFIG,
-      ...parsed,
-      // Deep merge featureFlags
-      featureFlags: {
-        ...DEFAULT_CONFIG.featureFlags,
-        ...(parsed.featureFlags || {})
-      }
-    };
-  } catch (error) {
-    // Log warning for parse errors, but not for missing files
-    if (error instanceof SyntaxError) {
-      console.error(`Warning: Invalid JSON in ${configPath}, using defaults`);
-    }
-    return { ...DEFAULT_CONFIG };
-  }
-}
-
-/**
- * Saves the global configuration to disk.
- * Creates the config directory if it doesn't exist.
- */
-export function saveGlobalConfig(config: GlobalConfig): void {
-  const configDir = getGlobalConfigDir();
-  const configPath = getGlobalConfigPath();
-
-  // Create directory if it doesn't exist
-  if (!fs.existsSync(configDir)) {
-    fs.mkdirSync(configDir, { recursive: true });
-  }
-
-  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-}

package/src/core/parsers/change-parser.ts

@@ -1,234 +0,0 @@
-import { MarkdownParser, Section } from './markdown-parser.js';
-import { Change, Delta, DeltaOperation, Requirement } from '../schemas/index.js';
-import path from 'path';
-import { promises as fs } from 'fs';
-
-interface DeltaSection {
-  operation: DeltaOperation;
-  requirements: Requirement[];
-  renames?: Array<{ from: string; to: string }>;
-}
-
-export class ChangeParser extends MarkdownParser {
-  private changeDir: string;
-
-  constructor(content: string, changeDir: string) {
-    super(content);
-    this.changeDir = changeDir;
-  }
-
-  async parseChangeWithDeltas(name: string): Promise<Change> {
-    const sections = this.parseSections();
-    const why = this.findSection(sections, 'Why')?.content || '';
-    const whatChanges = this.findSection(sections, 'What Changes')?.content || '';
-    
-    if (!why) {
-      throw new Error('Change must have a Why section');
-    }
-    
-    if (!whatChanges) {
-      throw new Error('Change must have a What Changes section');
-    }
-
-    // Parse deltas from the What Changes section (simple format)
-    const simpleDeltas = this.parseDeltas(whatChanges);
-    
-    // Check if there are spec files with delta format
-    const specsDir = path.join(this.changeDir, 'specs');
-    const deltaDeltas = await this.parseDeltaSpecs(specsDir);
-    
-    // Combine both types of deltas, preferring delta format if available
-    const deltas = deltaDeltas.length > 0 ? deltaDeltas : simpleDeltas;
-
-    return {
-      name,
-      why: why.trim(),
-      whatChanges: whatChanges.trim(),
-      deltas,
-      metadata: {
-        version: '1.0.0',
-        format: 'prompter-change',
-      },
-    };
-  }
-
-  private async parseDeltaSpecs(specsDir: string): Promise<Delta[]> {
-    const deltas: Delta[] = [];
-    
-    try {
-      const specDirs = await fs.readdir(specsDir, { withFileTypes: true });
-      
-      for (const dir of specDirs) {
-        if (!dir.isDirectory()) continue;
-        
-        const specName = dir.name;
-        const specFile = path.join(specsDir, specName, 'spec.md');
-        
-        try {
-          const content = await fs.readFile(specFile, 'utf-8');
-          const specDeltas = this.parseSpecDeltas(specName, content);
-          deltas.push(...specDeltas);
-        } catch (error) {
-          // Spec file might not exist, which is okay
-          continue;
-        }
-      }
-    } catch (error) {
-      // Specs directory might not exist, which is okay
-      return [];
-    }
-    
-    return deltas;
-  }
-
-  private parseSpecDeltas(specName: string, content: string): Delta[] {
-    const deltas: Delta[] = [];
-    const sections = this.parseSectionsFromContent(content);
-    
-    // Parse ADDED requirements
-    const addedSection = this.findSection(sections, 'ADDED Requirements');
-    if (addedSection) {
-      const requirements = this.parseRequirements(addedSection);
-      requirements.forEach(req => {
-        deltas.push({
-          spec: specName,
-          operation: 'ADDED' as DeltaOperation,
-          description: `Add requirement: ${req.text}`,
-          // Provide both single and plural forms for compatibility
-          requirement: req,
-          requirements: [req],
-        });
-      });
-    }
-    
-    // Parse MODIFIED requirements
-    const modifiedSection = this.findSection(sections, 'MODIFIED Requirements');
-    if (modifiedSection) {
-      const requirements = this.parseRequirements(modifiedSection);
-      requirements.forEach(req => {
-        deltas.push({
-          spec: specName,
-          operation: 'MODIFIED' as DeltaOperation,
-          description: `Modify requirement: ${req.text}`,
-          requirement: req,
-          requirements: [req],
-        });
-      });
-    }
-    
-    // Parse REMOVED requirements
-    const removedSection = this.findSection(sections, 'REMOVED Requirements');
-    if (removedSection) {
-      const requirements = this.parseRequirements(removedSection);
-      requirements.forEach(req => {
-        deltas.push({
-          spec: specName,
-          operation: 'REMOVED' as DeltaOperation,
-          description: `Remove requirement: ${req.text}`,
-          requirement: req,
-          requirements: [req],
-        });
-      });
-    }
-    
-    // Parse RENAMED requirements
-    const renamedSection = this.findSection(sections, 'RENAMED Requirements');
-    if (renamedSection) {
-      const renames = this.parseRenames(renamedSection.content);
-      renames.forEach(rename => {
-        deltas.push({
-          spec: specName,
-          operation: 'RENAMED' as DeltaOperation,
-          description: `Rename requirement from "${rename.from}" to "${rename.to}"`,
-          rename,
-        });
-      });
-    }
-    
-    return deltas;
-  }
-
-  private parseRenames(content: string): Array<{ from: string; to: string }> {
-    const renames: Array<{ from: string; to: string }> = [];
-    const lines = ChangeParser.normalizeContent(content).split('\n');
-    
-    let currentRename: { from?: string; to?: string } = {};
-    
-    for (const line of lines) {
-      const fromMatch = line.match(/^\s*-?\s*FROM:\s*`?###\s*Requirement:\s*(.+?)`?\s*$/);
-      const toMatch = line.match(/^\s*-?\s*TO:\s*`?###\s*Requirement:\s*(.+?)`?\s*$/);
-      
-      if (fromMatch) {
-        currentRename.from = fromMatch[1].trim();
-      } else if (toMatch) {
-        currentRename.to = toMatch[1].trim();
-        
-        if (currentRename.from && currentRename.to) {
-          renames.push({
-            from: currentRename.from,
-            to: currentRename.to,
-          });
-          currentRename = {};
-        }
-      }
-    }
-    
-    return renames;
-  }
-
-  private parseSectionsFromContent(content: string): Section[] {
-    const normalizedContent = ChangeParser.normalizeContent(content);
-    const lines = normalizedContent.split('\n');
-    const sections: Section[] = [];
-    const stack: Section[] = [];
-    
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i];
-      const headerMatch = line.match(/^(#{1,6})\s+(.+)$/);
-      
-      if (headerMatch) {
-        const level = headerMatch[1].length;
-        const title = headerMatch[2].trim();
-        const contentLines = this.getContentUntilNextHeaderFromLines(lines, i + 1, level);
-        
-        const section = {
-          level,
-          title,
-          content: contentLines.join('\n').trim(),
-          children: [],
-        };
-
-        while (stack.length > 0 && stack[stack.length - 1].level >= level) {
-          stack.pop();
-        }
-
-        if (stack.length === 0) {
-          sections.push(section);
-        } else {
-          stack[stack.length - 1].children.push(section);
-        }
-        
-        stack.push(section);
-      }
-    }
-    
-    return sections;
-  }
-
-  private getContentUntilNextHeaderFromLines(lines: string[], startLine: number, currentLevel: number): string[] {
-    const contentLines: string[] = [];
-    
-    for (let i = startLine; i < lines.length; i++) {
-      const line = lines[i];
-      const headerMatch = line.match(/^(#{1,6})\s+/);
-      
-      if (headerMatch && headerMatch[1].length <= currentLevel) {
-        break;
-      }
-      
-      contentLines.push(line);
-    }
-    
-    return contentLines;
-  }
-}

package/src/core/parsers/markdown-parser.ts

@@ -1,237 +0,0 @@
-import { Spec, Change, Requirement, Scenario, Delta, DeltaOperation } from '../schemas/index.js';
-
-export interface Section {
-  level: number;
-  title: string;
-  content: string;
-  children: Section[];
-}
-
-export class MarkdownParser {
-  private lines: string[];
-  private currentLine: number;
-
-  constructor(content: string) {
-    const normalized = MarkdownParser.normalizeContent(content);
-    this.lines = normalized.split('\n');
-    this.currentLine = 0;
-  }
-
-  protected static normalizeContent(content: string): string {
-    return content.replace(/\r\n?/g, '\n');
-  }
-
-  parseSpec(name: string): Spec {
-    const sections = this.parseSections();
-    const purpose = this.findSection(sections, 'Purpose')?.content || '';
-    
-    const requirementsSection = this.findSection(sections, 'Requirements');
-    
-    if (!purpose) {
-      throw new Error('Spec must have a Purpose section');
-    }
-    
-    if (!requirementsSection) {
-      throw new Error('Spec must have a Requirements section');
-    }
-
-    const requirements = this.parseRequirements(requirementsSection);
-
-    return {
-      name,
-      overview: purpose.trim(),
-      requirements,
-      metadata: {
-        version: '1.0.0',
-        format: 'prompter',
-      },
-    };
-  }
-
-  parseChange(name: string): Change {
-    const sections = this.parseSections();
-    const why = this.findSection(sections, 'Why')?.content || '';
-    const whatChanges = this.findSection(sections, 'What Changes')?.content || '';
-    
-    if (!why) {
-      throw new Error('Change must have a Why section');
-    }
-    
-    if (!whatChanges) {
-      throw new Error('Change must have a What Changes section');
-    }
-
-    const deltas = this.parseDeltas(whatChanges);
-
-    return {
-      name,
-      why: why.trim(),
-      whatChanges: whatChanges.trim(),
-      deltas,
-      metadata: {
-        version: '1.0.0',
-        format: 'prompter-change',
-      },
-    };
-  }
-
-  protected parseSections(): Section[] {
-    const sections: Section[] = [];
-    const stack: Section[] = [];
-    
-    for (let i = 0; i < this.lines.length; i++) {
-      const line = this.lines[i];
-      const headerMatch = line.match(/^(#{1,6})\s+(.+)$/);
-      
-      if (headerMatch) {
-        const level = headerMatch[1].length;
-        const title = headerMatch[2].trim();
-        const content = this.getContentUntilNextHeader(i + 1, level);
-        
-        const section: Section = {
-          level,
-          title,
-          content,
-          children: [],
-        };
-
-        while (stack.length > 0 && stack[stack.length - 1].level >= level) {
-          stack.pop();
-        }
-
-        if (stack.length === 0) {
-          sections.push(section);
-        } else {
-          stack[stack.length - 1].children.push(section);
-        }
-        
-        stack.push(section);
-      }
-    }
-    
-    return sections;
-  }
-
-  protected getContentUntilNextHeader(startLine: number, currentLevel: number): string {
-    const contentLines: string[] = [];
-    
-    for (let i = startLine; i < this.lines.length; i++) {
-      const line = this.lines[i];
-      const headerMatch = line.match(/^(#{1,6})\s+/);
-      
-      if (headerMatch && headerMatch[1].length <= currentLevel) {
-        break;
-      }
-      
-      contentLines.push(line);
-    }
-    
-    return contentLines.join('\n').trim();
-  }
-
-  protected findSection(sections: Section[], title: string): Section | undefined {
-    for (const section of sections) {
-      if (section.title.toLowerCase() === title.toLowerCase()) {
-        return section;
-      }
-      const child = this.findSection(section.children, title);
-      if (child) {
-        return child;
-      }
-    }
-    return undefined;
-  }
-
-  protected parseRequirements(section: Section): Requirement[] {
-    const requirements: Requirement[] = [];
-    
-    for (const child of section.children) {
-      // Extract requirement text from first non-empty content line, fall back to heading
-      let text = child.title;
-      
-      // Get content before any child sections (scenarios)
-      if (child.content.trim()) {
-        // Split content into lines and find content before any child headers
-        const lines = child.content.split('\n');
-        const contentBeforeChildren: string[] = [];
-        
-        for (const line of lines) {
-          // Stop at child headers (scenarios start with ####)
-          if (line.trim().startsWith('#')) {
-            break;
-          }
-          contentBeforeChildren.push(line);
-        }
-        
-        // Find first non-empty line
-        const directContent = contentBeforeChildren.join('\n').trim();
-        if (directContent) {
-          const firstLine = directContent.split('\n').find(l => l.trim());
-          if (firstLine) {
-            text = firstLine.trim();
-          }
-        }
-      }
-      
-      const scenarios = this.parseScenarios(child);
-      
-      requirements.push({
-        text,
-        scenarios,
-      });
-    }
-    
-    return requirements;
-  }
-
-  protected parseScenarios(requirementSection: Section): Scenario[] {
-    const scenarios: Scenario[] = [];
-    
-    for (const scenarioSection of requirementSection.children) {
-      // Store the raw text content of the scenario section
-      if (scenarioSection.content.trim()) {
-        scenarios.push({
-          rawText: scenarioSection.content
-        });
-      }
-    }
-    
-    return scenarios;
-  }
-
-
-  protected parseDeltas(content: string): Delta[] {
-    const deltas: Delta[] = [];
-    const lines = content.split('\n');
-    
-    for (const line of lines) {
-      // Match both formats: **spec:** and **spec**:
-      const deltaMatch = line.match(/^\s*-\s*\*\*([^*:]+)(?::\*\*|\*\*:)\s*(.+)$/);
-      if (deltaMatch) {
-        const specName = deltaMatch[1].trim();
-        const description = deltaMatch[2].trim();
-        
-        let operation: DeltaOperation = 'MODIFIED';
-        const lowerDesc = description.toLowerCase();
-        
-        // Use word boundaries to avoid false matches (e.g., "address" matching "add")
-        // Check RENAMED first since it's more specific than patterns containing "new"
-        if (/\brename(s|d|ing)?\b/.test(lowerDesc) || /\brenamed\s+(to|from)\b/.test(lowerDesc)) {
-          operation = 'RENAMED';
-        } else if (/\badd(s|ed|ing)?\b/.test(lowerDesc) || /\bcreate(s|d|ing)?\b/.test(lowerDesc) || /\bnew\b/.test(lowerDesc)) {
-          operation = 'ADDED';
-        } else if (/\bremove(s|d|ing)?\b/.test(lowerDesc) || /\bdelete(s|d|ing)?\b/.test(lowerDesc)) {
-          operation = 'REMOVED';
-        }
-        
-        deltas.push({
-          spec: specName,
-          operation,
-          description,
-        });
-      }
-    }
-    
-    return deltas;
-  }
-}