@dedesfr/prompter 0.8.23 → 1.0.0

package/src/core/view.ts

@@ -1,219 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import chalk from 'chalk';
-import { getTaskProgressForChange, formatTaskStatus } from '../utils/task-progress.js';
-import { MarkdownParser } from './parsers/markdown-parser.js';
-
-export class ViewCommand {
-  async execute(targetPath: string = '.'): Promise<void> {
-    const prompterDir = path.join(targetPath, 'prompter');
-    
-    if (!fs.existsSync(prompterDir)) {
-      console.error(chalk.red('No prompter directory found'));
-      process.exit(1);
-    }
-
-    console.log(chalk.bold('\nPrompter Dashboard\n'));
-    console.log('═'.repeat(60));
-
-    // Get changes and specs data
-    const changesData = await this.getChangesData(prompterDir);
-    const specsData = await this.getSpecsData(prompterDir);
-
-    // Display summary metrics
-    this.displaySummary(changesData, specsData);
-
-    // Display draft changes
-    if (changesData.draft.length > 0) {
-      console.log(chalk.bold.gray('\nDraft Changes'));
-      console.log('─'.repeat(60));
-      changesData.draft.forEach((change) => {
-        console.log(`  ${chalk.gray('○')} ${change.name}`);
-      });
-    }
-
-    // Display active changes
-    if (changesData.active.length > 0) {
-      console.log(chalk.bold.cyan('\nActive Changes'));
-      console.log('─'.repeat(60));
-      changesData.active.forEach((change) => {
-        const progressBar = this.createProgressBar(change.progress.completed, change.progress.total);
-        const percentage =
-          change.progress.total > 0
-            ? Math.round((change.progress.completed / change.progress.total) * 100)
-            : 0;
-
-        console.log(
-          `  ${chalk.yellow('◉')} ${chalk.bold(change.name.padEnd(30))} ${progressBar} ${chalk.dim(`${percentage}%`)}`
-        );
-      });
-    }
-
-    // Display completed changes
-    if (changesData.completed.length > 0) {
-      console.log(chalk.bold.green('\nCompleted Changes'));
-      console.log('─'.repeat(60));
-      changesData.completed.forEach((change) => {
-        console.log(`  ${chalk.green('✓')} ${change.name}`);
-      });
-    }
-
-    // Display specifications
-    if (specsData.length > 0) {
-      console.log(chalk.bold.blue('\nSpecifications'));
-      console.log('─'.repeat(60));
-      
-      // Sort specs by requirement count (descending)
-      specsData.sort((a, b) => b.requirementCount - a.requirementCount);
-      
-      specsData.forEach(spec => {
-        const reqLabel = spec.requirementCount === 1 ? 'requirement' : 'requirements';
-        console.log(
-          `  ${chalk.blue('▪')} ${chalk.bold(spec.name.padEnd(30))} ${chalk.dim(`${spec.requirementCount} ${reqLabel}`)}`
-        );
-      });
-    }
-
-    console.log('\n' + '═'.repeat(60));
-    console.log(chalk.dim(`\nUse ${chalk.white('prompter list --changes')} or ${chalk.white('prompter list --specs')} for detailed views`));
-  }
-
-  private async getChangesData(prompterDir: string): Promise<{
-    draft: Array<{ name: string }>;
-    active: Array<{ name: string; progress: { total: number; completed: number } }>;
-    completed: Array<{ name: string }>;
-  }> {
-    const changesDir = path.join(prompterDir, 'changes');
-
-    if (!fs.existsSync(changesDir)) {
-      return { draft: [], active: [], completed: [] };
-    }
-
-    const draft: Array<{ name: string }> = [];
-    const active: Array<{ name: string; progress: { total: number; completed: number } }> = [];
-    const completed: Array<{ name: string }> = [];
-
-    const entries = fs.readdirSync(changesDir, { withFileTypes: true });
-
-    for (const entry of entries) {
-      if (entry.isDirectory() && entry.name !== 'archive') {
-        const progress = await getTaskProgressForChange(changesDir, entry.name);
-
-        if (progress.total === 0) {
-          // No tasks defined yet - still in planning/draft phase
-          draft.push({ name: entry.name });
-        } else if (progress.completed === progress.total) {
-          // All tasks complete
-          completed.push({ name: entry.name });
-        } else {
-          // Has tasks but not all complete
-          active.push({ name: entry.name, progress });
-        }
-      }
-    }
-
-    // Sort all categories by name for deterministic ordering
-    draft.sort((a, b) => a.name.localeCompare(b.name));
-
-    // Sort active changes by completion percentage (ascending) and then by name
-    active.sort((a, b) => {
-      const percentageA = a.progress.total > 0 ? a.progress.completed / a.progress.total : 0;
-      const percentageB = b.progress.total > 0 ? b.progress.completed / b.progress.total : 0;
-
-      if (percentageA < percentageB) return -1;
-      if (percentageA > percentageB) return 1;
-      return a.name.localeCompare(b.name);
-    });
-    completed.sort((a, b) => a.name.localeCompare(b.name));
-
-    return { draft, active, completed };
-  }
-
-  private async getSpecsData(prompterDir: string): Promise<Array<{ name: string; requirementCount: number }>> {
-    const specsDir = path.join(prompterDir, 'specs');
-    
-    if (!fs.existsSync(specsDir)) {
-      return [];
-    }
-
-    const specs: Array<{ name: string; requirementCount: number }> = [];
-    const entries = fs.readdirSync(specsDir, { withFileTypes: true });
-    
-    for (const entry of entries) {
-      if (entry.isDirectory()) {
-        const specFile = path.join(specsDir, entry.name, 'spec.md');
-        
-        if (fs.existsSync(specFile)) {
-          try {
-            const content = fs.readFileSync(specFile, 'utf-8');
-            const parser = new MarkdownParser(content);
-            const spec = parser.parseSpec(entry.name);
-            const requirementCount = spec.requirements.length;
-            specs.push({ name: entry.name, requirementCount });
-          } catch (error) {
-            // If spec cannot be parsed, include with 0 count
-            specs.push({ name: entry.name, requirementCount: 0 });
-          }
-        }
-      }
-    }
-
-    return specs;
-  }
-
-  private displaySummary(
-    changesData: { draft: any[]; active: any[]; completed: any[] },
-    specsData: any[]
-  ): void {
-    const totalChanges =
-      changesData.draft.length + changesData.active.length + changesData.completed.length;
-    const totalSpecs = specsData.length;
-    const totalRequirements = specsData.reduce((sum, spec) => sum + spec.requirementCount, 0);
-
-    // Calculate total task progress
-    let totalTasks = 0;
-    let completedTasks = 0;
-
-    changesData.active.forEach((change) => {
-      totalTasks += change.progress.total;
-      completedTasks += change.progress.completed;
-    });
-
-    changesData.completed.forEach(() => {
-      // Completed changes count as 100% done (we don't know exact task count)
-      // This is a simplification
-    });
-
-    console.log(chalk.bold('Summary:'));
-    console.log(
-      `  ${chalk.cyan('●')} Specifications: ${chalk.bold(totalSpecs)} specs, ${chalk.bold(totalRequirements)} requirements`
-    );
-    if (changesData.draft.length > 0) {
-      console.log(`  ${chalk.gray('●')} Draft Changes: ${chalk.bold(changesData.draft.length)}`);
-    }
-    console.log(
-      `  ${chalk.yellow('●')} Active Changes: ${chalk.bold(changesData.active.length)} in progress`
-    );
-    console.log(`  ${chalk.green('●')} Completed Changes: ${chalk.bold(changesData.completed.length)}`);
-
-    if (totalTasks > 0) {
-      const overallProgress = Math.round((completedTasks / totalTasks) * 100);
-      console.log(
-        `  ${chalk.magenta('●')} Task Progress: ${chalk.bold(`${completedTasks}/${totalTasks}`)} (${overallProgress}% complete)`
-      );
-    }
-  }
-
-  private createProgressBar(completed: number, total: number, width: number = 20): string {
-    if (total === 0) return chalk.dim('─'.repeat(width));
-    
-    const percentage = completed / total;
-    const filled = Math.round(percentage * width);
-    const empty = width - filled;
-    
-    const filledBar = chalk.green('█'.repeat(filled));
-    const emptyBar = chalk.dim('░'.repeat(empty));
-    
-    return `[${filledBar}${emptyBar}]`;
-  }
-}

