@hstm-labs/forge-spec-parser 0.1.2

package/dist/parsers/structured-mapper.js

@@ -0,0 +1,214 @@
+/**
+ * Shared mapping logic for structured (YAML / JSON) specification files.
+ *
+ * Both the YAML and JSON parsers produce a raw `unknown` object after parsing
+ * their respective formats. This module validates the structure and maps it
+ * into the canonical {@link ParsedSpecification} model.
+ */
+import { ForgeError, ErrorCodes } from '@hstm-labs/forge-common';
+// ---------------------------------------------------------------------------
+// Type Guards / Helpers
+// ---------------------------------------------------------------------------
+/** Narrow `unknown` to a non-null record. */
+function isRecord(val) {
+    return typeof val === 'object' && val !== null && !Array.isArray(val);
+}
+/** Safely extract a string value, returning `undefined` if not a string. */
+function asString(val) {
+    return typeof val === 'string' ? val : undefined;
+}
+/** Safely extract an array, returning `[]` if not an array. */
+function asArray(val) {
+    return Array.isArray(val) ? val : [];
+}
+/** Safely extract a string array, filtering non-string elements. */
+function asStringArray(val) {
+    return asArray(val).filter((v) => typeof v === 'string');
+}
+// ---------------------------------------------------------------------------
+// Validation Constants
+// ---------------------------------------------------------------------------
+const VALID_PRIORITIES = new Set([
+    'must',
+    'should',
+    'could',
+    'wont',
+]);
+const VALID_RELATIONSHIP_TYPES = new Set([
+    'one-to-one',
+    'one-to-many',
+    'many-to-many',
+]);
+const VALID_API_STYLES = new Set(['rest', 'graphql', 'grpc']);
+// ---------------------------------------------------------------------------
+// Public Mapper
+// ---------------------------------------------------------------------------
+/**
+ * Map a parsed structured object into the canonical specification model.
+ *
+ * Validates the data structure (title required, arrays are arrays, etc.)
+ * and maps to canonical types with safe defaults.
+ *
+ * @param data - Raw parsed data (from YAML or JSON)
+ * @param sourcePath - Original file path
+ * @param format - Specification format (`'yaml'` or `'json'`)
+ * @returns Parsed specification
+ * @throws {@link ForgeError} with code `FORGE-SPEC-001` if `title` is missing or data is not an object
+ */
+export function mapStructuredSpec(data, sourcePath, format) {
+    if (!isRecord(data)) {
+        throw new ForgeError(ErrorCodes.SPEC.PARSE_FAILURE, `Specification file '${sourcePath}' must contain a top-level object. ` +
+            `Ensure the file has a valid ${format.toUpperCase()} object structure.`);
+    }
+    const title = asString(data['title']);
+    if (!title) {
+        throw new ForgeError(ErrorCodes.SPEC.PARSE_FAILURE, `Specification file '${sourcePath}' is missing required field 'title'. ` +
+            `Add a 'title' string field at the top level of the specification.`);
+    }
+    const metadata = mapMetadata(data, title, sourcePath, format);
+    const sections = asArray(data['sections']).map(mapSection);
+    const requirements = asArray(data['requirements']).map(mapRequirement);
+    const entities = asArray(data['entities']).map(mapEntity);
+    const workflows = asArray(data['workflows']).map(mapWorkflow);
+    const result = {
+        metadata,
+        sections,
+        requirements,
+        entities,
+        workflows,
+    };
+    const apiStyleRaw = asString(data['apiStyle']);
+    if (apiStyleRaw && VALID_API_STYLES.has(apiStyleRaw)) {
+        result.apiStyle = apiStyleRaw;
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Individual Mappers
+// ---------------------------------------------------------------------------
+function mapMetadata(data, title, sourcePath, format) {
+    const metadata = {
+        title,
+        sourcePath,
+        format,
+    };
+    const version = asString(data['version']);
+    if (version !== undefined)
+        metadata.version = version;
+    const description = asString(data['description']);
+    if (description !== undefined)
+        metadata.description = description;
+    const authors = asStringArray(data['authors']);
+    if (authors.length > 0)
+        metadata.authors = authors;
+    return metadata;
+}
+function mapSection(raw) {
+    if (!isRecord(raw)) {
+        return { id: '', title: '', level: 1, content: '', subsections: [] };
+    }
+    return {
+        id: asString(raw['id']) ?? '',
+        title: asString(raw['title']) ?? '',
+        level: typeof raw['level'] === 'number' ? raw['level'] : 1,
+        content: asString(raw['content']) ?? '',
+        subsections: asArray(raw['subsections']).map(mapSection),
+    };
+}
+function mapRequirement(raw) {
+    if (!isRecord(raw)) {
+        return {
+            id: '',
+            title: '',
+            description: '',
+            acceptanceCriteria: [],
+        };
+    }
+    const req = {
+        id: asString(raw['id']) ?? '',
+        title: asString(raw['title']) ?? '',
+        description: asString(raw['description']) ?? '',
+        acceptanceCriteria: asStringArray(raw['acceptanceCriteria']),
+    };
+    const priority = asString(raw['priority']);
+    if (priority && VALID_PRIORITIES.has(priority)) {
+        req.priority = priority;
+    }
+    return req;
+}
+function mapEntity(raw) {
+    if (!isRecord(raw)) {
+        return { name: '', fields: [], relationships: [] };
+    }
+    const entity = {
+        name: asString(raw['name']) ?? '',
+        fields: asArray(raw['fields']).map(mapEntityField),
+        relationships: asArray(raw['relationships']).map(mapEntityRelationship),
+    };
+    const description = asString(raw['description']);
+    if (description !== undefined)
+        entity.description = description;
+    return entity;
+}
+function mapEntityField(raw) {
+    if (!isRecord(raw)) {
+        return { name: '', type: 'string', required: false };
+    }
+    const field = {
+        name: asString(raw['name']) ?? '',
+        type: asString(raw['type']) ?? 'string',
+        required: typeof raw['required'] === 'boolean' ? raw['required'] : false,
+    };
+    const description = asString(raw['description']);
+    if (description !== undefined)
+        field.description = description;
+    return field;
+}
+function mapEntityRelationship(raw) {
+    if (!isRecord(raw)) {
+        return { target: '', type: 'one-to-many' };
+    }
+    const rel = {
+        target: asString(raw['target']) ?? '',
+        type: 'one-to-many',
+    };
+    const typeRaw = asString(raw['type']);
+    if (typeRaw && VALID_RELATIONSHIP_TYPES.has(typeRaw)) {
+        rel.type = typeRaw;
+    }
+    const description = asString(raw['description']);
+    if (description !== undefined)
+        rel.description = description;
+    return rel;
+}
+function mapWorkflow(raw) {
+    if (!isRecord(raw)) {
+        return { id: '', name: '', steps: [] };
+    }
+    const workflow = {
+        id: asString(raw['id']) ?? '',
+        name: asString(raw['name']) ?? '',
+        steps: asArray(raw['steps']).map(mapWorkflowStep),
+    };
+    const description = asString(raw['description']);
+    if (description !== undefined)
+        workflow.description = description;
+    const actors = asStringArray(raw['actors']);
+    if (actors.length > 0)
+        workflow.actors = actors;
+    return workflow;
+}
+function mapWorkflowStep(raw) {
+    if (!isRecord(raw)) {
+        return { order: 0, action: '' };
+    }
+    const step = {
+        order: typeof raw['order'] === 'number' ? raw['order'] : 0,
+        action: asString(raw['action']) ?? '',
+    };
+    const expectedResult = asString(raw['expectedResult']);
+    if (expectedResult !== undefined)
+        step.expectedResult = expectedResult;
+    return step;
+}
+//# sourceMappingURL=structured-mapper.js.map

package/dist/parsers/structured-mapper.js.map

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

package/dist/parsers/yaml-parser.d.ts

@@ -0,0 +1,35 @@
+/**
+ * YAML specification parser plugin.
+ *
+ * Parses structured YAML specification files into the canonical
+ * {@link ParsedSpecification} model by delegating to the shared
+ * structured mapper after YAML parsing.
+ */
+import type { SpecParserPlugin } from '../parser-plugin.js';
+import type { ParsedSpecification, SpecFormat } from '../types.js';
+/**
+ * Parser plugin for YAML specification files (`.yaml`, `.yml`).
+ *
+ * Expects a structured YAML document with top-level fields matching
+ * the {@link ParsedSpecification} shape (title, requirements, entities, etc.).
+ *
+ * @example
+ * ```ts
+ * const plugin = new YamlParserPlugin();
+ * const spec = plugin.parse(yamlContent, '/path/to/spec.yaml');
+ * ```
+ */
+export declare class YamlParserPlugin implements SpecParserPlugin {
+    readonly format: SpecFormat;
+    readonly extensions: string[];
+    /**
+     * Parse YAML specification content into the canonical model.
+     *
+     * @param content - Raw YAML content
+     * @param sourcePath - Original file path
+     * @returns Parsed specification
+     * @throws {@link ForgeError} with code `FORGE-SPEC-001` if YAML parsing fails or title is missing
+     */
+    parse(content: string, sourcePath: string): ParsedSpecification;
+}
+//# sourceMappingURL=yaml-parser.d.ts.map

package/dist/parsers/yaml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/yaml-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGnE;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAU;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAqB;IAElD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB;CAgBhE"}

package/dist/parsers/yaml-parser.js

@@ -0,0 +1,47 @@
+/**
+ * YAML specification parser plugin.
+ *
+ * Parses structured YAML specification files into the canonical
+ * {@link ParsedSpecification} model by delegating to the shared
+ * structured mapper after YAML parsing.
+ */
+import { parse as parseYaml } from 'yaml';
+import { ForgeError, ErrorCodes } from '@hstm-labs/forge-common';
+import { mapStructuredSpec } from './structured-mapper.js';
+/**
+ * Parser plugin for YAML specification files (`.yaml`, `.yml`).
+ *
+ * Expects a structured YAML document with top-level fields matching
+ * the {@link ParsedSpecification} shape (title, requirements, entities, etc.).
+ *
+ * @example
+ * ```ts
+ * const plugin = new YamlParserPlugin();
+ * const spec = plugin.parse(yamlContent, '/path/to/spec.yaml');
+ * ```
+ */
+export class YamlParserPlugin {
+    format = 'yaml';
+    extensions = ['.yaml', '.yml'];
+    /**
+     * Parse YAML specification content into the canonical model.
+     *
+     * @param content - Raw YAML content
+     * @param sourcePath - Original file path
+     * @returns Parsed specification
+     * @throws {@link ForgeError} with code `FORGE-SPEC-001` if YAML parsing fails or title is missing
+     */
+    parse(content, sourcePath) {
+        let data;
+        try {
+            data = parseYaml(content);
+        }
+        catch (error) {
+            throw new ForgeError(ErrorCodes.SPEC.PARSE_FAILURE, `Invalid YAML in specification file '${sourcePath}': ` +
+                `${error instanceof Error ? error.message : String(error)}. ` +
+                `Verify the file contains valid YAML.`, error instanceof Error ? { cause: error } : {});
+        }
+        return mapStructuredSpec(data, sourcePath, 'yaml');
+    }
+}
+//# sourceMappingURL=yaml-parser.js.map

package/dist/parsers/yaml-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-parser.js","sourceRoot":"","sources":["../../src/parsers/yaml-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,gBAAgB;IAClB,MAAM,GAAe,MAAM,CAAC;IAC5B,UAAU,GAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAElD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAe,EAAE,UAAkB;QACvC,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAClB,UAAU,CAAC,IAAI,CAAC,aAAa,EAC7B,uCAAuC,UAAU,KAAK;gBACpD,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI;gBAC7D,sCAAsC,EACxC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAC/C,CAAC;QACJ,CAAC;QAED,OAAO,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Parser registry — manages format-specific parser plugins.
+ *
+ * Plugins are registered at startup and looked up by format or file extension
+ * when parsing specification files.
+ */
+import type { SpecFormat } from './types.js';
+import type { SpecParserPlugin } from './parser-plugin.js';
+/**
+ * Registry of {@link SpecParserPlugin} instances keyed by format and extension.
+ *
+ * @example
+ * ```ts
+ * const registry = new ParserRegistry();
+ * registry.register(myMarkdownPlugin);
+ * const plugin = registry.getParser('markdown');
+ * ```
+ */
+export declare class ParserRegistry {
+    private readonly byFormat;
+    private readonly byExtension;
+    /**
+     * Register a parser plugin for its declared format and extensions.
+     *
+     * @param plugin - The parser plugin to register
+     */
+    register(plugin: SpecParserPlugin): void;
+    /**
+     * Retrieve a parser plugin by specification format.
+     *
+     * @param format - The specification format to look up
+     * @returns The registered parser plugin
+     * @throws {@link ForgeError} with code `FORGE-SPEC-001` if no plugin is registered for the format
+     */
+    getParser(format: SpecFormat): SpecParserPlugin;
+    /**
+     * Retrieve a parser plugin by file extension.
+     *
+     * @param extension - The file extension to look up (e.g. `'.md'`)
+     * @returns The registered parser plugin
+     * @throws {@link ForgeError} with code `FORGE-SPEC-001` if no plugin handles the extension
+     */
+    getParserForExtension(extension: string): SpecParserPlugin;
+    /**
+     * List all registered specification formats.
+     *
+     * @returns Array of registered format identifiers
+     */
+    getSupportedFormats(): SpecFormat[];
+    /**
+     * List all registered file extensions.
+     *
+     * @returns Array of registered file extensions
+     */
+    getSupportedExtensions(): string[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAEnE;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAOxC;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB;IAY/C;;;;;;OAMG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAa1D;;;;OAIG;IACH,mBAAmB,IAAI,UAAU,EAAE;IAInC;;;;OAIG;IACH,sBAAsB,IAAI,MAAM,EAAE;CAGnC"}

package/dist/registry.js

@@ -0,0 +1,80 @@
+/**
+ * Parser registry — manages format-specific parser plugins.
+ *
+ * Plugins are registered at startup and looked up by format or file extension
+ * when parsing specification files.
+ */
+import { ForgeError, ErrorCodes } from '@hstm-labs/forge-common';
+/**
+ * Registry of {@link SpecParserPlugin} instances keyed by format and extension.
+ *
+ * @example
+ * ```ts
+ * const registry = new ParserRegistry();
+ * registry.register(myMarkdownPlugin);
+ * const plugin = registry.getParser('markdown');
+ * ```
+ */
+export class ParserRegistry {
+    byFormat = new Map();
+    byExtension = new Map();
+    /**
+     * Register a parser plugin for its declared format and extensions.
+     *
+     * @param plugin - The parser plugin to register
+     */
+    register(plugin) {
+        this.byFormat.set(plugin.format, plugin);
+        for (const ext of plugin.extensions) {
+            this.byExtension.set(ext.toLowerCase(), plugin);
+        }
+    }
+    /**
+     * Retrieve a parser plugin by specification format.
+     *
+     * @param format - The specification format to look up
+     * @returns The registered parser plugin
+     * @throws {@link ForgeError} with code `FORGE-SPEC-001` if no plugin is registered for the format
+     */
+    getParser(format) {
+        const plugin = this.byFormat.get(format);
+        if (!plugin) {
+            throw new ForgeError(ErrorCodes.SPEC.PARSE_FAILURE, `No parser registered for format '${format}'. ` +
+                `Register a SpecParserPlugin for this format before parsing.`);
+        }
+        return plugin;
+    }
+    /**
+     * Retrieve a parser plugin by file extension.
+     *
+     * @param extension - The file extension to look up (e.g. `'.md'`)
+     * @returns The registered parser plugin
+     * @throws {@link ForgeError} with code `FORGE-SPEC-001` if no plugin handles the extension
+     */
+    getParserForExtension(extension) {
+        const plugin = this.byExtension.get(extension.toLowerCase());
+        if (!plugin) {
+            const supported = this.getSupportedExtensions().join(', ');
+            throw new ForgeError(ErrorCodes.SPEC.PARSE_FAILURE, `No parser registered for extension '${extension}'. ` +
+                `Supported extensions: ${supported || '(none)'}.`);
+        }
+        return plugin;
+    }
+    /**
+     * List all registered specification formats.
+     *
+     * @returns Array of registered format identifiers
+     */
+    getSupportedFormats() {
+        return [...this.byFormat.keys()];
+    }
+    /**
+     * List all registered file extensions.
+     *
+     * @returns Array of registered file extensions
+     */
+    getSupportedExtensions() {
+        return [...this.byExtension.keys()];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIjE;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IACR,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IACnD,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEnE;;;;OAIG;IACH,QAAQ,CAAC,MAAwB;QAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,MAAkB;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,UAAU,CAClB,UAAU,CAAC,IAAI,CAAC,aAAa,EAC7B,oCAAoC,MAAM,KAAK;gBAC7C,6DAA6D,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,qBAAqB,CAAC,SAAiB;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,SAAS,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3D,MAAM,IAAI,UAAU,CAClB,UAAU,CAAC,IAAI,CAAC,aAAa,EAC7B,uCAAuC,SAAS,KAAK;gBACnD,yBAAyB,SAAS,IAAI,QAAQ,GAAG,CACpD,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,mBAAmB;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACpB,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Canonical model for parsed specifications.
+ *
+ * All format-specific parsers produce a `ParsedSpecification` instance,
+ * providing a normalized internal representation for downstream pipeline stages.
+ */
+/** Supported specification file formats. */
+export type SpecFormat = 'markdown' | 'yaml' | 'json';
+/** Normalized representation of a parsed specification. */
+export interface ParsedSpecification {
+    /** Metadata about the specification. */
+    metadata: SpecMetadata;
+    /** Top-level sections extracted from the spec. */
+    sections: SpecSection[];
+    /** Functional requirements. */
+    requirements: SpecRequirement[];
+    /** Data entities and their relationships. */
+    entities: SpecEntity[];
+    /** User workflows / use cases. */
+    workflows: SpecWorkflow[];
+    /** Optional: API style declared in the specification. */
+    apiStyle?: 'rest' | 'graphql' | 'grpc' | undefined;
+}
+/** Metadata extracted from a specification file. */
+export interface SpecMetadata {
+    title: string;
+    version?: string | undefined;
+    description?: string | undefined;
+    authors?: string[] | undefined;
+    /** Original file path. */
+    sourcePath: string;
+    /** Detected format. */
+    format: SpecFormat;
+}
+/** A hierarchical section within the specification. */
+export interface SpecSection {
+    id: string;
+    title: string;
+    level: number;
+    content: string;
+    subsections: SpecSection[];
+}
+/** A functional requirement extracted from the specification. */
+export interface SpecRequirement {
+    id: string;
+    title: string;
+    description: string;
+    priority?: 'must' | 'should' | 'could' | 'wont' | undefined;
+    acceptanceCriteria: string[];
+}
+/** A data entity described in the specification. */
+export interface SpecEntity {
+    name: string;
+    description?: string | undefined;
+    fields: EntityField[];
+    relationships: EntityRelationship[];
+}
+/** A field on a data entity. */
+export interface EntityField {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string | undefined;
+}
+/** A relationship between two entities. */
+export interface EntityRelationship {
+    target: string;
+    type: 'one-to-one' | 'one-to-many' | 'many-to-many';
+    description?: string | undefined;
+}
+/** A user workflow or use case extracted from the specification. */
+export interface SpecWorkflow {
+    id: string;
+    name: string;
+    description?: string | undefined;
+    steps: WorkflowStep[];
+    actors?: string[] | undefined;
+}
+/** A single step within a workflow. */
+export interface WorkflowStep {
+    order: number;
+    action: string;
+    expectedResult?: string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAMtD,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,QAAQ,EAAE,YAAY,CAAC;IAEvB,kDAAkD;IAClD,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,+BAA+B;IAC/B,YAAY,EAAE,eAAe,EAAE,CAAC;IAEhC,6CAA6C;IAC7C,QAAQ,EAAE,UAAU,EAAE,CAAC;IAEvB,kCAAkC;IAClC,SAAS,EAAE,YAAY,EAAE,CAAC;IAE1B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;CACpD;AAMD,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,MAAM,EAAE,UAAU,CAAC;CACpB;AAMD,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,EAAE,CAAC;CAC5B;AAMD,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5D,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAMD,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,aAAa,EAAE,kBAAkB,EAAE,CAAC;CACrC;AAED,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,cAAc,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAMD,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/B;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Canonical model for parsed specifications.
+ *
+ * All format-specific parsers produce a `ParsedSpecification` instance,
+ * providing a normalized internal representation for downstream pipeline stages.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/validate-stage.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Validate stage integration — combines parsing and validation into a
+ * single pipeline-stage function.
+ *
+ * This function will be called by the pipeline runner when executing the
+ * `validate` stage of a generation run.
+ */
+import type { ValidationReport } from './validation-types.js';
+/**
+ * Execute the validate pipeline stage: parse a specification file and
+ * validate the result.
+ *
+ * @param specPath - Path to the specification file
+ * @returns Validation report for the parsed specification
+ * @throws {@link ForgeError} if the file cannot be read or parsed
+ */
+export declare function executeValidateStage(specPath: string): ValidationReport;
+//# sourceMappingURL=validate-stage.d.ts.map

package/dist/validate-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-stage.d.ts","sourceRoot":"","sources":["../src/validate-stage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAK9D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAIlB"}

package/dist/validate-stage.js

@@ -0,0 +1,24 @@
+/**
+ * Validate stage integration — combines parsing and validation into a
+ * single pipeline-stage function.
+ *
+ * This function will be called by the pipeline runner when executing the
+ * `validate` stage of a generation run.
+ */
+import { createDefaultRegistry } from './default-registry.js';
+import { parseSpec } from './loader.js';
+import { validateSpec } from './validators/spec-validator.js';
+/**
+ * Execute the validate pipeline stage: parse a specification file and
+ * validate the result.
+ *
+ * @param specPath - Path to the specification file
+ * @returns Validation report for the parsed specification
+ * @throws {@link ForgeError} if the file cannot be read or parsed
+ */
+export function executeValidateStage(specPath) {
+    const registry = createDefaultRegistry();
+    const spec = parseSpec(specPath, registry);
+    return validateSpec(spec);
+}
+//# sourceMappingURL=validate-stage.js.map

package/dist/validate-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-stage.js","sourceRoot":"","sources":["../src/validate-stage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB;IAEhB,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}