@libar-dev/architect 1.0.0-pre.3

package/dist/git/name-status.js

@@ -0,0 +1,66 @@
+/**
+ * @architect
+ * @architect-pattern GitNameStatusParser
+ * @architect-status active
+ * @architect-arch-role utility
+ * @architect-arch-context generator
+ * @architect-arch-layer infrastructure
+ * @architect-used-by GitBranchDiff, DetectChanges
+ *
+ * ## GitNameStatusParser - Shared Parsing for `git diff --name-status -z`
+ *
+ * Parses NUL-delimited git name-status output into categorized file lists.
+ * Using `-z` preserves filenames with spaces and rename/copy pairs without
+ * relying on whitespace splitting.
+ */
+/**
+ * Parse NUL-delimited `git diff --name-status -z` output.
+ *
+ * Git emits records as:
+ * - `M\0path\0`
+ * - `A\0path\0`
+ * - `D\0path\0`
+ * - `R100\0old_path\0new_path\0`
+ * - `C087\0source_path\0copy_path\0`
+ */
+export function parseGitNameStatus(output) {
+    const modified = [];
+    const added = [];
+    const deleted = [];
+    const tokens = output.split('\0');
+    let index = 0;
+    while (index < tokens.length) {
+        const status = tokens[index++];
+        if (!status)
+            continue;
+        const kind = status[0];
+        if (!kind)
+            continue;
+        if (kind === 'R' || kind === 'C') {
+            const oldPath = tokens[index++];
+            const newPath = tokens[index++];
+            if (!oldPath || !newPath)
+                continue;
+            modified.push(newPath);
+            continue;
+        }
+        const filePath = tokens[index++];
+        if (!filePath)
+            continue;
+        switch (kind) {
+            case 'M':
+                modified.push(filePath);
+                break;
+            case 'A':
+                added.push(filePath);
+                break;
+            case 'D':
+                deleted.push(filePath);
+                break;
+            default:
+                break;
+        }
+    }
+    return { modified, added, deleted };
+}
+//# sourceMappingURL=name-status.js.map