package/src/index.ts

@@ -1 +0,0 @@
-export { PrompterConfig } from './core/config.js';

package/src/utils/change-metadata.ts

@@ -1,171 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as yaml from 'yaml';
-import { ChangeMetadataSchema, type ChangeMetadata } from '../core/artifact-graph/types.js';
-import { listSchemas } from '../core/artifact-graph/resolver.js';
-
-const METADATA_FILENAME = '.prompter.yaml';
-
-/**
- * Error thrown when change metadata validation fails.
- */
-export class ChangeMetadataError extends Error {
-  constructor(
-    message: string,
-    public readonly metadataPath: string,
-    public readonly cause?: Error
-  ) {
-    super(message);
-    this.name = 'ChangeMetadataError';
-  }
-}
-
-/**
- * Validates that a schema name is valid (exists in available schemas).
- *
- * @param schemaName - The schema name to validate
- * @returns The validated schema name
- * @throws Error if schema is not found
- */
-export function validateSchemaName(schemaName: string): string {
-  const availableSchemas = listSchemas();
-  if (!availableSchemas.includes(schemaName)) {
-    throw new Error(
-      `Unknown schema '${schemaName}'. Available: ${availableSchemas.join(', ')}`
-    );
-  }
-  return schemaName;
-}
-
-/**
- * Writes change metadata to .prompter.yaml in the change directory.
- *
- * @param changeDir - The path to the change directory
- * @param metadata - The metadata to write
- * @throws ChangeMetadataError if validation fails or write fails
- */
-export function writeChangeMetadata(
-  changeDir: string,
-  metadata: ChangeMetadata
-): void {
-  const metaPath = path.join(changeDir, METADATA_FILENAME);
-
-  // Validate schema exists
-  validateSchemaName(metadata.schema);
-
-  // Validate with Zod
-  const parseResult = ChangeMetadataSchema.safeParse(metadata);
-  if (!parseResult.success) {
-    throw new ChangeMetadataError(
-      `Invalid metadata: ${parseResult.error.message}`,
-      metaPath
-    );
-  }
-
-  // Write YAML file
-  const content = yaml.stringify(parseResult.data);
-  try {
-    fs.writeFileSync(metaPath, content, 'utf-8');
-  } catch (err) {
-    const ioError = err instanceof Error ? err : new Error(String(err));
-    throw new ChangeMetadataError(
-      `Failed to write metadata: ${ioError.message}`,
-      metaPath,
-      ioError
-    );
-  }
-}
-
-/**
- * Reads change metadata from .prompter.yaml in the change directory.
- *
- * @param changeDir - The path to the change directory
- * @returns The validated metadata, or null if no metadata file exists
- * @throws ChangeMetadataError if the file exists but is invalid
- */
-export function readChangeMetadata(changeDir: string): ChangeMetadata | null {
-  const metaPath = path.join(changeDir, METADATA_FILENAME);
-
-  if (!fs.existsSync(metaPath)) {
-    return null;
-  }
-
-  let content: string;
-  try {
-    content = fs.readFileSync(metaPath, 'utf-8');
-  } catch (err) {
-    const ioError = err instanceof Error ? err : new Error(String(err));
-    throw new ChangeMetadataError(
-      `Failed to read metadata: ${ioError.message}`,
-      metaPath,
-      ioError
-    );
-  }
-
-  let parsed: unknown;
-  try {
-    parsed = yaml.parse(content);
-  } catch (err) {
-    const parseError = err instanceof Error ? err : new Error(String(err));
-    throw new ChangeMetadataError(
-      `Invalid YAML in metadata file: ${parseError.message}`,
-      metaPath,
-      parseError
-    );
-  }
-
-  // Validate with Zod
-  const parseResult = ChangeMetadataSchema.safeParse(parsed);
-  if (!parseResult.success) {
-    throw new ChangeMetadataError(
-      `Invalid metadata: ${parseResult.error.message}`,
-      metaPath
-    );
-  }
-
-  // Validate that the schema exists
-  const availableSchemas = listSchemas();
-  if (!availableSchemas.includes(parseResult.data.schema)) {
-    throw new ChangeMetadataError(
-      `Unknown schema '${parseResult.data.schema}'. Available: ${availableSchemas.join(', ')}`,
-      metaPath
-    );
-  }
-
-  return parseResult.data;
-}
-
-/**
- * Resolves the schema for a change, with explicit override taking precedence.
- *
- * Resolution order:
- * 1. Explicit schema (if provided)
- * 2. Schema from .prompter.yaml metadata (if exists)
- * 3. Default 'spec-driven'
- *
- * @param changeDir - The path to the change directory
- * @param explicitSchema - Optional explicit schema override
- * @returns The resolved schema name
- */
-export function resolveSchemaForChange(
-  changeDir: string,
-  explicitSchema?: string
-): string {
-  // 1. Explicit override wins
-  if (explicitSchema) {
-    return explicitSchema;
-  }
-
-  // 2. Try reading from metadata
-  try {
-    const metadata = readChangeMetadata(changeDir);
-    if (metadata?.schema) {
-      return metadata.schema;
-    }
-  } catch {
-    // If metadata read fails, fall back to default
-  }
-
-  // 3. Default
-  return 'spec-driven';
-}

