@eddacraft/anvil-runtime 0.1.0

package/dist/export/constraint-collector.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Constraint Collector
+ *
+ * Aggregates constraints from architecture baselines, anti-pattern catalogues,
+ * and project configuration into a single exportable data structure.
+ *
+ * This module provides the foundation for exporting constraints in various
+ * formats (llms.txt, MCP resources, prompt fragments) for AI tool consumption.
+ *
+ * @module export/constraint-collector
+ */
+/**
+ * Architecture boundary constraint
+ */
+export interface BoundaryConstraint {
+    /** Human-readable name */
+    name: string;
+    /** Source layer */
+    from: string;
+    /** Target layer */
+    to: string;
+    /** Violation message */
+    message: string;
+    /** Severity level */
+    severity: 'error' | 'warning' | 'info';
+}
+/**
+ * Layer definition constraint
+ */
+export interface LayerConstraint {
+    /** Layer name */
+    name: string;
+    /** Glob patterns matching files in this layer */
+    patterns: string[];
+    /** Layers this layer can depend on */
+    dependsOn: string[];
+    /** Human-readable description */
+    description?: string;
+}
+/**
+ * Anti-pattern constraint
+ */
+export interface AntiPatternConstraint {
+    /** Pattern ID (e.g., AP-001) */
+    id: string;
+    /** Pattern name */
+    name: string;
+    /** Pattern category */
+    category: string;
+    /** Why this pattern is problematic */
+    explanation: string;
+    /** What to do instead */
+    suggestion: string;
+    /** Default severity */
+    severity: 'error' | 'warning' | 'info';
+    /** Whether enabled by default */
+    enabled: boolean;
+}
+/**
+ * Project convention constraint
+ */
+export interface ConventionConstraint {
+    /** Convention category */
+    category: string;
+    /** Human-readable description */
+    description: string;
+    /** Examples */
+    examples?: string[];
+}
+/**
+ * Active suppression policy constraint
+ */
+export interface SuppressionConstraint {
+    /** Pattern ID being suppressed (e.g., AP-001) */
+    patternId: string;
+    /** Relative file path */
+    file: string;
+    /** Suppression scope */
+    scope: string;
+    /** Human-provided reason */
+    reason: string;
+    /** Expiry date (ISO) for time-boxed suppressions */
+    expiresAt?: string;
+}
+/**
+ * Aggregated constraints from all sources
+ */
+export interface Constraints {
+    /** Architecture boundaries */
+    boundaries: BoundaryConstraint[];
+    /** Layer definitions */
+    layers: LayerConstraint[];
+    /** Anti-pattern rules */
+    antiPatterns: AntiPatternConstraint[];
+    /** Project conventions */
+    conventions: ConventionConstraint[];
+    /** Active suppression policies */
+    suppressions: SuppressionConstraint[];
+    /** Metadata */
+    metadata: {
+        /** When constraints were collected */
+        collectedAt: string;
+        /** Workspace root */
+        workspaceRoot: string;
+        /** Whether architecture baseline exists */
+        hasBaseline: boolean;
+    };
+}
+/**
+ * Configuration for constraint collection
+ */
+export interface ConstraintCollectorConfig {
+    /** Workspace root directory */
+    workspaceRoot: string;
+    /** Include opt-in anti-patterns */
+    includeOptInPatterns?: boolean;
+    /** Include disabled patterns */
+    includeDisabledPatterns?: boolean;
+}
+/**
+ * Collects and aggregates constraints from various sources
+ */
+export declare class ConstraintCollector {
+    private readonly config;
+    constructor(config: ConstraintCollectorConfig);
+    /**
+     * Collect all constraints
+     */
+    collect(): Promise<Constraints>;
+    /**
+     * Collect architecture boundaries
+     */
+    private collectBoundaries;
+    /**
+     * Collect layer definitions
+     */
+    private collectLayers;
+    /**
+     * Collect anti-pattern rules
+     */
+    private collectAntiPatterns;
+    /**
+     * Collect active suppression policies from the suppression store
+     */
+    private collectSuppressions;
+    /**
+     * Collect project conventions
+     *
+     * These are static conventions for the Anvil project itself.
+     * In a more generic system, these could be loaded from configuration.
+     */
+    private collectConventions;
+}
+/**
+ * Collect constraints with default configuration
+ *
+ * @param workspaceRoot - Workspace root directory
+ * @returns Aggregated constraints
+ */
+export declare function collectConstraints(workspaceRoot: string): Promise<Constraints>;
+/**
+ * Check if any constraints exist
+ *
+ * @param constraints - Constraints to check
+ * @returns true if any constraints exist
+ */
+export declare function hasAnyConstraints(constraints: Constraints): boolean;
+/**
+ * Count total constraints
+ *
+ * @param constraints - Constraints to count
+ * @returns Total number of constraints
+ */
+export declare function countConstraints(constraints: Constraints): number;
+//# sourceMappingURL=constraint-collector.d.ts.map