package/dist/git/name-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-status.js","sourceRoot":"","sources":["../../src/git/name-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO;gBAAE,SAAS;YACnC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,GAAG;gBACN,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrB,MAAM;YACR,KAAK,GAAG;gBACN,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @architect
+ */
+/**
+ * @architect-core @architect-intro
+ * @architect-pattern PublicAPI
+ * @architect-status completed
+ *
+ * ## PublicAPI - Package Entry Point
+ *
+ * Main entry point for the @libar-dev/architect package.
+ * Exports the three-stage pipeline (Scanner → Extractor → Generator) for
+ * extracting documentation directly from TypeScript source code.
+ *
+ * **Key Features:**
+ * - Three-stage pipeline: Scanner → Extractor → Generator
+ * - Tag-based categorization with priority inference
+ * - Composable section-based document generation
+ * - JSON-configurable generators
+ *
+ * ### When to Use
+ *
+ * - Use when importing the package's public API in client code
+ * - Use for accessing scanner, extractor, and generator modules
+ */
+/**
+ * Configuration API for creating customized Architect instances.
+ *
+ * @example
+ * ```typescript
+ * import { createArchitect } from '@libar-dev/architect';
+ *
+ * // Use the default libar-generic preset for non-DDD projects
+ * const dp = createArchitect();
+ *
+ * // Or customize the tag prefix
+ * const dp = createArchitect({
+ *   tagPrefix: "@my-project-",
+ *   fileOptInTag: "@my-project"
+ * });
+ * ```
+ */
+export { createArchitect, type CreateArchitectOptions } from './config/factory.js';
+export type { ArchitectConfig, ArchitectInstance, RegexBuilders } from './config/types.js';
+export { createRegexBuilders } from './config/regex-builders.js';
+export { LIBAR_GENERIC_PRESET, DDD_ES_CQRS_PRESET, PRESETS, type PresetName, } from './config/presets.js';
+export * from './types/index.js';
+export * from './scanner/index.js';
+export * from './extractor/index.js';
+export * from './validation-schemas/index.js';
+/**
+ * New section-based generator system.
+ *
+ * Use this for all new code. Provides composable sections, JSON configuration,
+ * and cleaner API design.
+ *
+ * @example
+ * ```typescript
+ * import { generatorRegistry } from '@libar-dev/architect/generators';
+ * import '@libar-dev/architect/generators/built-in';
+ *
+ * const generator = generatorRegistry.get('patterns');
+ * const output = await generator.generate(patterns, context);
+ * ```
+ */
+export * as generators from './generators/index.js';
+/**
+ * RenderableDocument Model for codec-based document generation.
+ *
+ * New architecture that uses Zod 4 codecs to transform MasterDataset into
+ * RenderableDocuments, which are rendered to markdown via a universal renderer.
+ *
+ * @example
+ * ```typescript
+ * import { generateDocument, generateAllDocuments } from '@libar-dev/architect/renderable';
+ *
+ * // Generate a single document type
+ * const files = generateDocument("patterns", masterDataset);
+ *
+ * // Generate all document types
+ * const allFiles = generateAllDocuments(masterDataset);
+ * ```
+ */
+export * as renderable from './renderable/index.js';
+/**
+ * Lint module for pattern annotation quality and process validation.
+ *
+ * Includes:
+ * - **Rules & Engine**: Pattern annotation quality checking
+ * - **Process Guard**: FSM validation, change detection, protection enforcement
+ *
+ * @example
+ * ```typescript
+ * import { lintFiles, validateChanges } from '@libar-dev/architect/lint';
+ *
+ * // Lint pattern annotations
+ * const result = await lintFiles(['src/**\/*.ts']);
+ *
+ * // Validate process changes (pre-commit)
+ * const validation = validateChanges(input);
+ * if (hasErrors(validation)) {
+ *   console.error('Process violations detected');
+ * }
+ * ```
+ */
+export * as lint from './lint/index.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":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEnF,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,OAAO,EACP,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAG7B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,+BAA+B,CAAC;AAM9C;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AAMpD;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AAMpD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,122 @@
+/**
+ * @architect
+ */
+/**
+ * @architect-core @architect-intro
+ * @architect-pattern PublicAPI
+ * @architect-status completed
+ *
+ * ## PublicAPI - Package Entry Point
+ *
+ * Main entry point for the @libar-dev/architect package.
+ * Exports the three-stage pipeline (Scanner → Extractor → Generator) for
+ * extracting documentation directly from TypeScript source code.
+ *
+ * **Key Features:**
+ * - Three-stage pipeline: Scanner → Extractor → Generator
+ * - Tag-based categorization with priority inference
+ * - Composable section-based document generation
+ * - JSON-configurable generators
+ *
+ * ### When to Use
+ *
+ * - Use when importing the package's public API in client code
+ * - Use for accessing scanner, extractor, and generator modules
+ */
+// ============================================================================
+// Configuration API (Primary Entry Point for External Users)
+// ============================================================================
+/**
+ * Configuration API for creating customized Architect instances.
+ *
+ * @example
+ * ```typescript
+ * import { createArchitect } from '@libar-dev/architect';
+ *
+ * // Use the default libar-generic preset for non-DDD projects
+ * const dp = createArchitect();
+ *
+ * // Or customize the tag prefix
+ * const dp = createArchitect({
+ *   tagPrefix: "@my-project-",
+ *   fileOptInTag: "@my-project"
+ * });
+ * ```
+ */
+export { createArchitect } from './config/factory.js';
+export { createRegexBuilders } from './config/regex-builders.js';
+export { LIBAR_GENERIC_PRESET, DDD_ES_CQRS_PRESET, PRESETS, } from './config/presets.js';
+// Core types (schema-inferred)
+export * from './types/index.js';
+// Scanner functionality
+export * from './scanner/index.js';
+// Extractor functionality
+export * from './extractor/index.js';
+// Validation schemas (for runtime validation)
+export * from './validation-schemas/index.js';
+// ============================================================================
+// NEW: Composable Generators Module (Recommended)
+// ============================================================================
+/**
+ * New section-based generator system.
+ *
+ * Use this for all new code. Provides composable sections, JSON configuration,
+ * and cleaner API design.
+ *
+ * @example
+ * ```typescript
+ * import { generatorRegistry } from '@libar-dev/architect/generators';
+ * import '@libar-dev/architect/generators/built-in';
+ *
+ * const generator = generatorRegistry.get('patterns');
+ * const output = await generator.generate(patterns, context);
+ * ```
+ */
+export * as generators from './generators/index.js';
+// ============================================================================
+// Renderable Document Model (RDM) - Codec-based generation
+// ============================================================================
+/**
+ * RenderableDocument Model for codec-based document generation.
+ *
+ * New architecture that uses Zod 4 codecs to transform MasterDataset into
+ * RenderableDocuments, which are rendered to markdown via a universal renderer.
+ *
+ * @example
+ * ```typescript
+ * import { generateDocument, generateAllDocuments } from '@libar-dev/architect/renderable';
+ *
+ * // Generate a single document type
+ * const files = generateDocument("patterns", masterDataset);
+ *
+ * // Generate all document types
+ * const allFiles = generateAllDocuments(masterDataset);
+ * ```
+ */
+export * as renderable from './renderable/index.js';
+// ============================================================================
+// Lint Module - Pattern & Process Validation
+// ============================================================================
+/**
+ * Lint module for pattern annotation quality and process validation.
+ *
+ * Includes:
+ * - **Rules & Engine**: Pattern annotation quality checking
+ * - **Process Guard**: FSM validation, change detection, protection enforcement
+ *
+ * @example
+ * ```typescript
+ * import { lintFiles, validateChanges } from '@libar-dev/architect/lint';
+ *
+ * // Lint pattern annotations
+ * const result = await lintFiles(['src/**\/*.ts']);
+ *
+ * // Validate process changes (pre-commit)
+ * const validation = validateChanges(input);
+ * if (hasErrors(validation)) {
+ *   console.error('Process violations detected');
+ * }
+ * ```
+ */
+export * as lint from './lint/index.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;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,+EAA+E;AAC/E,6DAA6D;AAC7D,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAA+B,MAAM,qBAAqB,CAAC;AAInF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,OAAO,GAER,MAAM,qBAAqB,CAAC;AAE7B,+BAA+B;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,wBAAwB;AACxB,cAAc,oBAAoB,CAAC;AAEnC,0BAA0B;AAC1B,cAAc,sBAAsB,CAAC;AAErC,8CAA8C;AAC9C,cAAc,+BAA+B,CAAC;AAE9C,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AAEpD,+EAA+E;AAC/E,2DAA2D;AAC3D,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AAEpD,+EAA+E;AAC/E,6CAA6C;AAC7C,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}

