@hstm-labs/forge-spec-parser 0.1.2

package/README.md

@@ -0,0 +1,53 @@
+# @hstm-labs/forge-spec-parser
+
+Specification parsing and validation for Forge — reads product specifications in Markdown, YAML, or JSON format and produces a canonical `ParsedSpecification` model with completeness scoring and cross-reference validation.
+
+## Installation
+
+```bash
+npm install @hstm-labs/forge-spec-parser
+```
+
+## Public API
+
+### Parsing
+
+- `parseSpec(content, format)` — parse specification content into canonical model
+- `loadSpecFile(path)` — load and parse a specification file
+- `detectFormat(path)` — auto-detect specification format
+- `ParserRegistry` — plugin registry for format parsers
+- `createDefaultRegistry()` — factory for registry with all built-in parsers
+
+### Parser Plugins
+
+- `MarkdownParserPlugin` — GFM Markdown with entity/requirement extraction
+- `YamlParserPlugin` — structured YAML specifications
+- `JsonParserPlugin` — structured JSON specifications
+- `mapStructuredSpec()` — shared mapper for YAML/JSON formats
+
+### Validation
+
+- `validateSpec(spec)` — full validation (schema + completeness + cross-references)
+- `validateSchema(spec)` — schema validation
+- `checkCompleteness(spec)` — 6-dimension completeness scoring
+- `validateCrossReferences(spec)` — entity/requirement reference integrity
+
+### Types
+
+- `ParsedSpecification` — canonical specification model
+- `SpecRequirement`, `SpecEntity`, `SpecWorkflow` — specification components
+- `ValidationReport`, `ValidationFinding` — validation output
+
+## Usage
+
+```typescript
+import { loadSpecFile, validateSpec } from '@hstm-labs/forge-spec-parser';
+
+const spec = await loadSpecFile('specs/product-spec.md');
+const report = validateSpec(spec);
+console.log(`Completeness: ${report.completeness.overall}%`);
+```
+
+## License
+
+[MIT](../../LICENSE)

package/dist/default-registry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Factory for creating a pre-configured parser registry.
+ *
+ * Returns a {@link ParserRegistry} with all built-in parser plugins
+ * registered, ready for use with {@link parseSpec}.
+ */
+import { ParserRegistry } from './registry.js';
+/**
+ * Create a parser registry pre-loaded with all built-in parser plugins.
+ *
+ * Currently registers:
+ * - {@link MarkdownParserPlugin} — `.md` files
+ * - {@link YamlParserPlugin} — `.yaml`, `.yml` files
+ * - {@link JsonParserPlugin} — `.json` files
+ *
+ * @returns A fully-configured {@link ParserRegistry}
+ */
+export declare function createDefaultRegistry(): ParserRegistry;
+//# sourceMappingURL=default-registry.d.ts.map

package/dist/default-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-registry.d.ts","sourceRoot":"","sources":["../src/default-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAK/C;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAMtD"}

package/dist/default-registry.js

@@ -0,0 +1,28 @@
+/**
+ * Factory for creating a pre-configured parser registry.
+ *
+ * Returns a {@link ParserRegistry} with all built-in parser plugins
+ * registered, ready for use with {@link parseSpec}.
+ */
+import { ParserRegistry } from './registry.js';
+import { MarkdownParserPlugin } from './parsers/markdown-parser.js';
+import { YamlParserPlugin } from './parsers/yaml-parser.js';
+import { JsonParserPlugin } from './parsers/json-parser.js';
+/**
+ * Create a parser registry pre-loaded with all built-in parser plugins.
+ *
+ * Currently registers:
+ * - {@link MarkdownParserPlugin} — `.md` files
+ * - {@link YamlParserPlugin} — `.yaml`, `.yml` files
+ * - {@link JsonParserPlugin} — `.json` files
+ *
+ * @returns A fully-configured {@link ParserRegistry}
+ */
+export function createDefaultRegistry() {
+    const registry = new ParserRegistry();
+    registry.register(new MarkdownParserPlugin());
+    registry.register(new YamlParserPlugin());
+    registry.register(new JsonParserPlugin());
+    return registry;
+}
+//# sourceMappingURL=default-registry.js.map

