@hstm-labs/forge-spec-parser 0.1.2

package/dist/validation-types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Types for specification validation reports.
+ *
+ * Validation produces a structured {@link ValidationReport} containing
+ * individual {@link ValidationFinding} entries from schema, completeness,
+ * and cross-reference checks.
+ */
+/** Severity level of a validation finding. */
+export type ValidationSeverity = 'error' | 'warning' | 'info';
+/** Category of validation check that produced the finding. */
+export type ValidationCategory = 'schema' | 'completeness' | 'cross-reference' | 'consistency';
+/** A single validation finding with remediation guidance. */
+export interface ValidationFinding {
+    /** Finding identifier (e.g. `VAL-001`). */
+    id: string;
+    /** Severity level. */
+    severity: ValidationSeverity;
+    /** Category of the check that produced this finding. */
+    category: ValidationCategory;
+    /** Human-readable description of the issue. */
+    message: string;
+    /** Guidance on how to fix the issue. */
+    remediation: string;
+    /** Optional location reference (section, entity, or requirement). */
+    location?: string | undefined;
+}
+/** Aggregated validation report for a parsed specification. */
+export interface ValidationReport {
+    /** Path to the specification file that was validated. */
+    specPath: string;
+    /** `true` if no error-severity findings exist (warnings are acceptable). */
+    valid: boolean;
+    /** Completeness score from 0.0 (empty) to 1.0 (fully complete). */
+    completenessScore: number;
+    /** All findings from schema, completeness, and cross-reference checks. */
+    findings: ValidationFinding[];
+    /** Summary counts by severity. */
+    summary: {
+        errors: number;
+        warnings: number;
+        info: number;
+    };
+    /** ISO 8601 timestamp when the validation was performed. */
+    checkedAt: string;
+}
+//# sourceMappingURL=validation-types.d.ts.map

package/dist/validation-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-types.d.ts","sourceRoot":"","sources":["../src/validation-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,cAAc,GACd,iBAAiB,GACjB,aAAa,CAAC;AAElB,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAMD,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,kCAAkC;IAClC,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/validation-types.js

@@ -0,0 +1,9 @@
+/**
+ * Types for specification validation reports.
+ *
+ * Validation produces a structured {@link ValidationReport} containing
+ * individual {@link ValidationFinding} entries from schema, completeness,
+ * and cross-reference checks.
+ */
+export {};
+//# sourceMappingURL=validation-types.js.map

package/dist/validation-types.js.map

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

package/dist/validators/completeness-checker.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Completeness checker — analyses how thoroughly a specification covers
+ * the expected dimensions and produces a score with findings.
+ */
+import type { ParsedSpecification } from '../types.js';
+import type { ValidationFinding } from '../validation-types.js';
+/** Result of a completeness check. */
+export interface CompletenessResult {
+    /** Completeness score from 0.0 to 1.0. */
+    score: number;
+    /** Findings for missing or incomplete dimensions. */
+    findings: ValidationFinding[];
+}
+/**
+ * Analyse specification completeness across multiple dimensions.
+ *
+ * Dimensions (each contributes equally to the score):
+ * 1. Has requirements
+ * 2. Has entities
+ * 3. Has workflows
+ * 4. Has acceptance criteria on at least one requirement
+ * 5. All entities have at least one field
+ * 6. All requirements have non-empty descriptions
+ *
+ * @param spec - The parsed specification to analyse
+ * @returns Score and findings
+ */
+export declare function checkCompleteness(spec: ParsedSpecification): CompletenessResult;
+//# sourceMappingURL=completeness-checker.d.ts.map

package/dist/validators/completeness-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completeness-checker.d.ts","sourceRoot":"","sources":["../../src/validators/completeness-checker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAKD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,mBAAmB,GACxB,kBAAkB,CA0HpB"}

package/dist/validators/completeness-checker.js