package/src/utils/change-utils.ts

@@ -1,131 +0,0 @@
-import path from 'path';
-import { FileSystemUtils } from './file-system.js';
-import { writeChangeMetadata, validateSchemaName } from './change-metadata.js';
-
-const DEFAULT_SCHEMA = 'spec-driven';
-
-/**
- * Options for creating a change.
- */
-export interface CreateChangeOptions {
-  /** The workflow schema to use (default: 'spec-driven') */
-  schema?: string;
-}
-
-/**
- * Result of validating a change name.
- */
-export interface ValidationResult {
-  valid: boolean;
-  error?: string;
-}
-
-/**
- * Validates that a change name follows kebab-case conventions.
- *
- * Valid names:
- * - Start with a lowercase letter
- * - Contain only lowercase letters, numbers, and hyphens
- * - Do not start or end with a hyphen
- * - Do not contain consecutive hyphens
- *
- * @param name - The change name to validate
- * @returns Validation result with `valid: true` or `valid: false` with an error message
- *
- * @example
- * validateChangeName('add-auth') // { valid: true }
- * validateChangeName('Add-Auth') // { valid: false, error: '...' }
- */
-export function validateChangeName(name: string): ValidationResult {
-  // Pattern: starts with lowercase letter, followed by lowercase letters/numbers,
-  // optionally followed by hyphen + lowercase letters/numbers (repeatable)
-  const kebabCasePattern = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
-
-  if (!name) {
-    return { valid: false, error: 'Change name cannot be empty' };
-  }
-
-  if (!kebabCasePattern.test(name)) {
-    // Provide specific error messages for common mistakes
-    if (/[A-Z]/.test(name)) {
-      return { valid: false, error: 'Change name must be lowercase (use kebab-case)' };
-    }
-    if (/\s/.test(name)) {
-      return { valid: false, error: 'Change name cannot contain spaces (use hyphens instead)' };
-    }
-    if (/_/.test(name)) {
-      return { valid: false, error: 'Change name cannot contain underscores (use hyphens instead)' };
-    }
-    if (name.startsWith('-')) {
-      return { valid: false, error: 'Change name cannot start with a hyphen' };
-    }
-    if (name.endsWith('-')) {
-      return { valid: false, error: 'Change name cannot end with a hyphen' };
-    }
-    if (/--/.test(name)) {
-      return { valid: false, error: 'Change name cannot contain consecutive hyphens' };
-    }
-    if (/[^a-z0-9-]/.test(name)) {
-      return { valid: false, error: 'Change name can only contain lowercase letters, numbers, and hyphens' };
-    }
-    if (/^[0-9]/.test(name)) {
-      return { valid: false, error: 'Change name must start with a letter' };
-    }
-
-    return { valid: false, error: 'Change name must follow kebab-case convention (e.g., add-auth, refactor-db)' };
-  }
-
-  return { valid: true };
-}
-
-/**
- * Creates a new change directory with metadata file.
- *
- * @param projectRoot - The root directory of the project (where `prompter/` lives)
- * @param name - The change name (must be valid kebab-case)
- * @param options - Optional settings for the change
- * @throws Error if the change name is invalid
- * @throws Error if the schema name is invalid
- * @throws Error if the change directory already exists
- *
- * @example
- * // Creates prompter/changes/add-auth/ with default schema
- * await createChange('/path/to/project', 'add-auth')
- *
- * @example
- * // Creates prompter/changes/add-auth/ with TDD schema
- * await createChange('/path/to/project', 'add-auth', { schema: 'tdd' })
- */
-export async function createChange(
-  projectRoot: string,
-  name: string,
-  options: CreateChangeOptions = {}
-): Promise<void> {
-  // Validate the name first
-  const validation = validateChangeName(name);
-  if (!validation.valid) {
-    throw new Error(validation.error);
-  }
-
-  // Determine schema (validate if provided)
-  const schemaName = options.schema ?? DEFAULT_SCHEMA;
-  validateSchemaName(schemaName);
-
-  // Build the change directory path
-  const changeDir = path.join(projectRoot, 'prompter', 'changes', name);
-
-  // Check if change already exists
-  if (await FileSystemUtils.directoryExists(changeDir)) {
-    throw new Error(`Change '${name}' already exists at ${changeDir}`);
-  }
-
-  // Create the directory (including parent directories if needed)
-  await FileSystemUtils.createDirectory(changeDir);
-
-  // Write metadata file with schema and creation date
-  const today = new Date().toISOString().split('T')[0];
-  writeChangeMetadata(changeDir, {
-    schema: schemaName,
-    created: today,
-  });
-}