@eddacraft/anvil-core 0.1.0

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACL,YAAY,EACZ,SAAS,EACT,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,eAAe,EACpB,sBAAsB,EACtB,eAAe,EACf,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,13 @@
+/**
+ * Validation Module Public API
+ *
+ * Exports validation utilities for APS plans.
+ */
+import { generateHash } from '../crypto/index.js';
+import { validator as defaultValidator } from './aps-validator.js';
+// Main validator
+export { APSValidator, validator, validateAPSPlan, } from './aps-validator.js';
+// Error types and formatters
+export { ValidationError, SchemaValidationError, HashValidationError, formatValidationErrors, formatZodErrors, createValidationSummary, } from './errors.js';
+// Initialize the validator with the hash function
+defaultValidator.setHashValidator(generateHash);

package/dist/warnings/index.d.ts

@@ -0,0 +1,2 @@
+export { WARNING_ID_PATTERN, ParsedWarningIdSchema, type ParsedWarningId, generateWarningId, createWarningId, parseWarningId, isValidWarningId, findWarningById, findWarningsByRule, findWarningsByFile, indexWarningsById, getWarningIds, generateShortId, resolveShortId, } from './warning-id.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/warnings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/warnings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,eAAe,EACpB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/warnings/index.js

@@ -0,0 +1 @@
+export { WARNING_ID_PATTERN, ParsedWarningIdSchema, generateWarningId, createWarningId, parseWarningId, isValidWarningId, findWarningById, findWarningsByRule, findWarningsByFile, indexWarningsById, getWarningIds, generateShortId, resolveShortId, } from './warning-id.js';