@@ -0,0 +1,127 @@
+/**
+ * Completeness checker — analyses how thoroughly a specification covers
+ * the expected dimensions and produces a score with findings.
+ */
+/** Total number of completeness dimensions evaluated. */
+const TOTAL_DIMENSIONS = 6;
+/**
+ * Analyse specification completeness across multiple dimensions.
+ *
+ * Dimensions (each contributes equally to the score):
+ * 1. Has requirements
+ * 2. Has entities
+ * 3. Has workflows
+ * 4. Has acceptance criteria on at least one requirement
+ * 5. All entities have at least one field
+ * 6. All requirements have non-empty descriptions
+ *
+ * @param spec - The parsed specification to analyse
+ * @returns Score and findings
+ */
+export function checkCompleteness(spec) {
+    const findings = [];
+    let counter = 0;
+    let coveredDimensions = 0;
+    function nextId() {
+        counter++;
+        return `VAL-C${String(counter).padStart(3, '0')}`;
+    }
+    // --- Dimension 1: Has requirements ---
+    if (spec.requirements.length > 0) {
+        coveredDimensions++;
+    }
+    else {
+        findings.push({
+            id: nextId(),
+            severity: 'warning',
+            category: 'completeness',
+            message: 'No requirements defined in specification.',
+            remediation: 'Add requirements describing expected functionality to improve specification completeness.',
+        });
+    }
+    // --- Dimension 2: Has entities ---
+    if (spec.entities.length > 0) {
+        coveredDimensions++;
+    }
+    else {
+        findings.push({
+            id: nextId(),
+            severity: 'warning',
+            category: 'completeness',
+            message: 'No entities defined in specification.',
+            remediation: 'Add entities describing the data model to improve specification completeness.',
+        });
+    }
+    // --- Dimension 3: Has workflows ---
+    if (spec.workflows.length > 0) {
+        coveredDimensions++;
+    }
+    else {
+        findings.push({
+            id: nextId(),
+            severity: 'warning',
+            category: 'completeness',
+            message: 'No workflows defined in specification.',
+            remediation: 'Add workflows describing user flows or use cases to improve specification completeness.',
+        });
+    }
+    // --- Dimension 4: At least one requirement has acceptance criteria ---
+    const hasAnyCriteria = spec.requirements.some((r) => r.acceptanceCriteria.length > 0);
+    if (hasAnyCriteria) {
+        coveredDimensions++;
+    }
+    else if (spec.requirements.length > 0) {
+        findings.push({
+            id: nextId(),
+            severity: 'warning',
+            category: 'completeness',
+            message: 'No requirements have acceptance criteria defined.',
+            remediation: 'Add acceptance criteria to at least one requirement to clarify expected behaviour.',
+        });
+    }
+    // --- Dimension 5: All entities have at least one field ---
+    if (spec.entities.length > 0) {
+        const allHaveFields = spec.entities.every((e) => e.fields.length > 0);
+        if (allHaveFields) {
+            coveredDimensions++;
+        }
+        else {
+            const incomplete = spec.entities
+                .filter((e) => e.fields.length === 0)
+                .map((e) => e.name || '(unnamed)');
+            for (const name of incomplete) {
+                findings.push({
+                    id: nextId(),
+                    severity: 'warning',
+                    category: 'completeness',
+                    message: `Entity '${name}' has no fields defined.`,
+                    remediation: `Add fields to entity '${name}' describing its data structure.`,
+                    location: `entity:${name}`,
+                });
+            }
+        }
+    }
+    // --- Dimension 6: All requirements have descriptions ---
+    if (spec.requirements.length > 0) {
+        const allDescribed = spec.requirements.every((r) => r.description.trim().length > 0);
+        if (allDescribed) {
+            coveredDimensions++;
+        }
+        else {
+            const missing = spec.requirements.filter((r) => !r.description.trim());
+            for (const req of missing) {
+                findings.push({
+                    id: nextId(),
+                    severity: 'info',
+                    category: 'completeness',
+                    message: `Requirement '${req.id || '(no id)'}' has no description.`,
+                    remediation: `Add a description to requirement '${req.id || '(no id)'}' explaining its intent.`,
+                    location: `requirement:${req.id}`,
+                });
+            }
+        }
+    }
+    const score = TOTAL_DIMENSIONS > 0 ? coveredDimensions / TOTAL_DIMENSIONS : 0;
+    return { score, findings };
+}
+//# sourceMappingURL=completeness-checker.js.map

package/dist/validators/completeness-checker.js.map

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