package/dist/lint/engine.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @architect
+ * @architect-lint
+ * @architect-pattern LintEngine
+ * @architect-status completed
+ * @architect-uses LintRules, CodecUtils
+ * @architect-used-by LintPatternsCLI
+ * @architect-arch-role service
+ * @architect-arch-context lint
+ * @architect-arch-layer application
+ *
+ * ## LintEngine - Rule Execution Orchestrator
+ *
+ * Orchestrates lint rule execution against parsed directives.
+ * Takes scanned @architect-* directives and runs quality rules against them,
+ * collecting violations and computing summary statistics for CI enforcement.
+ *
+ * ### When to Use
+ *
+ * - Use when validating annotation quality across multiple files
+ * - Use when building CI pipelines for documentation standards
+ * - Use for formatting lint results (pretty or JSON output)
+ */
+import type { DocDirective } from '../validation-schemas/doc-directive.js';
+import type { LintViolation } from '../validation-schemas/lint.js';
+import { type LintContext, type LintRule } from './rules.js';
+import type { Result } from '../types/result.js';
+/**
+ * Lint results for a single file
+ */
+export interface LintResult {
+    /** Source file path */
+    readonly file: string;
+    /** All violations found in this file */
+    readonly violations: readonly LintViolation[];
+}
+/**
+ * Summary statistics for a lint run
+ */
+export interface LintSummary {
+    /** Results per file (only files with violations) */
+    readonly results: readonly LintResult[];
+    /** Total error count */
+    readonly errorCount: number;
+    /** Total warning count */
+    readonly warningCount: number;
+    /** Total info count */
+    readonly infoCount: number;
+    /** Total files scanned */
+    readonly filesScanned: number;
+    /** Total directives checked */
+    readonly directivesChecked: number;
+}
+/**
+ * Input format for directive with location info
+ */
+export interface DirectiveWithLocation {
+    readonly directive: DocDirective;
+    readonly line: number;
+}
+/**
+ * Run lint rules against a single directive
+ *
+ * @param directive - Parsed directive to check
+ * @param file - Source file path
+ * @param line - Line number in source
+ * @param rules - Rules to apply
+ * @param context - Optional context for rules that need pattern registry
+ * @returns Array of violations (empty if all rules pass)
+ */
+export declare function lintDirective(directive: DocDirective, file: string, line: number, rules: readonly LintRule[], context?: LintContext): LintViolation[];
+/**
+ * Run lint rules against multiple files with directives
+ *
+ * @param files - Map of file path to directives in that file
+ * @param rules - Rules to apply
+ * @param context - Optional context for rules that need pattern registry
+ * @returns Summary with results and statistics
+ */
+export declare function lintFiles(files: Map<string, readonly DirectiveWithLocation[]>, rules: readonly LintRule[], context?: LintContext): LintSummary;
+/**
+ * Check if lint summary indicates failure based on mode
+ *
+ * @param summary - Lint summary to check
+ * @param strict - Whether to treat warnings as errors
+ * @returns True if there are failures (exit code should be 1)
+ */
+export declare function hasFailures(summary: LintSummary, strict: boolean): boolean;
+/**
+ * Sort violations by severity (errors first, then warnings, then info)
+ */
+export declare function sortViolationsBySeverity(violations: readonly LintViolation[]): LintViolation[];
+/**
+ * Format lint summary as pretty-printed text
+ *
+ * @param summary - Lint summary to format
+ * @param options - Formatting options
+ * @returns Formatted string for console output
+ */
+export declare function formatPretty(summary: LintSummary, options?: {
+    quiet?: boolean;
+}): string;
+/**
+ * Format lint summary as JSON
+ *
+ * Uses LintOutputCodec for type-safe serialization.
+ * Returns Result type per project guidelines (no exceptions thrown).
+ *
+ * @param summary - Lint summary to format
+ * @returns Result with JSON string on success, Error on serialization failure
+ */
+export declare function formatJson(summary: LintSummary): Result<string>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/lint/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/lint/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAOjD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,wBAAwB;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0BAA0B;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,uBAAuB;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,EAAE,CAgBjB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC,EACpD,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,WAAW,CAgDb;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAQ1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,EAAE,CAO9F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAyC5F;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CA4B/D"}