package/dist/default-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-registry.js","sourceRoot":"","sources":["../src/default-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/detect.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Format auto-detection for specification files.
+ *
+ * Determines the {@link SpecFormat} of a specification file based on its
+ * file extension.
+ */
+import type { SpecFormat } from './types.js';
+/**
+ * Detect the specification format from a file's extension.
+ *
+ * @param filePath - Path to the specification file
+ * @returns The detected specification format
+ * @throws {@link ForgeError} with code `FORGE-SPEC-001` if the extension is unsupported
+ */
+export declare function detectFormat(filePath: string): SpecFormat;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAa7C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAWzD"}

package/dist/detect.js

@@ -0,0 +1,32 @@
+/**
+ * Format auto-detection for specification files.
+ *
+ * Determines the {@link SpecFormat} of a specification file based on its
+ * file extension.
+ */
+import path from 'node:path';
+import { ForgeError, ErrorCodes } from '@hstm-labs/forge-common';
+/** Map of file extensions to specification formats. */
+const EXTENSION_MAP = new Map([
+    ['.md', 'markdown'],
+    ['.yaml', 'yaml'],
+    ['.yml', 'yaml'],
+    ['.json', 'json'],
+]);
+/**
+ * Detect the specification format from a file's extension.
+ *
+ * @param filePath - Path to the specification file
+ * @returns The detected specification format
+ * @throws {@link ForgeError} with code `FORGE-SPEC-001` if the extension is unsupported
+ */
+export function detectFormat(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const format = EXTENSION_MAP.get(ext);
+    if (!format) {
+        throw new ForgeError(ErrorCodes.SPEC.PARSE_FAILURE, `Unsupported specification format: '${ext || '(no extension)'}'. ` +
+            `Supported: .md, .yaml, .yml, .json`);
+    }
+    return format;
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGjE,uDAAuD;AACvD,MAAM,aAAa,GAAoC,IAAI,GAAG,CAG5D;IACA,CAAC,KAAK,EAAE,UAAU,CAAC;IACnB,CAAC,OAAO,EAAE,MAAM,CAAC;IACjB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,OAAO,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,UAAU,CAClB,UAAU,CAAC,IAAI,CAAC,aAAa,EAC7B,sCAAsC,GAAG,IAAI,gBAAgB,KAAK;YAChE,oCAAoC,CACvC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export type { SpecFormat, ParsedSpecification, SpecMetadata, SpecSection, SpecRequirement, SpecEntity, EntityField, EntityRelationship, SpecWorkflow, WorkflowStep, } from './types.js';
+export type { SpecParserPlugin } from './parser-plugin.js';
+export { ParserRegistry } from './registry.js';
+export { detectFormat } from './detect.js';
+export { loadSpecFile, parseSpec } from './loader.js';
+export { MarkdownParserPlugin } from './parsers/markdown-parser.js';
+export { YamlParserPlugin } from './parsers/yaml-parser.js';
+export { JsonParserPlugin } from './parsers/json-parser.js';
+export { mapStructuredSpec } from './parsers/structured-mapper.js';
+export { createDefaultRegistry } from './default-registry.js';
+export type { ValidationSeverity, ValidationCategory, ValidationFinding, ValidationReport, } from './validation-types.js';
+export { validateSchema } from './validators/schema-validator.js';
+export { checkCompleteness } from './validators/completeness-checker.js';
+export type { CompletenessResult } from './validators/completeness-checker.js';
+export { validateCrossReferences } from './validators/cross-reference-validator.js';
+export { validateSpec } from './validators/spec-validator.js';
+export { executeValidateStage } from './validate-stage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+// @hstm-labs/forge-spec-parser public API
+// Parser registry
+export { ParserRegistry } from './registry.js';
+// Format detection
+export { detectFormat } from './detect.js';
+// File loading and parse entry point
+export { loadSpecFile, parseSpec } from './loader.js';
+// Parser plugins
+export { MarkdownParserPlugin } from './parsers/markdown-parser.js';
+export { YamlParserPlugin } from './parsers/yaml-parser.js';
+export { JsonParserPlugin } from './parsers/json-parser.js';
+// Shared structured mapper
+export { mapStructuredSpec } from './parsers/structured-mapper.js';
+// Default registry factory
+export { createDefaultRegistry } from './default-registry.js';
+// Validators
+export { validateSchema } from './validators/schema-validator.js';
+export { checkCompleteness } from './validators/completeness-checker.js';
+export { validateCrossReferences } from './validators/cross-reference-validator.js';
+export { validateSpec } from './validators/spec-validator.js';
+// Validate stage integration
+export { executeValidateStage } from './validate-stage.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAmB1C,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,qCAAqC;AACrC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEtD,iBAAiB;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,2BAA2B;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,2BAA2B;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAU9D,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,6BAA6B;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Specification file loader and primary parse entry point.
+ *
+ * Provides {@link loadSpecFile} for reading raw file content and
+ * {@link parseSpec} as the main public API for parsing a specification
+ * file into the canonical {@link ParsedSpecification} model.
+ */
+import type { ParsedSpecification } from './types.js';
+import type { ParserRegistry } from './registry.js';
+/**
+ * Read the content of a specification file from disk.
+ *
+ * @param filePath - Absolute or relative path to the specification file
+ * @returns The file content as a UTF-8 string
+ * @throws {@link ForgeError} with code `FORGE-SPEC-001` if the file cannot be read
+ */
+export declare function loadSpecFile(filePath: string): string;
+/**
+ * Parse a specification file into the canonical model.
+ *
+ * Detects the file format, selects the appropriate parser plugin from the
+ * registry, reads the file content, and delegates to the plugin's `parse`
+ * method.
+ *
+ * @param filePath - Path to the specification file
+ * @param registry - Parser registry with registered format plugins
+ * @returns Parsed specification
+ * @throws {@link ForgeError} with code `FORGE-SPEC-001` if format detection, file reading, or parsing fails
+ */
+export declare function parseSpec(filePath: string, registry: ParserRegistry): ParsedSpecification;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,GACvB,mBAAmB,CAKrB"}

package/dist/loader.js

@@ -0,0 +1,45 @@
+/**
+ * Specification file loader and primary parse entry point.
+ *
+ * Provides {@link loadSpecFile} for reading raw file content and
+ * {@link parseSpec} as the main public API for parsing a specification
+ * file into the canonical {@link ParsedSpecification} model.
+ */
+import fs from 'node:fs';
+import { ForgeError, ErrorCodes } from '@hstm-labs/forge-common';
+import { detectFormat } from './detect.js';
+/**
+ * Read the content of a specification file from disk.
+ *
+ * @param filePath - Absolute or relative path to the specification file
+ * @returns The file content as a UTF-8 string
+ * @throws {@link ForgeError} with code `FORGE-SPEC-001` if the file cannot be read
+ */
+export function loadSpecFile(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch (error) {
+        throw new ForgeError(ErrorCodes.SPEC.PARSE_FAILURE, `Failed to read specification file '${filePath}'. ` +
+            `Ensure the file exists and is readable, then retry.`, error instanceof Error ? { cause: error } : {});
+    }
+}
+/**
+ * Parse a specification file into the canonical model.
+ *
+ * Detects the file format, selects the appropriate parser plugin from the
+ * registry, reads the file content, and delegates to the plugin's `parse`
+ * method.
+ *
+ * @param filePath - Path to the specification file
+ * @param registry - Parser registry with registered format plugins
+ * @returns Parsed specification
+ * @throws {@link ForgeError} with code `FORGE-SPEC-001` if format detection, file reading, or parsing fails
+ */
+export function parseSpec(filePath, registry) {
+    const format = detectFormat(filePath);
+    const plugin = registry.getParser(format);
+    const content = loadSpecFile(filePath);
+    return plugin.parse(content, filePath);
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAClB,UAAU,CAAC,IAAI,CAAC,aAAa,EAC7B,sCAAsC,QAAQ,KAAK;YACjD,qDAAqD,EACvD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CACvB,QAAgB,EAChB,QAAwB;IAExB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/dist/parser-plugin.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Plugin interface for format-specific specification parsers.
+ *
+ * Each plugin handles a single {@link SpecFormat} and converts raw file
+ * content into the canonical {@link ParsedSpecification} model.
+ */
+import type { ParsedSpecification, SpecFormat } from './types.js';
+/** Contract that all format-specific parsers must implement. */
+export interface SpecParserPlugin {
+    /** Format this plugin handles. */
+    readonly format: SpecFormat;
+    /** File extensions this plugin handles (e.g. `['.md']`). */
+    readonly extensions: string[];
+    /**
+     * Parse raw content into the canonical specification model.
+     *
+     * @param content - Raw file content as a string
+     * @param sourcePath - Original file path (used for metadata)
+     * @returns Parsed specification
+     */
+    parse(content: string, sourcePath: string): ParsedSpecification;
+}
+//# sourceMappingURL=parser-plugin.d.ts.map

package/dist/parser-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-plugin.d.ts","sourceRoot":"","sources":["../src/parser-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAElE,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAE9B;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACjE"}

package/dist/parser-plugin.js

@@ -0,0 +1,8 @@
+/**
+ * Plugin interface for format-specific specification parsers.
+ *
+ * Each plugin handles a single {@link SpecFormat} and converts raw file
+ * content into the canonical {@link ParsedSpecification} model.
+ */
+export {};
+//# sourceMappingURL=parser-plugin.js.map

package/dist/parser-plugin.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/json-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,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,CAAa;IAE1C;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB;CAgBhE"}

package/dist/parsers/json-parser.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-parser.js","sourceRoot":"","sources":["../../src/parsers/json-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,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,CAAC,CAAC;IAE1C;;;;;;;OAOG;IACH,KAAK,CAAC,OAAe,EAAE,UAAkB;QACvC,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;QACxC,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/parsers/markdown-parser.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Markdown specification parser plugin.
+ *
+ * Converts rich Markdown specification documents into the canonical
+ * {@link ParsedSpecification} model using a two-phase pipeline:
+ *   1. Markdown → mdast (Abstract Syntax Tree) via unified/remark
+ *   2. mdast → ParsedSpecification via AST walking and extraction
+ */
+import type { SpecParserPlugin } from '../parser-plugin.js';
+import type { ParsedSpecification, SpecFormat } from '../types.js';
+/**
+ * Parser plugin for Markdown specification files.
+ *
+ * Implements the two-phase Markdown → AST → ParsedSpecification pipeline.
+ * Supports YAML frontmatter, GFM tables, task lists, and ordered lists.
+ */
+export declare class MarkdownParserPlugin implements SpecParserPlugin {
+    readonly format: SpecFormat;
+    readonly extensions: string[];
+    /**
+     * Parse a Markdown specification into the canonical model.
+     *
+     * @param content - Raw Markdown content
+     * @param sourcePath - Original file path
+     * @returns Parsed specification
+     */
+    parse(content: string, sourcePath: string): ParsedSpecification;
+    private extractMetadata;
+    private extractSections;
+    private extractRequirements;
+    private listItemToRequirement;
+    private extractEntities;
+    private extractEntitiesFromNodes;
+    private buildEntity;
+    private parseTableFields;
+    private parseListFields;
+    private extractWorkflows;
+    private buildWorkflow;
+    private detectApiStyle;
+}
+//# sourceMappingURL=markdown-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/markdown-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EACV,mBAAmB,EASnB,UAAU,EACX,MAAM,aAAa,CAAC;AA6OrB;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAc;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAW;IAExC;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB;IAmC/D,OAAO,CAAC,eAAe;IA0DvB,OAAO,CAAC,eAAe;IAwDvB,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,qBAAqB;IAmD7B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,wBAAwB;IAsEhC,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,gBAAgB;IAsDxB,OAAO,CAAC,eAAe;IAyCvB,OAAO,CAAC,gBAAgB;IA6CxB,OAAO,CAAC,aAAa;IA2DrB,OAAO,CAAC,cAAc;CAUvB"}