package/dist/validators/cross-reference-validator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Cross-reference validator — checks referential integrity within a
+ * parsed specification.
+ *
+ * Validates that relationship targets exist, workflow step text references
+ * known entities, and that identifiers are unique.
+ */
+import type { ParsedSpecification } from '../types.js';
+import type { ValidationFinding } from '../validation-types.js';
+/**
+ * Validate cross-references and referential integrity within a specification.
+ *
+ * @param spec - The parsed specification to validate
+ * @returns Array of findings (empty if all references are valid)
+ */
+export declare function validateCrossReferences(spec: ParsedSpecification): ValidationFinding[];
+//# sourceMappingURL=cross-reference-validator.d.ts.map

package/dist/validators/cross-reference-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-reference-validator.d.ts","sourceRoot":"","sources":["../../src/validators/cross-reference-validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,mBAAmB,GACxB,iBAAiB,EAAE,CA+HrB"}

package/dist/validators/cross-reference-validator.js

@@ -0,0 +1,150 @@
+/**
+ * Cross-reference validator — checks referential integrity within a
+ * parsed specification.
+ *
+ * Validates that relationship targets exist, workflow step text references
+ * known entities, and that identifiers are unique.
+ */
+/**
+ * Validate cross-references and referential integrity within a specification.
+ *
+ * @param spec - The parsed specification to validate
+ * @returns Array of findings (empty if all references are valid)
+ */
+export function validateCrossReferences(spec) {
+    const findings = [];
+    let counter = 0;
+    function nextId() {
+        counter++;
+        return `VAL-X${String(counter).padStart(3, '0')}`;
+    }
+    const entityNames = new Set(spec.entities.map((e) => e.name.toLowerCase()));
+    // --- Entity relationship targets ---
+    for (const entity of spec.entities) {
+        for (const rel of entity.relationships) {
+            // Check singular and plural forms
+            const target = rel.target.toLowerCase();
+            const targetSingular = target.endsWith('s')
+                ? target.slice(0, -1)
+                : target;
+            if (!entityNames.has(target) &&
+                !entityNames.has(targetSingular)) {
+                findings.push({
+                    id: nextId(),
+                    severity: 'error',
+                    category: 'cross-reference',
+                    message: `Entity '${entity.name}' has a relationship targeting '${rel.target}', but no entity with that name exists.`,
+                    remediation: `Define an entity named '${rel.target}' or correct the relationship target in entity '${entity.name}'.`,
+                    location: `entity:${entity.name}.relationship:${rel.target}`,
+                });
+            }
+        }
+    }
+    // --- Workflow entity references (heuristic) ---
+    for (const workflow of spec.workflows) {
+        const stepText = workflow.steps
+            .map((s) => s.action)
+            .join(' ');
+        for (const entity of spec.entities) {
+            if (!entity.name)
+                continue;
+            // Check if entity name appears in workflow steps but entity
+            // is not in the defined list — this is already covered above.
+            // Instead, flag entity names mentioned in workflows where
+            // the entity is referenced by a name that doesn't match any
+            // known entity (for non-defined entities mentioned in text).
+        }
+        // Scan for capitalized words that look like entity names but
+        // aren't defined
+        const wordPattern = /\b([A-Z][a-z]+(?:[A-Z][a-z]+)*)\b/g;
+        let match;
+        const seen = new Set();
+        while ((match = wordPattern.exec(stepText)) !== null) {
+            const word = match[1];
+            const lower = word.toLowerCase();
+            // Skip common non-entity words
+            if (isCommonWord(lower))
+                continue;
+            // Skip already seen
+            if (seen.has(lower))
+                continue;
+            seen.add(lower);
+            // Only flag if there are defined entities to compare against
+            // and the word looks like it could be an entity reference
+            if (spec.entities.length > 0 &&
+                !entityNames.has(lower) &&
+                !entityNames.has(lower.endsWith('s') ? lower.slice(0, -1) : lower)) {
+                // Heuristic: only warn, don't error
+                // Skip — too many false positives from actor names and
+                // generic words. Only flag if an entity section explicitly
+                // references it.
+            }
+        }
+    }
+    // --- Duplicate requirement IDs ---
+    const reqIdCounts = new Map();
+    for (const req of spec.requirements) {
+        if (!req.id)
+            continue;
+        reqIdCounts.set(req.id, (reqIdCounts.get(req.id) ?? 0) + 1);
+    }
+    for (const [id, count] of reqIdCounts) {
+        if (count > 1) {
+            findings.push({
+                id: nextId(),
+                severity: 'error',
+                category: 'cross-reference',
+                message: `Duplicate requirement ID '${id}' found ${String(count)} times.`,
+                remediation: `Assign unique IDs to each requirement. Rename duplicates of '${id}'.`,
+                location: `requirement:${id}`,
+            });
+        }
+    }
+    // --- Duplicate entity names ---
+    const entityNameCounts = new Map();
+    for (const entity of spec.entities) {
+        if (!entity.name)
+            continue;
+        const key = entity.name.toLowerCase();
+        entityNameCounts.set(key, (entityNameCounts.get(key) ?? 0) + 1);
+    }
+    for (const [name, count] of entityNameCounts) {
+        if (count > 1) {
+            findings.push({
+                id: nextId(),
+                severity: 'error',
+                category: 'cross-reference',
+                message: `Duplicate entity name '${name}' found ${String(count)} times.`,
+                remediation: `Rename duplicate entities so each has a unique name.`,
+                location: `entity:${name}`,
+            });
+        }
+    }
+    return findings;
+}
+/** Common words that should not be flagged as potential entity references. */
+function isCommonWord(word) {
+    const common = new Set([
+        'user',
+        'system',
+        'admin',
+        'client',
+        'server',
+        'the',
+        'form',
+        'page',
+        'data',
+        'input',
+        'output',
+        'error',
+        'success',
+        'task',
+        'step',
+        'action',
+        'result',
+        'request',
+        'response',
+    ]);
+    return common.has(word);
+}
+//# sourceMappingURL=cross-reference-validator.js.map