package/dist/lint/engine.js

@@ -0,0 +1,228 @@
+/**
+ * @architect
+ * @architect-lint
+ * @architect-pattern LintEngine
+ * @architect-status completed
+ * @architect-uses LintRules, CodecUtils
+ * @architect-used-by LintPatternsCLI
+ * @architect-arch-role service
+ * @architect-arch-context lint
+ * @architect-arch-layer application
+ *
+ * ## LintEngine - Rule Execution Orchestrator
+ *
+ * Orchestrates lint rule execution against parsed directives.
+ * Takes scanned @architect-* directives and runs quality rules against them,
+ * collecting violations and computing summary statistics for CI enforcement.
+ *
+ * ### When to Use
+ *
+ * - Use when validating annotation quality across multiple files
+ * - Use when building CI pipelines for documentation standards
+ * - Use for formatting lint results (pretty or JSON output)
+ */
+import { severityOrder } from './rules.js';
+import { createJsonOutputCodec, LintOutputSchema, } from '../validation-schemas/index.js';
+/**
+ * Codec for serializing lint output to JSON
+ */
+const LintOutputCodec = createJsonOutputCodec(LintOutputSchema);
+/**
+ * Run lint rules against a single directive
+ *
+ * @param directive - Parsed directive to check
+ * @param file - Source file path
+ * @param line - Line number in source
+ * @param rules - Rules to apply
+ * @param context - Optional context for rules that need pattern registry
+ * @returns Array of violations (empty if all rules pass)
+ */
+export function lintDirective(directive, file, line, rules, context) {
+    const violations = [];
+    for (const rule of rules) {
+        const result = rule.check(directive, file, line, context);
+        if (result !== null) {
+            // Handle both single violation and array of violations
+            if (Array.isArray(result)) {
+                violations.push(...result);
+            }
+            else {
+                violations.push(result);
+            }
+        }
+    }
+    return violations;
+}
+/**
+ * Run lint rules against multiple files with directives
+ *
+ * @param files - Map of file path to directives in that file
+ * @param rules - Rules to apply
+ * @param context - Optional context for rules that need pattern registry
+ * @returns Summary with results and statistics
+ */
+export function lintFiles(files, rules, context) {
+    const results = [];
+    let errorCount = 0;
+    let warningCount = 0;
+    let infoCount = 0;
+    let directivesChecked = 0;
+    for (const [file, directives] of files) {
+        const fileViolations = [];
+        for (const { directive, line } of directives) {
+            directivesChecked++;
+            const violations = lintDirective(directive, file, line, rules, context);
+            fileViolations.push(...violations);
+        }
+        // Count by severity
+        for (const violation of fileViolations) {
+            switch (violation.severity) {
+                case 'error':
+                    errorCount++;
+                    break;
+                case 'warning':
+                    warningCount++;
+                    break;
+                case 'info':
+                    infoCount++;
+                    break;
+            }
+        }
+        // Only include files with violations
+        if (fileViolations.length > 0) {
+            results.push({
+                file,
+                violations: fileViolations,
+            });
+        }
+    }
+    return {
+        results,
+        errorCount,
+        warningCount,
+        infoCount,
+        filesScanned: files.size,
+        directivesChecked,
+    };
+}
+/**
+ * Check if lint summary indicates failure based on mode
+ *
+ * @param summary - Lint summary to check
+ * @param strict - Whether to treat warnings as errors
+ * @returns True if there are failures (exit code should be 1)
+ */
+export function hasFailures(summary, strict) {
+    if (summary.errorCount > 0) {
+        return true;
+    }
+    if (strict && summary.warningCount > 0) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Sort violations by severity (errors first, then warnings, then info)
+ */
+export function sortViolationsBySeverity(violations) {
+    return [...violations].sort((a, b) => {
+        const severityDiff = severityOrder[a.severity] - severityOrder[b.severity];
+        if (severityDiff !== 0)
+            return severityDiff;
+        // Within same severity, sort by line number
+        return a.line - b.line;
+    });
+}
+/**
+ * Format lint summary as pretty-printed text
+ *
+ * @param summary - Lint summary to format
+ * @param options - Formatting options
+ * @returns Formatted string for console output
+ */
+export function formatPretty(summary, options = {}) {
+    const lines = [];
+    for (const result of summary.results) {
+        const sorted = sortViolationsBySeverity(result.violations);
+        // Filter based on quiet mode
+        const filtered = options.quiet === true ? sorted.filter((v) => v.severity === 'error') : sorted;
+        if (filtered.length === 0)
+            continue;
+        lines.push(result.file);
+        for (const v of filtered) {
+            const severityColor = getSeverityPrefix(v.severity);
+            lines.push(`  ${v.line}:1  ${severityColor}  ${v.rule}  ${v.message}`);
+        }
+        lines.push(''); // Blank line between files
+    }
+    // Summary line
+    const parts = [];
+    if (summary.errorCount > 0) {
+        parts.push(`${summary.errorCount} error${summary.errorCount === 1 ? '' : 's'}`);
+    }
+    if (summary.warningCount > 0 && options.quiet !== true) {
+        parts.push(`${summary.warningCount} warning${summary.warningCount === 1 ? '' : 's'}`);
+    }
+    if (summary.infoCount > 0 && options.quiet !== true) {
+        parts.push(`${summary.infoCount} info`);
+    }
+    if (parts.length > 0) {
+        const icon = summary.errorCount > 0 ? '\u2717' : summary.warningCount > 0 ? '\u26a0' : '\u2713';
+        lines.push(`${icon} ${parts.join(', ')}`);
+    }
+    else {
+        lines.push(`\u2713 No issues found (${summary.directivesChecked} directives checked)`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Get severity prefix for output
+ */
+function getSeverityPrefix(severity) {
+    switch (severity) {
+        case 'error':
+            return 'error  ';
+        case 'warning':
+            return 'warning';
+        case 'info':
+            return 'info   ';
+    }
+}
+/**
+ * Format lint summary as JSON
+ *
+ * Uses LintOutputCodec for type-safe serialization.
+ * Returns Result type per project guidelines (no exceptions thrown).
+ *
+ * @param summary - Lint summary to format
+ * @returns Result with JSON string on success, Error on serialization failure
+ */
+export function formatJson(summary) {
+    const output = {
+        results: summary.results.map((r) => ({
+            file: r.file,
+            violations: r.violations.map((v) => ({
+                rule: v.rule,
+                severity: v.severity,
+                message: v.message,
+                line: v.line,
+            })),
+        })),
+        summary: {
+            errors: summary.errorCount,
+            warnings: summary.warningCount,
+            info: summary.infoCount,
+            filesScanned: summary.filesScanned,
+            directivesChecked: summary.directivesChecked,
+        },
+    };
+    const result = LintOutputCodec.serialize(output);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: new Error(`Lint output serialization failed: ${result.error.message}`),
+        };
+    }
+    return { ok: true, value: result.value };
+}
+//# sourceMappingURL=engine.js.map

package/dist/lint/engine.js.map

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