package/dist/warnings/warning-id.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Warning ID System
+ *
+ * Provides unique, stable warning identifiers for the explain command.
+ * Warning IDs encode the rule, file, and line number to enable precise lookup.
+ *
+ * Format: {rule}-{file}:{line}
+ * Example: AP-003-src/utils/helpers.ts:42
+ *
+ * @module warnings/warning-id
+ */
+import { z } from 'zod';
+import type { Warning } from '../antipattern/types.js';
+/**
+ * Pattern for valid warning IDs
+ * Format: {RULE}-{FILE}:{LINE}
+ * Examples:
+ * - AP-003-src/utils/helpers.ts:42
+ * - ARCH-001-src/api/handler.ts:15
+ * - BOUND-001-src/db/queries.ts:100
+ */
+export declare const WARNING_ID_PATTERN: RegExp;
+/**
+ * Schema for parsed warning ID components
+ */
+export declare const ParsedWarningIdSchema: z.ZodObject<{
+    rule: z.ZodString;
+    file: z.ZodString;
+    line: z.ZodNumber;
+}, z.core.$strip>;
+export type ParsedWarningId = z.infer<typeof ParsedWarningIdSchema>;
+/**
+ * Generate a unique warning ID from a warning object
+ *
+ * The ID format is: {rule}-{file}:{line}
+ * This ensures uniqueness per warning instance while remaining human-readable.
+ *
+ * @param warning - The warning object
+ * @returns A unique warning ID string
+ *
+ * @example
+ * ```ts
+ * const warning = {
+ *   id: 'AP-003',
+ *   location: { file: 'src/utils/helpers.ts', line: 42 }
+ * };
+ * const warningId = generateWarningId(warning);
+ * // Returns: 'AP-003-src/utils/helpers.ts:42'
+ * ```
+ */
+export declare function generateWarningId(warning: Pick<Warning, 'id' | 'location'>): string;
+/**
+ * Generate a warning ID from components
+ *
+ * @param rule - The rule ID (e.g., 'AP-003', 'ARCH-001')
+ * @param file - File path relative to workspace root
+ * @param line - Line number (1-based)
+ * @returns A unique warning ID string
+ *
+ * @example
+ * ```ts
+ * const warningId = createWarningId('AP-003', 'src/utils/helpers.ts', 42);
+ * // Returns: 'AP-003-src/utils/helpers.ts:42'
+ * ```
+ */
+export declare function createWarningId(rule: string, file: string, line: number): string;
+/**
+ * Parse a warning ID into its components
+ *
+ * @param warningId - The warning ID to parse
+ * @returns Parsed components (rule, file, line) or null if invalid
+ *
+ * @example
+ * ```ts
+ * const parsed = parseWarningId('AP-003-src/utils/helpers.ts:42');
+ * // Returns: { rule: 'AP-003', file: 'src/utils/helpers.ts', line: 42 }
+ *
+ * const invalid = parseWarningId('invalid-id');
+ * // Returns: null
+ * ```
+ */
+export declare function parseWarningId(warningId: string): ParsedWarningId | null;
+/**
+ * Validate a warning ID string
+ *
+ * @param warningId - The warning ID to validate
+ * @returns true if the ID is valid, false otherwise
+ *
+ * @example
+ * ```ts
+ * isValidWarningId('AP-003-src/utils/helpers.ts:42'); // true
+ * isValidWarningId('invalid'); // false
+ * isValidWarningId('AP-003'); // false (missing file:line)
+ * ```
+ */
+export declare function isValidWarningId(warningId: string): boolean;
+/**
+ * Find a warning in a list by its warning ID
+ *
+ * @param warnings - Array of warnings to search
+ * @param warningId - The warning ID to find
+ * @returns The matching warning or undefined
+ *
+ * @example
+ * ```ts
+ * const warnings = [...]; // From check results
+ * const warning = findWarningById(warnings, 'AP-003-src/utils/helpers.ts:42');
+ * if (warning) {
+ *   console.log(warning.message);
+ * }
+ * ```
+ */
+export declare function findWarningById(warnings: Warning[], warningId: string): Warning | undefined;
+/**
+ * Find all warnings matching a rule ID (partial match)
+ *
+ * @param warnings - Array of warnings to search
+ * @param ruleId - The rule ID to match (e.g., 'AP-003')
+ * @returns Array of matching warnings
+ *
+ * @example
+ * ```ts
+ * const warnings = [...]; // From check results
+ * const anyWarnings = findWarningsByRule(warnings, 'AP-003');
+ * console.log(`Found ${anyWarnings.length} explicit any types`);
+ * ```
+ */
+export declare function findWarningsByRule(warnings: Warning[], ruleId: string): Warning[];
+/**
+ * Find all warnings in a specific file
+ *
+ * @param warnings - Array of warnings to search
+ * @param file - File path to match
+ * @returns Array of matching warnings
+ */
+export declare function findWarningsByFile(warnings: Warning[], file: string): Warning[];
+/**
+ * Generate warning IDs for all warnings in a list
+ *
+ * @param warnings - Array of warnings
+ * @returns Map of warning ID to warning
+ *
+ * @example
+ * ```ts
+ * const warnings = [...]; // From check results
+ * const warningMap = indexWarningsById(warnings);
+ *
+ * // Quick lookup by ID
+ * const warning = warningMap.get('AP-003-src/utils/helpers.ts:42');
+ * ```
+ */
+export declare function indexWarningsById(warnings: Warning[]): Map<string, Warning>;
+/**
+ * Get all warning IDs from a list of warnings
+ *
+ * @param warnings - Array of warnings
+ * @returns Array of warning IDs
+ */
+export declare function getWarningIds(warnings: Warning[]): string[];
+/**
+ * Generate a short ID for display purposes
+ *
+ * Useful when the full warning ID is too long for terminal display.
+ * Format: {rule}:{line} (e.g., AP-003:42)
+ *
+ * @param warning - The warning object
+ * @returns A shortened warning ID
+ */
+export declare function generateShortId(warning: Pick<Warning, 'id' | 'location'>): string;
+/**
+ * Attempt to resolve a short ID to a full warning ID
+ *
+ * Searches warnings by rule and line, returns full ID if unique match found.
+ *
+ * @param warnings - Array of warnings to search
+ * @param shortId - Short ID in format RULE:LINE (e.g., 'AP-003:42')
+ * @returns Full warning ID, array of matches if ambiguous, or null if not found
+ */
+export declare function resolveShortId(warnings: Warning[], shortId: string): string | string[] | null;
+//# sourceMappingURL=warning-id.d.ts.map

package/dist/warnings/warning-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning-id.d.ts","sourceRoot":"","sources":["../../src/warnings/warning-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAMvD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAsC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;iBAOhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,UAAU,CAAC,GAAG,MAAM,CAGnF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhF;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAmBxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAU3F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAEjF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAE/E;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAO3E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAE3D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,UAAU,CAAC,GAAG,MAAM,CAEjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAqB7F"}

package/dist/warnings/warning-id.js