package/dist/validators/cross-reference-validator.js.map

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

package/dist/validators/schema-validator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Schema validator — validates the structural integrity of a
+ * {@link ParsedSpecification}.
+ *
+ * Checks required fields, non-empty values, and structural constraints.
+ */
+import type { ParsedSpecification } from '../types.js';
+import type { ValidationFinding } from '../validation-types.js';
+/**
+ * Validate the structural integrity of a parsed specification.
+ *
+ * @param spec - The parsed specification to validate
+ * @returns Array of findings (empty if fully valid)
+ */
+export declare function validateSchema(spec: ParsedSpecification): ValidationFinding[];
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/validators/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/validators/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,mBAAmB,GACxB,iBAAiB,EAAE,CAiKrB"}

package/dist/validators/schema-validator.js

@@ -0,0 +1,146 @@
+/**
+ * Schema validator — validates the structural integrity of a
+ * {@link ParsedSpecification}.
+ *
+ * Checks required fields, non-empty values, and structural constraints.
+ */
+/**
+ * Validate the structural integrity of a parsed specification.
+ *
+ * @param spec - The parsed specification to validate
+ * @returns Array of findings (empty if fully valid)
+ */
+export function validateSchema(spec) {
+    const findings = [];
+    let counter = 0;
+    function nextId() {
+        counter++;
+        return `VAL-S${String(counter).padStart(3, '0')}`;
+    }
+    // --- Metadata checks ---
+    if (!spec.metadata.title) {
+        findings.push({
+            id: nextId(),
+            severity: 'error',
+            category: 'schema',
+            message: 'Specification metadata is missing a title.',
+            remediation: 'Add a non-empty title to the specification metadata (frontmatter or top-level field).',
+            location: 'metadata.title',
+        });
+    }
+    if (!spec.metadata.sourcePath) {
+        findings.push({
+            id: nextId(),
+            severity: 'error',
+            category: 'schema',
+            message: 'Specification metadata is missing a source path.',
+            remediation: 'Ensure the specification is loaded from a valid file path.',
+            location: 'metadata.sourcePath',
+        });
+    }
+    // --- Collection-level checks ---
+    if (spec.requirements.length === 0) {
+        findings.push({
+            id: nextId(),
+            severity: 'warning',
+            category: 'schema',
+            message: 'Specification has no requirements defined.',
+            remediation: 'Add at least one requirement to the specification to describe expected functionality.',
+        });
+    }
+    if (spec.entities.length === 0) {
+        findings.push({
+            id: nextId(),
+            severity: 'warning',
+            category: 'schema',
+            message: 'Specification has no entities defined.',
+            remediation: 'Add at least one entity to the specification to describe the data model.',
+        });
+    }
+    // --- Requirement-level checks ---
+    for (let i = 0; i < spec.requirements.length; i++) {
+        const req = spec.requirements[i];
+        const loc = `requirements[${String(i)}]`;
+        if (!req.id) {
+            findings.push({
+                id: nextId(),
+                severity: 'error',
+                category: 'schema',
+                message: `Requirement at index ${String(i)} is missing an id.`,
+                remediation: 'Assign a unique identifier to this requirement (e.g. REQ-001).',
+                location: `${loc}.id`,
+            });
+        }
+        if (!req.title) {
+            findings.push({
+                id: nextId(),
+                severity: 'error',
+                category: 'schema',
+                message: `Requirement '${req.id || `[index ${String(i)}]`}' is missing a title.`,
+                remediation: 'Add a non-empty title summarising this requirement.',
+                location: `${loc}.title`,
+            });
+        }
+        if (!req.description) {
+            findings.push({
+                id: nextId(),
+                severity: 'error',
+                category: 'schema',
+                message: `Requirement '${req.id || `[index ${String(i)}]`}' is missing a description.`,
+                remediation: 'Add a non-empty description explaining this requirement.',
+                location: `${loc}.description`,
+            });
+        }
+    }
+    // --- Entity-level checks ---
+    for (let i = 0; i < spec.entities.length; i++) {
+        const entity = spec.entities[i];
+        const loc = `entities[${String(i)}]`;
+        if (!entity.name) {
+            findings.push({
+                id: nextId(),
+                severity: 'error',
+                category: 'schema',
+                message: `Entity at index ${String(i)} is missing a name.`,
+                remediation: 'Assign a name to this entity.',
+                location: `${loc}.name`,
+            });
+        }
+        if (entity.fields.length === 0) {
+            findings.push({
+                id: nextId(),
+                severity: 'error',
+                category: 'schema',
+                message: `Entity '${entity.name || `[index ${String(i)}]`}' has no fields defined.`,
+                remediation: 'Add at least one field to this entity describing its data structure.',
+                location: `${loc}.fields`,
+            });
+        }
+        for (let j = 0; j < entity.fields.length; j++) {
+            const field = entity.fields[j];
+            const fieldLoc = `${loc}.fields[${String(j)}]`;
+            if (!field.name) {
+                findings.push({
+                    id: nextId(),
+                    severity: 'error',
+                    category: 'schema',
+                    message: `Field at index ${String(j)} in entity '${entity.name || `[index ${String(i)}]`}' is missing a name.`,
+                    remediation: 'Assign a name to this field.',
+                    location: `${fieldLoc}.name`,
+                });
+            }
+            if (!field.type) {
+                findings.push({
+                    id: nextId(),
+                    severity: 'error',
+                    category: 'schema',
+                    message: `Field '${field.name || `[index ${String(j)}]`}' in entity '${entity.name || `[index ${String(i)}]`}' is missing a type.`,
+                    remediation: 'Specify a data type for this field (e.g. string, number, uuid).',
+                    location: `${fieldLoc}.type`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/validators/schema-validator.js.map

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

package/dist/validators/spec-validator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Main specification validator — orchestrates all validators and produces
+ * a complete {@link ValidationReport}.
+ */
+import type { ParsedSpecification } from '../types.js';
+import type { ValidationReport } from '../validation-types.js';
+/**
+ * Validate a parsed specification across all dimensions: schema,
+ * completeness, and cross-references.
+ *
+ * @param spec - The parsed specification to validate
+ * @returns A complete validation report
+ */
+export declare function validateSpec(spec: ParsedSpecification): ValidationReport;
+//# sourceMappingURL=spec-validator.d.ts.map

package/dist/validators/spec-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-validator.d.ts","sourceRoot":"","sources":["../../src/validators/spec-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK/D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,mBAAmB,GACxB,gBAAgB,CAuClB"}