fraim-hub 2.0.277 → 2.0.278

package/dist/src/api/pricing/get-config.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPricingConfig = getPricingConfig;
+const pricing_1 = require("../../config/pricing");
+const feature_flags_1 = require("../../config/feature-flags");
+/**
+ * GET /api/pricing/config
+ * Returns pricing configuration for frontend
+ */
+async function getPricingConfig(req, res) {
+    try {
+        res.json({
+            pricing: pricing_1.PRICING,
+            fixedFees: pricing_1.FIXED_FEES,
+            managedPricing: pricing_1.MANAGED_PRICING,
+            founderDiscountRate: pricing_1.FOUNDER_DISCOUNT_RATE,
+            consumerEmailDomains: pricing_1.CONSUMER_EMAIL_DOMAINS,
+            featureFlags: (0, feature_flags_1.getPublicFeatureFlags)(),
+        });
+    }
+    catch (error) {
+        console.error('Error getting pricing config:', error);
+        res.status(500).json({ error: 'Failed to get pricing configuration' });
+    }
+}

package/dist/src/core/job-visualization.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildJobVisualization = buildJobVisualization;
+const local_registry_resolver_1 = require("./utils/local-registry-resolver");
+const job_parser_1 = require("./utils/job-parser");
+function friendlyLabel(id) {
+    const PREFIXES = ['implement-', 'address-', 'spec-', 'design-', 'context-'];
+    let body = id;
+    for (const p of PREFIXES) {
+        if (body.startsWith(p) && body.length > p.length) {
+            body = body.slice(p.length);
+            break;
+        }
+    }
+    const spaced = body.replace(/-/g, ' ').trim();
+    if (!spaced)
+        return id;
+    return spaced[0].toUpperCase() + spaced.slice(1).toLowerCase();
+}
+function readSection(content, heading) {
+    const re = new RegExp(`(?:^|\\r?\\n)#{1,6} ${heading}[ \\t]*\\r?\\n([\\s\\S]*?)(?=\\r?\\n#{1,6} |\\r?\\n---|$)`);
+    const m = content.match(re);
+    if (!m)
+        return null;
+    const text = m[1]
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter((l) => l && !l.startsWith('{{'))
+        .map((l) => l.replace(/^[-*]\s*/, ''))
+        .join(' ')
+        .trim();
+    return text || null;
+}
+function parseSkillIdFromInclude(line) {
+    const m = line.match(/\{\{include:skills\/([^}]+?)(?:\.md)?\}\}/);
+    if (!m)
+        return null;
+    return m[1].replace(/\.md$/, '');
+}
+function skillLabelFromId(skillId) {
+    const base = skillId.includes('/') ? skillId.split('/').pop() : skillId;
+    return base.replace(/-/g, ' ');
+}
+function isStub(content) {
+    return (content.includes('<!-- FRAIM_DISCOVERY_STUB -->') ||
+        content.includes('STUB:') ||
+        content.includes('<!-- STUB -->'));
+}
+function buildResolver(projectPath) {
+    // remoteContentResolver is required by LocalRegistryResolver but never reached
+    // for local repos: findRegistryPath now searches registry/ as a fallback layer,
+    // and readWorkspaceRegistryFile handles the direct path lookup.
+    return new local_registry_resolver_1.LocalRegistryResolver({
+        workspaceRoot: projectPath,
+        shouldFilter: isStub,
+        remoteContentResolver: async (registryPath) => {
+            throw new Error(`registry file not found locally: ${registryPath}`);
+        },
+    });
+}
+function toTitleCase(id) {
+    return id
+        .split('-')
+        .map((w) => w[0].toUpperCase() + w.slice(1).toLowerCase())
+        .join(' ');
+}
+function parseJobTitle(content, jobId) {
+    const m = content.match(/^#\s+(?:FRAIM Job:\s*)?(.+)/m);
+    if (m) {
+        const raw = m[1].trim();
+        if (/^[a-z0-9-]+$/.test(raw))
+            return toTitleCase(raw);
+        return raw;
+    }
+    return toTitleCase(jobId);
+}
+function parseJobLevelIntent(content) {
+    const m = content.match(/(?:^|\r?\n)## Intent[ \t]*\r?\n([\s\S]*?)(?=\r?\n#{1,6} |\r?\n---|$)/);
+    if (!m)
+        return null;
+    const lines = m[1].split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith('{{'));
+    const text = lines.map((l) => l.replace(/^[-*]\s*/, '')).join(' ').trim();
+    return text || null;
+}
+const EMPTY_RESPONSE = (jobId) => ({
+    jobId,
+    title: toTitleCase(jobId),
+    intent: null,
+    personalized: false,
+    phases: [],
+});
+async function buildJobVisualization(jobId, projectPath) {
+    const resolver = buildResolver(projectPath);
+    const registryPath = await resolver.findRegistryPath('jobs', jobId);
+    let jobFile;
+    try {
+        jobFile = await resolver.resolveFile(registryPath, {
+            includeMetadata: false,
+            stripMcpHeader: true,
+        });
+    }
+    catch {
+        return EMPTY_RESPONSE(jobId);
+    }
+    const content = jobFile.content;
+    if (!content?.trim())
+        return EMPTY_RESPONSE(jobId);
+    const title = parseJobTitle(content, jobId);
+    const intent = parseJobLevelIntent(content);
+    // Phase splitting reuses JobParser — the same parser the MCP proxy uses.
+    const jobDef = job_parser_1.JobParser.parseContent(content, jobId);
+    if (!jobDef || jobDef.phases.size === 0) {
+        return { jobId, title, intent, personalized: jobFile.personalized, scope: jobFile.scope, phases: [] };
+    }
+    const phases = await Promise.all([...jobDef.phases.entries()].map(async ([phaseId, phaseContent]) => {
+        const phaseIntent = readSection(phaseContent, 'Intent');
+        const phaseOutcome = readSection(phaseContent, 'Outcome');
+        const skillIds = [];
+        for (const line of phaseContent.split(/\r?\n/)) {
+            const id = parseSkillIdFromInclude(line);
+            if (id)
+                skillIds.push(id);
+        }
+        const skills = await Promise.all(skillIds.map(async (skillId) => {
+            try {
+                const skillFile = await resolver.resolveFile(`skills/${skillId}.md`, {
+                    includeMetadata: false,
+                    stripMcpHeader: true,
+                });
+                return {
+                    id: skillId,
+                    label: skillLabelFromId(skillId),
+                    input: readSection(skillFile.content, 'Skill Input'),
+                    output: readSection(skillFile.content, 'Skill Output'),
+                    personalized: skillFile.personalized,
+                    scope: skillFile.scope,
+                };
+            }
+            catch {
+                return { id: skillId, label: skillLabelFromId(skillId), input: null, output: null, personalized: false };
+            }
+        }));
+        return {
+            id: phaseId,
+            label: friendlyLabel(phaseId),
+            intent: phaseIntent,
+            outcome: phaseOutcome,
+            personalized: jobFile.personalized,
+            scope: jobFile.scope,
+            skills,
+        };
+    }));
+    return {
+        jobId,
+        title,
+        intent,
+        personalized: jobFile.personalized,
+        scope: jobFile.scope,
+        phases,
+    };
+}

package/dist/src/core/utils/inheritance-parser.js

@@ -0,0 +1,293 @@
+"use strict";
+/**
+ * InheritanceParser
+ *
+ * Parses and resolves {{ import: path }} directives in registry files,
+ * enabling local overrides to inherit from global registry files.
+ *
+ * Security features:
+ * - Path traversal protection (rejects .. and absolute paths)
+ * - Circular import detection
+ * - Max depth limit (5 levels)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InheritanceParser = exports.InheritanceError = void 0;
+class InheritanceError extends Error {
+    constructor(message, path) {
+        super(message);
+        this.path = path;
+        this.name = 'InheritanceError';
+    }
+}
+exports.InheritanceError = InheritanceError;
+/**
+ * Regular expression to match {{ import: path }} directives
+ */
+const IMPORT_REGEX = /\{\{\s*import:\s*([^\}]+)\s*\}\}/g;
+class InheritanceParser {
+    constructor(maxDepth = 5) {
+        this.maxDepth = maxDepth;
+    }
+    /**
+     * Extract import directives from content without resolving them
+     */
+    extractImports(content) {
+        const imports = [];
+        let match;
+        // Reset regex state
+        IMPORT_REGEX.lastIndex = 0;
+        while ((match = IMPORT_REGEX.exec(content)) !== null) {
+            imports.push(match[1].trim());
+        }
+        return imports;
+    }
+    /**
+     * Sanitize and validate import path
+     *
+     * @throws {InheritanceError} If path is invalid
+     */
+    sanitizePath(path) {
+        const trimmed = path.trim();
+        // Reject empty paths
+        if (!trimmed) {
+            throw new InheritanceError('Import path cannot be empty');
+        }
+        // Reject absolute paths (Unix and Windows)
+        if (trimmed.startsWith('/') || trimmed.match(/^[A-Za-z]:\\/)) {
+            throw new InheritanceError(`Absolute paths not allowed: ${trimmed}`, trimmed);
+        }
+        // Reject path traversal attempts
+        if (trimmed.includes('..')) {
+            throw new InheritanceError(`Path traversal not allowed: ${trimmed}`, trimmed);
+        }
+        return trimmed;
+    }
+    /**
+     * Detect circular imports
+     *
+     * Special case: If the import path is the same as the current path,
+     * it's not a circular import - it's importing the parent/remote version.
+     * This allows local overrides to inherit from their remote counterparts.
+     *
+     * @throws {InheritanceError} If circular import detected
+     */
+    detectCircularImport(path, visited, isParentImport = false) {
+        // If this is a parent import (same path as current), allow it
+        if (isParentImport) {
+            return;
+        }
+        if (visited.has(path)) {
+            throw new InheritanceError(`Circular import detected: ${path}`, path);
+        }
+    }
+    /**
+     * Resolve all import and extends directives in content recursively
+     *
+     * @param content - Content with {{ import }} or extends frontmatter
+     * @param currentPath - Path of current file (for circular detection)
+     * @param options - Resolution options
+     * @returns Resolved content with all inheritance applied
+     *
+     * @throws {InheritanceError} If circular inheritance, path traversal, or max depth exceeded
+     */
+    async resolve(content, currentPath, options) {
+        const depth = options.currentDepth || 0;
+        const visited = options.visited || new Set();
+        const maxDepth = options.maxDepth || this.maxDepth;
+        // Check depth limit
+        if (depth > maxDepth) {
+            throw new InheritanceError(`Max inheritance depth exceeded (${maxDepth})`, currentPath);
+        }
+        // Check circular inheritance (but allow importing/extending the same path as parent)
+        this.detectCircularImport(currentPath, visited, false);
+        visited.add(currentPath);
+        let resolvedContent = content;
+        // 1. Handle JSON frontmatter 'extends'
+        const metadataMatch = resolvedContent.match(/^---\r?\n([\s\S]+?)\r?\n---/);
+        if (metadataMatch) {
+            try {
+                const metadata = JSON.parse(metadataMatch[1]);
+                const extendsPath = metadata.extends;
+                if (extendsPath && typeof extendsPath === 'string') {
+                    // Sanitize path
+                    const sanitizedExtends = this.sanitizePath(extendsPath);
+                    const isParentExtends = sanitizedExtends === currentPath;
+                    // Fetch parent content
+                    let parentContent;
+                    try {
+                        parentContent = await options.fetchParent(sanitizedExtends);
+                    }
+                    catch (error) {
+                        throw new InheritanceError(`Failed to fetch extended parent content: ${sanitizedExtends}. ${error.message}`, sanitizedExtends);
+                    }
+                    // Recursively resolve parent
+                    const parentVisited = isParentExtends ? new Set() : new Set(visited);
+                    const resolvedParent = await this.resolve(parentContent, sanitizedExtends, {
+                        ...options,
+                        currentDepth: depth + 1,
+                        visited: parentVisited
+                    });
+                    // Merge current content with resolved parent
+                    resolvedContent = this.mergeContent(resolvedContent, resolvedParent);
+                }
+            }
+            catch (error) {
+                if (error instanceof SyntaxError) {
+                    // Not JSON or invalid JSON, ignore extends logic but log it
+                    console.warn(`[InheritanceParser] Failed to parse frontmatter for ${currentPath}: ${error.message}`);
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        // 2. Handle {{ import: path }}
+        const imports = this.extractImports(resolvedContent);
+        for (const importPath of imports) {
+            // Sanitize path
+            const sanitized = this.sanitizePath(importPath);
+            // Check if this is a parent import (same path as current)
+            const isParentImport = sanitized === currentPath;
+            // Fetch parent content
+            let parentContent;
+            try {
+                parentContent = await options.fetchParent(sanitized);
+            }
+            catch (error) {
+                throw new InheritanceError(`Failed to fetch parent content: ${sanitized}. ${error.message}`, sanitized);
+            }
+            // Recursively resolve parent imports
+            const parentVisited = isParentImport ? new Set() : new Set(visited);
+            const resolvedParent = await this.resolve(parentContent, sanitized, {
+                ...options,
+                currentDepth: depth + 1,
+                visited: parentVisited
+            });
+            // Replace import directive with resolved parent content
+            const importDirective = `{{ import: ${importPath} }}`;
+            resolvedContent = resolvedContent.replace(importDirective, resolvedParent);
+        }
+        return resolvedContent;
+    }
+    /**
+     * Merge two registry files (child override + parent base)
+     *
+     * Merging rules:
+     * 1. Metadata: JSON merge (child overrides parent)
+     * 2. Overview: Parent overview + child overview (if multi-para)
+     * 3. Phases: Phase override (child phase with same ID replaces parent phase)
+     */
+    mergeContent(child, parent) {
+        const childMatch = child.match(/^---\r?\n([\s\S]+?)\r?\n---/);
+        const parentMatch = parent.match(/^---\r?\n([\s\S]+?)\r?\n---/);
+        if (!childMatch || !parentMatch)
+            return child;
+        // 1. Merge Metadata
+        const childMeta = JSON.parse(childMatch[1]);
+        const parentMeta = JSON.parse(parentMatch[1]);
+        const mergedMeta = { ...parentMeta, ...childMeta };
+        delete mergedMeta.extends; // Remove extends from final merged content
+        // Deep-merge phase routing so child only overrides the entries it specifies;
+        // parent routing for untouched phases flows through unchanged.
+        if (parentMeta.phases && childMeta.phases) {
+            mergedMeta.phases = { ...parentMeta.phases, ...childMeta.phases };
+        }
+        // 2. Extract Body (everything after frontmatter)
+        const childBody = this.stripRedundantParentImports(child.substring(childMatch[0].length).trim(), typeof childMeta.extends === 'string' ? childMeta.extends : undefined);
+        const parentBody = parent.substring(parentMatch[0].length).trim();
+        // 3. Parse Phases and Overview
+        const parsePhases = (body) => {
+            const phases = new Map();
+            const sections = body.split(/^##\s+Phase:\s+/m);
+            const overview = sections[0]?.trim() || '';
+            for (let i = 1; i < sections.length; i++) {
+                const section = sections[i];
+                if (!section.trim())
+                    continue;
+                // Extract ID from first line: e.g. "implement-scoping (Primary)" -> "implement-scoping"
+                const firstLine = section.split(/\r?\n/)[0].trim();
+                const id = firstLine.split(/[ (]/)[0].trim().toLowerCase();
+                phases.set(id, `## Phase: ${section.trim()}`);
+            }
+            return { overview, phases };
+        };
+        const childParts = parsePhases(childBody);
+        const parentParts = parsePhases(parentBody);
+        // 4. Merge Overview: retain the parent framing, then append local overview additions.
+        const mergedOverview = childParts.overview
+            ? `${parentParts.overview}\n\n${childParts.overview}`.trim()
+            : parentParts.overview;
+        // 5. Merge Phases
+        const mergedPhases = new Map(parentParts.phases);
+        for (const [id, content] of childParts.phases.entries()) {
+            mergedPhases.set(id, content);
+        }
+        // 6. Reassemble
+        let finalContent = `---\n${JSON.stringify(mergedMeta, null, 2)}\n---\n\n`;
+        if (mergedOverview) {
+            finalContent += `${mergedOverview}\n\n`;
+        }
+        const addedPhases = new Set();
+        // First, add parent phases in order, using child overrides when present.
+        for (const id of parentParts.phases.keys()) {
+            if (mergedPhases.has(id)) {
+                finalContent += `${mergedPhases.get(id)}\n\n`;
+                addedPhases.add(id);
+            }
+        }
+        // Then append child-only phases in the order the child declared them.
+        for (const [id, content] of childParts.phases.entries()) {
+            if (!addedPhases.has(id)) {
+                finalContent += `${content}\n\n`;
+                addedPhases.add(id);
+            }
+        }
+        return finalContent.trim();
+    }
+    /**
+     * Parse content and return detailed information about imports
+     */
+    parse(content) {
+        const imports = this.extractImports(content);
+        const hasExtends = /^---\r?\n[\s\S]*?"extends":\s*"[^"]+"[\s\S]*?\r?\n---/m.test(content);
+        return {
+            content,
+            imports,
+            hasImports: imports.length > 0 || hasExtends
+        };
+    }
+    normalizeImportRef(path) {
+        let normalized = path.trim().replace(/\\/g, '/').replace(/^\/+/, '');
+        if (normalized.endsWith('.md')) {
+            normalized = normalized.slice(0, -3);
+        }
+        return normalized;
+    }
+    stripTypePrefix(path) {
+        return path.replace(/^(jobs|workflows|skills|rules|templates)\//, '');
+    }
+    isEquivalentImportRef(left, right) {
+        const normalizedLeft = this.normalizeImportRef(left);
+        const normalizedRight = this.normalizeImportRef(right);
+        const strippedLeft = this.stripTypePrefix(normalizedLeft);
+        const strippedRight = this.stripTypePrefix(normalizedRight);
+        return normalizedLeft === normalizedRight ||
+            strippedLeft === strippedRight ||
+            normalizedLeft.endsWith(`/${strippedRight}`) ||
+            normalizedRight.endsWith(`/${strippedLeft}`) ||
+            strippedLeft.endsWith(`/${strippedRight}`) ||
+            strippedRight.endsWith(`/${strippedLeft}`);
+    }
+    stripRedundantParentImports(body, extendsPath) {
+        if (!extendsPath) {
+            return body;
+        }
+        return body
+            .replace(/\{\{\s*import:\s*([^\}]+)\s*\}\}\s*\r?\n?/g, (match, importPath) => {
+            return this.isEquivalentImportRef(importPath, extendsPath) ? '' : match;
+        })
+            .replace(/\n{3,}/g, '\n\n')
+            .trim();
+    }
+}
+exports.InheritanceParser = InheritanceParser;

package/dist/src/core/utils/job-parser.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobParser = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+class JobParser {
+    static extractMetadataBlock(content) {
+        // Allow leading comments and whitespace before frontmatter
+        const frontmatterMatch = content.match(/^[\s\S]*?---\r?\n([\s\S]+?)\r?\n---/);
+        if (frontmatterMatch) {
+            try {
+                const startIndex = frontmatterMatch.index || 0;
+                return {
+                    state: 'valid',
+                    metadata: JSON.parse(frontmatterMatch[1]),
+                    bodyStartIndex: startIndex + frontmatterMatch[0].length
+                };
+            }
+            catch {
+                return { state: 'invalid' };
+            }
+        }
+        const trimmedStart = content.search(/\S/);
+        if (trimmedStart === -1 || content[trimmedStart] !== '{') {
+            return { state: 'none' };
+        }
+        let depth = 0;
+        let inString = false;
+        let escaping = false;
+        for (let i = trimmedStart; i < content.length; i++) {
+            const ch = content[i];
+            if (inString) {
+                if (escaping) {
+                    escaping = false;
+                }
+                else if (ch === '\\') {
+                    escaping = true;
+                }
+                else if (ch === '"') {
+                    inString = false;
+                }
+                continue;
+            }
+            if (ch === '"') {
+                inString = true;
+                continue;
+            }
+            if (ch === '{') {
+                depth++;
+                continue;
+            }
+            if (ch === '}') {
+                depth--;
+                if (depth === 0) {
+                    const bodyStartIndex = i + 1;
+                    const remainder = content.slice(bodyStartIndex).trimStart();
+                    // `{...}\n---` is usually malformed frontmatter, not bare JSON metadata.
+                    if (remainder.startsWith('---')) {
+                        return { state: 'none' };
+                    }
+                    try {
+                        return {
+                            state: 'valid',
+                            metadata: JSON.parse(content.slice(trimmedStart, bodyStartIndex)),
+                            bodyStartIndex
+                        };
+                    }
+                    catch {
+                        return { state: 'invalid' };
+                    }
+                }
+            }
+        }
+        return { state: 'none' };
+    }
+    /**
+     * Parse a job markdown file into a structured definition
+     * Supports three formats:
+     * 1. Phase-based jobs with JSON frontmatter
+     * 2. Phase-based jobs with bare leading JSON metadata
+     * 3. Simple jobs without metadata
+     */
+    static parse(filePath) {
+        if (!(0, fs_1.existsSync)(filePath))
+            return null;
+        let content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+        if (content.charCodeAt(0) === 0xfeff) {
+            content = content.slice(1);
+        }
+        const metadataBlock = this.extractMetadataBlock(content);
+        if (metadataBlock.state === 'invalid') {
+            return null;
+        }
+        if (metadataBlock.state === 'valid') {
+            return this.parsePhaseBasedJob(filePath, content, metadataBlock.metadata, metadataBlock.bodyStartIndex);
+        }
+        return this.parseSimpleJob(filePath, content);
+    }
+    static parsePhaseBasedJob(filePath, content, metadata, bodyStartIndex) {
+        const contentAfterMetadata = content.substring(bodyStartIndex).trim();
+        const firstPhaseIndex = contentAfterMetadata.search(/^##\s+Phase:/m);
+        let overview = '';
+        let restOfContent = '';
+        if (firstPhaseIndex !== -1) {
+            overview = contentAfterMetadata.substring(0, firstPhaseIndex).trim();
+            restOfContent = contentAfterMetadata.substring(firstPhaseIndex);
+        }
+        else {
+            overview = contentAfterMetadata;
+        }
+        const phases = new Map();
+        const phaseSections = restOfContent.split(/^##\s+Phase:\s*/im);
+        if (!metadata.phases) {
+            metadata.phases = {};
+        }
+        for (let i = 1; i < phaseSections.length; i++) {
+            const section = phaseSections[i];
+            const sectionLines = section.split('\n');
+            const firstLine = sectionLines[0].trim();
+            const id = firstLine.split(/[ (]/)[0].trim().toLowerCase();
+            phases.set(id, `## Phase: ${section.trim()}`);
+        }
+        return {
+            metadata,
+            overview,
+            phases,
+            isSimple: false,
+            path: filePath
+        };
+    }
+    static parseSimpleJob(filePath, content) {
+        const jobName = (0, path_1.basename)(filePath, '.md');
+        const metadata = { name: jobName };
+        // If the content contains ## Phase: sections, parse them the same way as
+        // phase-based jobs so callers always get a populated phases Map.
+        if (/^##\s+Phase:/im.test(content)) {
+            return this.parsePhaseBasedJob(filePath, content, metadata, 0);
+        }
+        return {
+            metadata,
+            overview: content.trim(),
+            phases: new Map(),
+            isSimple: true,
+            path: filePath
+        };
+    }
+    static parseContent(content, name, path) {
+        if (content.charCodeAt(0) === 0xfeff) {
+            content = content.slice(1);
+        }
+        const metadataBlock = this.extractMetadataBlock(content);
+        if (metadataBlock.state === 'invalid') {
+            return null;
+        }
+        if (metadataBlock.state === 'valid') {
+            return this.parsePhaseBasedJob(path || `content:${name}`, content, metadataBlock.metadata, metadataBlock.bodyStartIndex);
+        }
+        return this.parseSimpleJob(path || `content:${name}`, content);
+    }
+    static getOverviewFromContent(content, name) {
+        const job = this.parseContent(content, name);
+        return job ? job.overview : null;
+    }
+    static getOverview(filePath) {
+        const job = this.parse(filePath);
+        return job ? job.overview : null;
+    }
+    static extractDescription(filePath) {
+        const job = this.parse(filePath);
+        if (!job)
+            return '';
+        const intentMatch = job.overview.match(/## Intent\s+([\s\S]+?)(?:\r?\n##|$)/);
+        if (intentMatch)
+            return intentMatch[1].trim().split(/\r?\n/)[0];
+        const firstPara = job.overview.split(/\r?\n/).find(l => l.trim() !== '' && !l.startsWith('#'));
+        return firstPara ? firstPara.trim() : '';
+    }
+}
+exports.JobParser = JobParser;