@proletariat/cli 0.3.57 → 0.3.59

package/dist/lib/pmo/spec-parser.js

@@ -1,206 +0,0 @@
-/**
- * Spec Parser
- *
- * Parses markdown spec files into structured data.
- * Uses the new simplified spec format with frontmatter.
- */
-import * as fs from 'node:fs';
-import matter from 'gray-matter';
-// =============================================================================
-// Main Parser
-// =============================================================================
-/**
- * Parse a spec markdown file into structured data
- */
-export function parseSpecFile(filePath) {
-    const content = fs.readFileSync(filePath, 'utf-8');
-    return parseSpecContent(content, filePath);
-}
-/**
- * Parse spec content string into structured data
- */
-export function parseSpecContent(content, filePath = '') {
-    const { data: rawFrontmatter, content: body } = matter(content);
-    const frontmatter = {
-        id: rawFrontmatter.id,
-        status: rawFrontmatter.status,
-        type: rawFrontmatter.type,
-        tags: rawFrontmatter.tags,
-        depends_on: rawFrontmatter.depends_on,
-    };
-    return {
-        frontmatter,
-        title: parseTitle(body),
-        problem: parseSection(body, 'Problem'),
-        solution: parseSection(body, 'Solution'),
-        decisions: parseSection(body, 'Decisions'),
-        notNow: parseSection(body, 'Not Now'),
-        uiUx: parseSection(body, 'UI/UX'),
-        acceptanceCriteria: parseSection(body, 'Acceptance Criteria'),
-        openQuestions: parseSection(body, 'Open Questions'),
-        requirementsFunctional: parseNestedSection(body, 'Requirements', 'Functional'),
-        requirementsTechnical: parseNestedSection(body, 'Requirements', 'Technical'),
-        context: parseSection(body, 'Context'),
-        rawContent: content,
-        filePath,
-    };
-}
-// =============================================================================
-// Section Parsers
-// =============================================================================
-/**
- * Parse title from the first H1 heading
- */
-function parseTitle(body) {
-    const match = body.match(/^#\s+(.+)$/m);
-    return match ? match[1].trim() : 'Untitled';
-}
-/**
- * Parse a section by heading name
- */
-function parseSection(body, sectionName) {
-    // Match ## Section Name followed by content until next ## or end
-    const regex = new RegExp(`## ${sectionName}\\s*\\n+([\\s\\S]*?)(?=\\n## [^#]|$)`, 'i');
-    const match = body.match(regex);
-    if (!match)
-        return undefined;
-    const content = match[1].trim();
-    return content || undefined;
-}
-/**
- * Parse a nested section (e.g., ## Requirements -> ### Functional)
- */
-function parseNestedSection(body, parentSection, childSection) {
-    // First find the parent section
-    const parentRegex = new RegExp(`## ${parentSection}\\s*\\n+([\\s\\S]*?)(?=\\n## [^#]|$)`, 'i');
-    const parentMatch = body.match(parentRegex);
-    if (!parentMatch)
-        return undefined;
-    const parentContent = parentMatch[1];
-    // Then find the child section within it
-    const childRegex = new RegExp(`### ${childSection}\\s*\\n+([\\s\\S]*?)(?=\\n### |$)`, 'i');
-    const childMatch = parentContent.match(childRegex);
-    if (!childMatch)
-        return undefined;
-    const content = childMatch[1].trim();
-    return content || undefined;
-}
-// =============================================================================
-// Validation
-// =============================================================================
-/**
- * Validate a parsed spec for completeness
- */
-export function validateSpec(spec) {
-    const errors = [];
-    if (!spec.frontmatter.id) {
-        errors.push('Missing id in frontmatter');
-    }
-    if (!spec.title || spec.title === 'Untitled') {
-        errors.push('Missing title (H1 heading)');
-    }
-    if (!spec.problem) {
-        errors.push('Missing Problem section');
-    }
-    if (!spec.solution) {
-        errors.push('Missing Solution section');
-    }
-    return errors;
-}
-// =============================================================================
-// Export Format
-// =============================================================================
-/**
- * Convert a parsed spec back to markdown format
- */
-export function specToMarkdown(spec, options) {
-    const lines = [];
-    // Frontmatter
-    if (options?.includeFrontmatter !== false) {
-        lines.push('---');
-        if (spec.frontmatter.id)
-            lines.push(`id: ${spec.frontmatter.id}`);
-        if (spec.frontmatter.status)
-            lines.push(`status: ${spec.frontmatter.status}`);
-        if (spec.frontmatter.type)
-            lines.push(`type: ${spec.frontmatter.type}`);
-        if (spec.frontmatter.tags && spec.frontmatter.tags.length > 0) {
-            lines.push(`tags: [${spec.frontmatter.tags.join(', ')}]`);
-        }
-        if (spec.frontmatter.depends_on && spec.frontmatter.depends_on.length > 0) {
-            lines.push(`depends_on: [${spec.frontmatter.depends_on.join(', ')}]`);
-        }
-        lines.push('---');
-        lines.push('');
-    }
-    // Title
-    lines.push(`# ${spec.title}`);
-    lines.push('');
-    // Sections
-    if (spec.problem) {
-        lines.push('## Problem');
-        lines.push('');
-        lines.push(spec.problem);
-        lines.push('');
-    }
-    if (spec.solution) {
-        lines.push('## Solution');
-        lines.push('');
-        lines.push(spec.solution);
-        lines.push('');
-    }
-    if (spec.decisions) {
-        lines.push('## Decisions');
-        lines.push('');
-        lines.push(spec.decisions);
-        lines.push('');
-    }
-    if (spec.notNow) {
-        lines.push('## Not Now');
-        lines.push('');
-        lines.push(spec.notNow);
-        lines.push('');
-    }
-    if (spec.uiUx) {
-        lines.push('## UI/UX');
-        lines.push('');
-        lines.push(spec.uiUx);
-        lines.push('');
-    }
-    if (spec.acceptanceCriteria) {
-        lines.push('## Acceptance Criteria');
-        lines.push('');
-        lines.push(spec.acceptanceCriteria);
-        lines.push('');
-    }
-    if (spec.openQuestions) {
-        lines.push('## Open Questions');
-        lines.push('');
-        lines.push(spec.openQuestions);
-        lines.push('');
-    }
-    if (spec.requirementsFunctional || spec.requirementsTechnical) {
-        lines.push('## Requirements');
-        lines.push('');
-        if (spec.requirementsFunctional) {
-            lines.push('### Functional');
-            lines.push('');
-            lines.push(spec.requirementsFunctional);
-            lines.push('');
-        }
-        if (spec.requirementsTechnical) {
-            lines.push('### Technical');
-            lines.push('');
-            lines.push(spec.requirementsTechnical);
-            lines.push('');
-        }
-    }
-    if (spec.context) {
-        lines.push('## Context');
-        lines.push('');
-        lines.push(spec.context);
-        lines.push('');
-    }
-    return lines.join('\n');
-}
-//# sourceMappingURL=spec-parser.js.map

package/dist/lib/pmo/spec-parser.js.map

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

package/dist/lib/pmo/spec-types.d.ts

@@ -1,43 +0,0 @@
-/**
- * Spec Format Type Definitions
- *
- * Types for parsing spec documents with frontmatter.
- * DB types are in types.ts (Spec, SpecDependency)
- */
-export { SpecType, SpecStatus, Spec, SpecDependency, } from './types.js';
-/**
- * Spec frontmatter - parsed from YAML at top of markdown file
- */
-export interface SpecFrontmatter {
-    id?: string;
-    status?: 'draft' | 'active' | 'implemented';
-    type?: 'product' | 'platform' | 'infra' | 'integration';
-    tags?: string[];
-    depends_on?: string[];
-}
-/**
- * A spec parsed from a markdown file
- */
-export interface ParsedSpec {
-    frontmatter: SpecFrontmatter;
-    title: string;
-    problem?: string;
-    solution?: string;
-    decisions?: string;
-    notNow?: string;
-    uiUx?: string;
-    acceptanceCriteria?: string;
-    openQuestions?: string;
-    requirementsFunctional?: string;
-    requirementsTechnical?: string;
-    context?: string;
-    rawContent: string;
-    filePath: string;
-}
-/**
- * Format for exporting spec to markdown
- */
-export interface SpecExportOptions {
-    includeFrontmatter?: boolean;
-    includeEmptySections?: boolean;
-}

package/dist/lib/pmo/spec-types.js

@@ -1,8 +0,0 @@
-/**
- * Spec Format Type Definitions
- *
- * Types for parsing spec documents with frontmatter.
- * DB types are in types.ts (Spec, SpecDependency)
- */
-export {};
-//# sourceMappingURL=spec-types.js.map

package/dist/lib/pmo/spec-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-types.js","sourceRoot":"","sources":["../../../src/lib/pmo/spec-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}