@@ -0,0 +1,257 @@
+/**
+ * Warning ID System
+ *
+ * Provides unique, stable warning identifiers for the explain command.
+ * Warning IDs encode the rule, file, and line number to enable precise lookup.
+ *
+ * Format: {rule}-{file}:{line}
+ * Example: AP-003-src/utils/helpers.ts:42
+ *
+ * @module warnings/warning-id
+ */
+import { z } from 'zod';
+// =============================================================================
+// Warning ID Schema
+// =============================================================================
+/**
+ * Pattern for valid warning IDs
+ * Format: {RULE}-{FILE}:{LINE}
+ * Examples:
+ * - AP-003-src/utils/helpers.ts:42
+ * - ARCH-001-src/api/handler.ts:15
+ * - BOUND-001-src/db/queries.ts:100
+ */
+export const WARNING_ID_PATTERN = /^(AP|ARCH|BOUND)-\d{3}-[^:]+:\d+$/;
+/**
+ * Schema for parsed warning ID components
+ */
+export const ParsedWarningIdSchema = z.object({
+    rule: z
+        .string()
+        .regex(/^(AP|ARCH|BOUND)-\d{3}$/)
+        .describe('The rule ID (e.g., AP-003, ARCH-001)'),
+    file: z.string().min(1).describe('File path relative to workspace root'),
+    line: z.number().int().positive().describe('Line number (1-based)'),
+});
+// =============================================================================
+// Warning ID Generation
+// =============================================================================
+/**
+ * Generate a unique warning ID from a warning object
+ *
+ * The ID format is: {rule}-{file}:{line}
+ * This ensures uniqueness per warning instance while remaining human-readable.
+ *
+ * @param warning - The warning object
+ * @returns A unique warning ID string
+ *
+ * @example
+ * ```ts
+ * const warning = {
+ *   id: 'AP-003',
+ *   location: { file: 'src/utils/helpers.ts', line: 42 }
+ * };
+ * const warningId = generateWarningId(warning);
+ * // Returns: 'AP-003-src/utils/helpers.ts:42'
+ * ```
+ */
+export function generateWarningId(warning) {
+    const { id, location } = warning;
+    return `${id}-${location.file}:${location.line}`;
+}
+/**
+ * Generate a warning ID from components
+ *
+ * @param rule - The rule ID (e.g., 'AP-003', 'ARCH-001')
+ * @param file - File path relative to workspace root
+ * @param line - Line number (1-based)
+ * @returns A unique warning ID string
+ *
+ * @example
+ * ```ts
+ * const warningId = createWarningId('AP-003', 'src/utils/helpers.ts', 42);
+ * // Returns: 'AP-003-src/utils/helpers.ts:42'
+ * ```
+ */
+export function createWarningId(rule, file, line) {
+    return `${rule}-${file}:${line}`;
+}
+// =============================================================================
+// Warning ID Parsing
+// =============================================================================
+/**
+ * Parse a warning ID into its components
+ *
+ * @param warningId - The warning ID to parse
+ * @returns Parsed components (rule, file, line) or null if invalid
+ *
+ * @example
+ * ```ts
+ * const parsed = parseWarningId('AP-003-src/utils/helpers.ts:42');
+ * // Returns: { rule: 'AP-003', file: 'src/utils/helpers.ts', line: 42 }
+ *
+ * const invalid = parseWarningId('invalid-id');
+ * // Returns: null
+ * ```
+ */
+export function parseWarningId(warningId) {
+    // Match the pattern: RULE-FILE:LINE
+    // RULE is like AP-003 or ARCH-001 (letters-digits)
+    // FILE can contain any characters except :
+    // LINE is a positive integer
+    const match = warningId.match(/^((?:AP|ARCH|BOUND)-\d{3})-(.+):(\d+)$/);
+    if (!match) {
+        return null;
+    }
+    const [, rule, file, lineStr] = match;
+    const line = parseInt(lineStr, 10);
+    if (isNaN(line) || line <= 0) {
+        return null;
+    }
+    return { rule, file, line };
+}
+/**
+ * Validate a warning ID string
+ *
+ * @param warningId - The warning ID to validate
+ * @returns true if the ID is valid, false otherwise
+ *
+ * @example
+ * ```ts
+ * isValidWarningId('AP-003-src/utils/helpers.ts:42'); // true
+ * isValidWarningId('invalid'); // false
+ * isValidWarningId('AP-003'); // false (missing file:line)
+ * ```
+ */
+export function isValidWarningId(warningId) {
+    return parseWarningId(warningId) !== null;
+}
+// =============================================================================
+// Warning Lookup
+// =============================================================================
+/**
+ * Find a warning in a list by its warning ID
+ *
+ * @param warnings - Array of warnings to search
+ * @param warningId - The warning ID to find
+ * @returns The matching warning or undefined
+ *
+ * @example
+ * ```ts
+ * const warnings = [...]; // From check results
+ * const warning = findWarningById(warnings, 'AP-003-src/utils/helpers.ts:42');
+ * if (warning) {
+ *   console.log(warning.message);
+ * }
+ * ```
+ */
+export function findWarningById(warnings, warningId) {
+    const parsed = parseWarningId(warningId);
+    if (!parsed) {
+        return undefined;
+    }
+    return warnings.find((w) => w.id === parsed.rule && w.location.file === parsed.file && w.location.line === parsed.line);
+}
+/**
+ * Find all warnings matching a rule ID (partial match)
+ *
+ * @param warnings - Array of warnings to search
+ * @param ruleId - The rule ID to match (e.g., 'AP-003')
+ * @returns Array of matching warnings
+ *
+ * @example
+ * ```ts
+ * const warnings = [...]; // From check results
+ * const anyWarnings = findWarningsByRule(warnings, 'AP-003');
+ * console.log(`Found ${anyWarnings.length} explicit any types`);
+ * ```
+ */
+export function findWarningsByRule(warnings, ruleId) {
+    return warnings.filter((w) => w.id === ruleId);
+}
+/**
+ * Find all warnings in a specific file
+ *
+ * @param warnings - Array of warnings to search
+ * @param file - File path to match
+ * @returns Array of matching warnings
+ */
+export function findWarningsByFile(warnings, file) {
+    return warnings.filter((w) => w.location.file === file);
+}
+// =============================================================================
+// Warning ID Collection
+// =============================================================================
+/**
+ * Generate warning IDs for all warnings in a list
+ *
+ * @param warnings - Array of warnings
+ * @returns Map of warning ID to warning
+ *
+ * @example
+ * ```ts
+ * const warnings = [...]; // From check results
+ * const warningMap = indexWarningsById(warnings);
+ *
+ * // Quick lookup by ID
+ * const warning = warningMap.get('AP-003-src/utils/helpers.ts:42');
+ * ```
+ */
+export function indexWarningsById(warnings) {
+    const map = new Map();
+    for (const warning of warnings) {
+        const id = generateWarningId(warning);
+        map.set(id, warning);
+    }
+    return map;
+}
+/**
+ * Get all warning IDs from a list of warnings
+ *
+ * @param warnings - Array of warnings
+ * @returns Array of warning IDs
+ */
+export function getWarningIds(warnings) {
+    return warnings.map(generateWarningId);
+}
+// =============================================================================
+// Short ID Support
+// =============================================================================
+/**
+ * Generate a short ID for display purposes
+ *
+ * Useful when the full warning ID is too long for terminal display.
+ * Format: {rule}:{line} (e.g., AP-003:42)
+ *
+ * @param warning - The warning object
+ * @returns A shortened warning ID
+ */
+export function generateShortId(warning) {
+    return `${warning.id}:${warning.location.line}`;
+}
+/**
+ * Attempt to resolve a short ID to a full warning ID
+ *
+ * Searches warnings by rule and line, returns full ID if unique match found.
+ *
+ * @param warnings - Array of warnings to search
+ * @param shortId - Short ID in format RULE:LINE (e.g., 'AP-003:42')
+ * @returns Full warning ID, array of matches if ambiguous, or null if not found
+ */
+export function resolveShortId(warnings, shortId) {
+    const match = shortId.match(/^((?:AP|ARCH|BOUND)-\d{3}):(\d+)$/);
+    if (!match) {
+        return null;
+    }
+    const [, rule, lineStr] = match;
+    const line = parseInt(lineStr, 10);
+    const matches = warnings.filter((w) => w.id === rule && w.location.line === line);
+    if (matches.length === 0) {
+        return null;
+    }
+    if (matches.length === 1) {
+        return generateWarningId(matches[0]);
+    }
+    // Multiple matches - return all full IDs for disambiguation
+    return matches.map(generateWarningId);
+}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@eddacraft/anvil-core",
+  "version": "0.1.0",
+  "description": "Core domain logic for Anvil — schemas, types, analysis, and validation",
+  "license": "PROPRIETARY",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./antipattern": {
+      "types": "./dist/antipattern/index.d.ts",
+      "import": "./dist/antipattern/index.js"
+    },
+    "./suppression": {
+      "types": "./dist/suppression/index.d.ts",
+      "import": "./dist/suppression/index.js"
+    },
+    "./architecture": {
+      "types": "./dist/architecture/index.d.ts",
+      "import": "./dist/architecture/index.js"
+    },
+    "./drift": {
+      "types": "./dist/drift/index.d.ts",
+      "import": "./dist/drift/index.js"
+    },
+    "./validation": {
+      "types": "./dist/validation/index.d.ts",
+      "import": "./dist/validation/index.js"
+    },
+    "./warnings": {
+      "types": "./dist/warnings/index.d.ts",
+      "import": "./dist/warnings/index.js"
+    },
+    "./explain": {
+      "types": "./dist/explain/index.d.ts",
+      "import": "./dist/explain/index.js"
+    },
+    "./provenance": {
+      "types": "./dist/provenance/index.d.ts",
+      "import": "./dist/provenance/index.js"
+    },
+    "./crypto": {
+      "types": "./dist/crypto/index.d.ts",
+      "import": "./dist/crypto/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js"
+    }
+  },
+  "dependencies": {
+    "json-schema": "^0.4.0",
+    "minimatch": "^10.2.0",
+    "yaml": "^2.8.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.18"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "anvil",
+    "core",
+    "domain"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.lib.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}