package/dist/export/constraint-collector.d.ts.map

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

package/dist/export/constraint-collector.js

@@ -0,0 +1,203 @@
+/**
+ * Constraint Collector
+ *
+ * Aggregates constraints from architecture baselines, anti-pattern catalogues,
+ * and project configuration into a single exportable data structure.
+ *
+ * This module provides the foundation for exporting constraints in various
+ * formats (llms.txt, MCP resources, prompt fragments) for AI tool consumption.
+ *
+ * @module export/constraint-collector
+ */
+import { PATTERNS } from '@eddacraft/anvil-core/antipattern';
+import { loadBaseline } from '@eddacraft/anvil-core/architecture';
+import { SuppressionStore } from '@eddacraft/anvil-core/suppression';
+import { join } from 'node:path';
+/**
+ * Collects and aggregates constraints from various sources
+ */
+export class ConstraintCollector {
+    config;
+    constructor(config) {
+        this.config = {
+            includeOptInPatterns: false,
+            includeDisabledPatterns: false,
+            ...config,
+        };
+    }
+    /**
+     * Collect all constraints
+     */
+    async collect() {
+        const baseline = loadBaseline(this.config.workspaceRoot);
+        const hasBaseline = baseline !== null;
+        return {
+            boundaries: this.collectBoundaries(baseline),
+            layers: this.collectLayers(baseline),
+            antiPatterns: this.collectAntiPatterns(),
+            conventions: this.collectConventions(),
+            suppressions: await this.collectSuppressions(),
+            metadata: {
+                collectedAt: new Date().toISOString(),
+                workspaceRoot: this.config.workspaceRoot,
+                hasBaseline,
+            },
+        };
+    }
+    /**
+     * Collect architecture boundaries
+     */
+    collectBoundaries(baseline) {
+        if (!baseline) {
+            return [];
+        }
+        return baseline.boundaries.map((boundary) => ({
+            name: boundary.name,
+            from: boundary.from,
+            to: boundary.to,
+            message: boundary.message,
+            severity: boundary.severity,
+        }));
+    }
+    /**
+     * Collect layer definitions
+     */
+    collectLayers(baseline) {
+        if (!baseline) {
+            return [];
+        }
+        return Object.entries(baseline.layers).map(([name, layer]) => ({
+            name,
+            patterns: layer.patterns,
+            dependsOn: layer.depends_on,
+            description: layer.description,
+        }));
+    }
+    /**
+     * Collect anti-pattern rules
+     */
+    collectAntiPatterns() {
+        let patterns = PATTERNS.slice();
+        // Filter based on configuration
+        if (!this.config.includeDisabledPatterns) {
+            patterns = patterns.filter((p) => p.enabled);
+        }
+        if (!this.config.includeOptInPatterns) {
+            patterns = patterns.filter((p) => !p.optIn);
+        }
+        return patterns.map((pattern) => ({
+            id: pattern.id,
+            name: pattern.name,
+            category: pattern.category,
+            explanation: pattern.explanation,
+            suggestion: pattern.suggestion,
+            severity: pattern.severity,
+            enabled: pattern.enabled,
+        }));
+    }
+    /**
+     * Collect active suppression policies from the suppression store
+     */
+    async collectSuppressions() {
+        try {
+            const anvilDir = join(this.config.workspaceRoot, '.anvil');
+            const store = new SuppressionStore(anvilDir);
+            await store.load();
+            const now = new Date();
+            const all = store.getAll();
+            // Filter out expired suppressions
+            const active = all.filter((record) => {
+                if (!record.expires_at)
+                    return true;
+                return new Date(record.expires_at) >= now;
+            });
+            return active.map((record) => ({
+                patternId: record.pattern_id,
+                file: record.file,
+                scope: record.scope,
+                reason: record.reason,
+                expiresAt: record.expires_at,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Collect project conventions
+     *
+     * These are static conventions for the Anvil project itself.
+     * In a more generic system, these could be loaded from configuration.
+     */
+    collectConventions() {
+        return [
+            {
+                category: 'spelling',
+                description: 'Use UK English spelling',
+                examples: ['organised (not organized)', 'behaviour (not behavior)', 'colour (not color)'],
+            },
+            {
+                category: 'imports',
+                description: 'ESM imports require .js extensions',
+                examples: ["import { foo } from './bar.js'", "NOT: import { foo } from './bar'"],
+            },
+            {
+                category: 'schemas',
+                description: 'Zod schemas as source of truth for types',
+                examples: [
+                    'export const FooSchema = z.object({ ... })',
+                    'export type Foo = z.infer<typeof FooSchema>',
+                ],
+            },
+            {
+                category: 'naming',
+                description: 'Kebab-case for file names',
+                examples: ['gate-runner.ts', 'format-detection.ts'],
+            },
+            {
+                category: 'type-safety',
+                description: 'No type assertions without runtime validation',
+                examples: ['Use Zod parse, not "as" casts', 'Avoid @ts-ignore and @ts-expect-error'],
+            },
+        ];
+    }
+}
+// =============================================================================
+// Convenience Functions
+// =============================================================================
+/**
+ * Collect constraints with default configuration
+ *
+ * @param workspaceRoot - Workspace root directory
+ * @returns Aggregated constraints
+ */
+export async function collectConstraints(workspaceRoot) {
+    const collector = new ConstraintCollector({ workspaceRoot });
+    return collector.collect();
+}
+/**
+ * Check if any constraints exist
+ *
+ * @param constraints - Constraints to check
+ * @returns true if any constraints exist
+ */
+export function hasAnyConstraints(constraints) {
+    return (constraints.boundaries.length > 0 ||
+        constraints.layers.length > 0 ||
+        constraints.antiPatterns.length > 0 ||
+        constraints.conventions.length > 0 ||
+        constraints.suppressions.length > 0);
+}
+/**
+ * Count total constraints
+ *
+ * @param constraints - Constraints to count
+ * @returns Total number of constraints
+ */
+export function countConstraints(constraints) {
+    return (constraints.boundaries.length +
+        constraints.layers.length +
+        constraints.antiPatterns.length +
+        constraints.conventions.length +
+        constraints.suppressions.length);
+}

package/dist/export/formatters/llms-txt-formatter.d.ts

@@ -0,0 +1,89 @@
+/**
+ * llms.txt Formatter
+ *
+ * Formats Anvil constraints as llms.txt markdown for AI tool consumption.
+ *
+ * llms.txt is an emerging community standard for providing AI-readable
+ * documentation and constraints. See: https://mintlify.com/blog/simplifying-docs-with-llms-txt
+ *
+ * @module export/formatters/llms-txt-formatter
+ */
+import type { Constraints } from '../constraint-collector.js';
+/**
+ * Configuration for llms.txt formatting
+ */
+export interface LlmsTxtFormatterOptions {
+    /** Include metadata header */
+    includeMetadata?: boolean;
+    /** Include architecture boundaries section */
+    includeBoundaries?: boolean;
+    /** Include anti-patterns section */
+    includeAntiPatterns?: boolean;
+    /** Include conventions section */
+    includeConventions?: boolean;
+    /** Include layer definitions section */
+    includeLayers?: boolean;
+    /** Include active suppressions section */
+    includeSuppressions?: boolean;
+}
+/**
+ * Formats constraints as llms.txt markdown
+ */
+export declare class LlmsTxtFormatter {
+    private readonly options;
+    constructor(options?: LlmsTxtFormatterOptions);
+    /**
+     * Format constraints as llms.txt markdown
+     *
+     * @param constraints - Constraints to format
+     * @returns llms.txt markdown string
+     */
+    format(constraints: Constraints): string;
+    /**
+     * Format metadata section
+     */
+    private formatMetadata;
+    /**
+     * Format architecture boundaries section
+     */
+    private formatBoundaries;
+    /**
+     * Format layer definitions section
+     */
+    private formatLayers;
+    /**
+     * Format anti-patterns section
+     */
+    private formatAntiPatterns;
+    /**
+     * Format conventions section
+     */
+    private formatConventions;
+    /**
+     * Format active suppressions section
+     */
+    private formatSuppressions;
+    /**
+     * Get emoji for severity level
+     */
+    private getSeverityEmoji;
+    /**
+     * Format category name for display
+     */
+    private formatCategoryName;
+}
+/**
+ * Format constraints as llms.txt with default options
+ *
+ * @param constraints - Constraints to format
+ * @returns llms.txt markdown string
+ */
+export declare function formatAsLlmsTxt(constraints: Constraints): string;
+/**
+ * Format constraints as llms.txt without metadata
+ *
+ * @param constraints - Constraints to format
+ * @returns llms.txt markdown string
+ */
+export declare function formatAsLlmsTxtWithoutMetadata(constraints: Constraints): string;
+//# sourceMappingURL=llms-txt-formatter.d.ts.map

package/dist/export/formatters/llms-txt-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt-formatter.d.ts","sourceRoot":"","sources":["../../../src/export/formatters/llms-txt-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8BAA8B;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oCAAoC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wCAAwC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAMD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;gBAEhD,OAAO,GAAE,uBAA4B;IAYjD;;;;;OAKG;IACH,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM;IAuCxC;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmCpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiC1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqC1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAM3B;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAGhE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAG/E"}