@organon-methodology/testing 0.3.0

package/dist/core/resolvers/parallel-reader.js

@@ -0,0 +1,56 @@
+/**
+ * Parallel reader — batched file reading with concurrency control.
+ *
+ * Provides a shared utility for reading multiple files in parallel
+ * using Promise.allSettled with a configurable concurrency limit
+ * to avoid file descriptor exhaustion.
+ *
+ * Used by file-resolver.ts and other resolvers for efficient I/O.
+ */
+/**
+ * Default concurrency limit to avoid file descriptor exhaustion.
+ */
+const DEFAULT_CONCURRENCY = 50;
+/**
+ * Read multiple files in parallel with concurrency control.
+ *
+ * Uses Promise.allSettled to ensure all reads complete (or fail)
+ * without aborting on the first error. Files are processed in
+ * batches to avoid exhausting file descriptors.
+ *
+ * @param paths - File paths to read
+ * @param fs - FileSystem implementation
+ * @param concurrency - Maximum number of concurrent reads (default: 50)
+ * @returns Results for each file (success or error)
+ */
+export async function readFilesParallel(paths, fs, concurrency = DEFAULT_CONCURRENCY) {
+    const results = [];
+    // Process in batches
+    for (let i = 0; i < paths.length; i += concurrency) {
+        const batch = paths.slice(i, i + concurrency);
+        const batchResults = await Promise.allSettled(batch.map(async (path) => {
+            const content = await fs.readFile(path);
+            return { path, content };
+        }));
+        for (let j = 0; j < batchResults.length; j++) {
+            const result = batchResults[j];
+            const path = batch[j];
+            if (result.status === 'fulfilled') {
+                results.push({
+                    path,
+                    content: result.value.content,
+                });
+            }
+            else {
+                results.push({
+                    path,
+                    error: result.reason instanceof Error
+                        ? result.reason.message
+                        : String(result.reason),
+                });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=parallel-reader.js.map

package/dist/core/resolvers/parallel-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-reader.js","sourceRoot":"","sources":["../../../src/core/resolvers/parallel-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAc/B;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAe,EACf,EAAc,EACd,cAAsB,mBAAmB;IAEzC,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,qBAAqB;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,UAAU,CAC3C,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACvB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC3B,CAAC,CAAC,CACH,CAAC;QAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAEtB,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;iBAC9B,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,KAAK,EAAE,MAAM,CAAC,MAAM,YAAY,KAAK;wBACnC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;wBACvB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;iBAC1B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/resolvers/string-resolver.d.ts

@@ -0,0 +1,66 @@
+/**
+ * String resolver — generic string pattern extractor.
+ *
+ * Provides reusable utilities for extracting strings from files
+ * using regex patterns. Used by assertNamingConvention and
+ * potentially other assertions that need to extract identifiers.
+ *
+ * Design:
+ * - Pure extraction functions (no validation)
+ * - Depends on FileSystem interface for file reading
+ */
+import type { FileSystem } from './types.js';
+/**
+ * A string extracted from a file.
+ */
+export interface ExtractedString {
+    /** Path of the file */
+    file: string;
+    /** The extracted string */
+    value: string;
+    /** The line number (1-based) where it was found, or 0 for file-level extractions */
+    line: number;
+}
+/**
+ * Extract file stems (filename without extension) from a list of file paths.
+ *
+ * Pure function — no I/O.
+ */
+export declare function extractFileStems(files: string[]): ExtractedString[];
+/**
+ * Extract strings matching a regex pattern from file contents.
+ *
+ * Pure function — takes content string, returns matches.
+ * The pattern must have at least one capturing group; the first
+ * capturing group is used as the extracted string.
+ */
+export declare function extractByPattern(file: string, content: string, pattern: RegExp): ExtractedString[];
+/**
+ * Result of resolving strings from files.
+ */
+export interface ResolvedStrings {
+    strings: ExtractedString[];
+    filesRead: string[];
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/**
+ * Resolve file stems from files matching glob patterns.
+ */
+export declare function resolveFileStems(options: {
+    files: string[];
+    cwd?: string;
+    fs: FileSystem;
+}): Promise<ResolvedStrings>;
+/**
+ * Resolve strings from file contents using a regex pattern.
+ */
+export declare function resolveStringsByPattern(options: {
+    files: string[];
+    pattern: RegExp;
+    cwd?: string;
+    fs: FileSystem;
+}): Promise<ResolvedStrings>;
+//# sourceMappingURL=string-resolver.d.ts.map

package/dist/core/resolvers/string-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/resolvers/string-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,CAOnE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,eAAe,EAAE,CAmBnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,UAAU,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2B3B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE;IACrD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,UAAU,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0C3B"}

package/dist/core/resolvers/string-resolver.js

@@ -0,0 +1,127 @@
+/**
+ * String resolver — generic string pattern extractor.
+ *
+ * Provides reusable utilities for extracting strings from files
+ * using regex patterns. Used by assertNamingConvention and
+ * potentially other assertions that need to extract identifiers.
+ *
+ * Design:
+ * - Pure extraction functions (no validation)
+ * - Depends on FileSystem interface for file reading
+ */
+import { join, basename } from 'node:path';
+/**
+ * Extract file stems (filename without extension) from a list of file paths.
+ *
+ * Pure function — no I/O.
+ */
+export function extractFileStems(files) {
+    return files.map((file) => {
+        const base = basename(file);
+        const dotIndex = base.indexOf('.');
+        const stem = dotIndex > 0 ? base.slice(0, dotIndex) : base;
+        return { file, value: stem, line: 0 };
+    });
+}
+/**
+ * Extract strings matching a regex pattern from file contents.
+ *
+ * Pure function — takes content string, returns matches.
+ * The pattern must have at least one capturing group; the first
+ * capturing group is used as the extracted string.
+ */
+export function extractByPattern(file, content, pattern) {
+    const results = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const lineText = lines[i];
+        const localPattern = new RegExp(pattern.source, pattern.flags.replace('g', ''));
+        const match = localPattern.exec(lineText);
+        if (match && match[1] !== undefined) {
+            results.push({
+                file,
+                value: match[1],
+                line: i + 1,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Resolve file stems from files matching glob patterns.
+ */
+export async function resolveFileStems(options) {
+    const { files, cwd, fs } = options;
+    const errors = [];
+    // Expand globs
+    const expandedPaths = [];
+    for (const file of files) {
+        if (file.includes('*') || file.includes('?')) {
+            try {
+                const expanded = await fs.glob(file, cwd ? { cwd } : undefined);
+                expandedPaths.push(...expanded);
+            }
+            catch (err) {
+                errors.push({
+                    file,
+                    message: `Failed to expand glob: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        }
+        else {
+            expandedPaths.push(file);
+        }
+    }
+    return {
+        strings: extractFileStems(expandedPaths),
+        filesRead: expandedPaths,
+        errors,
+    };
+}
+/**
+ * Resolve strings from file contents using a regex pattern.
+ */
+export async function resolveStringsByPattern(options) {
+    const { files, pattern, cwd, fs } = options;
+    const strings = [];
+    const filesRead = [];
+    const errors = [];
+    // Expand globs
+    const expandedPaths = [];
+    for (const file of files) {
+        if (file.includes('*') || file.includes('?')) {
+            try {
+                const expanded = await fs.glob(file, cwd ? { cwd } : undefined);
+                expandedPaths.push(...expanded);
+            }
+            catch (err) {
+                errors.push({
+                    file,
+                    message: `Failed to expand glob: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        }
+        else {
+            expandedPaths.push(file);
+        }
+    }
+    // Read files and extract strings
+    for (const filePath of expandedPaths) {
+        const readPath = cwd ? join(cwd, filePath) : filePath;
+        let content;
+        try {
+            content = await fs.readFile(readPath);
+        }
+        catch (err) {
+            errors.push({
+                file: filePath,
+                message: `Failed to read file: ${err instanceof Error ? err.message : String(err)}`,
+            });
+            continue;
+        }
+        filesRead.push(filePath);
+        strings.push(...extractByPattern(filePath, content, pattern));
+    }
+    return { strings, filesRead, errors };
+}
+//# sourceMappingURL=string-resolver.js.map

package/dist/core/resolvers/string-resolver.js.map

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

package/dist/core/resolvers/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * FileSystem interface for the testing package resolver layer.
+ *
+ * Mirrors the organon-tools FileSystem interface but is self-contained
+ * so @organon-methodology/testing has no dependency on @organon-methodology/tools internals.
+ * The resolver layer uses this interface for all I/O; assertion functions
+ * in core/assertions/ never import this module (INV-TEST-1).
+ */
+export interface FileSystem {
+    readFile(path: string): Promise<string>;
+    glob(pattern: string, options?: {
+        cwd?: string;
+    }): Promise<string[]>;
+    exists(path: string): Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/resolvers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/resolvers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxC"}

package/dist/core/resolvers/types.js

@@ -0,0 +1,10 @@
+/**
+ * FileSystem interface for the testing package resolver layer.
+ *
+ * Mirrors the organon-tools FileSystem interface but is self-contained
+ * so @organon-methodology/testing has no dependency on @organon-methodology/tools internals.
+ * The resolver layer uses this interface for all I/O; assertion functions
+ * in core/assertions/ never import this module (INV-TEST-1).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/resolvers/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @organon-methodology/testing — Semantic testing framework for tier-4 invariant verification.
+ *
+ * Public API exports for the @organon-methodology/testing package.
+ */
+export { testInvariant, createRegistry, getDefaultRegistry, validateInvariantId, validateDescription, validateTestFn, InvariantTestError, } from './core/invariant-test.js';
+export type { InvariantTestMetadata, InvariantTestFn, TestRunner, TestInvariantOptions, InvariantTestRegistry, } from './core/invariant-test.js';
+export { assertMaxValue, MaxValueResolverError, MaxValueAssertionError, } from './core/assert-max-value.js';
+export type { MaxValueOptions, } from './core/assert-max-value.js';
+export { validateMaxValue, } from './core/assertions/max-value.js';
+export type { MaxValueEntry, ValidateMaxValueOptions, MaxValueViolation, } from './core/assertions/max-value.js';
+export type { FileSystem, } from './core/resolvers/types.js';
+export { createNodeFileSystem } from './core/resolvers/node-fs.js';
+export { resolveValues, expandGlobs, } from './core/resolvers/file-resolver.js';
+export type { ExtractedValue, ResolvedValues, ResolverError, FileMatch, ResolveValuesOptions, } from './core/resolvers/file-resolver.js';
+export { assertFileExists, FileExistsResolverError, FileExistsAssertionError, } from './core/assert-file-exists.js';
+export type { FileExistsOptions, } from './core/assert-file-exists.js';
+export { validateFileExists, } from './core/assertions/file-exists.js';
+export type { FileExistsEntry, FileExistsViolation, } from './core/assertions/file-exists.js';
+export { assertCustom, CustomAssertionError, } from './core/assert-custom.js';
+export type { CustomAssertionOptions, } from './core/assert-custom.js';
+export { assertNoSideEffects, NoSideEffectsResolverError, NoSideEffectsAssertionError, } from './core/assert-no-side-effects.js';
+export type { NoSideEffectsOptions, } from './core/assert-no-side-effects.js';
+export { validateNoSideEffects, isForbidden, } from './core/assertions/no-side-effects.js';
+export type { NoSideEffectsViolation, } from './core/assertions/no-side-effects.js';
+export { assertNamingConvention, NamingConventionResolverError, NamingConventionAssertionError, } from './core/assert-naming-convention.js';
+export type { NamingConventionOptions, Convention, } from './core/assert-naming-convention.js';
+export { validateNamingConvention, matchesConvention, } from './core/assertions/naming-convention.js';
+export type { NamingConventionViolation, } from './core/assertions/naming-convention.js';
+export { assertExportsPresent, ExportsPresentResolverError, ExportsPresentAssertionError, extractExportNames, } from './core/assert-exports-present.js';
+export type { ExportsPresentOptions, } from './core/assert-exports-present.js';
+export { validateExportsPresent, } from './core/assertions/exports-present.js';
+export type { ExportsPresentViolation, } from './core/assertions/exports-present.js';
+export { extractImports, resolveImports, } from './core/resolvers/import-resolver.js';
+export type { ImportMatch, ResolvedImports, } from './core/resolvers/import-resolver.js';
+export { extractFileStems, extractByPattern, resolveFileStems, resolveStringsByPattern, } from './core/resolvers/string-resolver.js';
+export type { ExtractedString, ResolvedStrings, } from './core/resolvers/string-resolver.js';
+export { readFilesParallel, } from './core/resolvers/parallel-reader.js';
+export type { FileReadResult, } from './core/resolvers/parallel-reader.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":"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"}

package/dist/index.js

@@ -0,0 +1,50 @@
+/**
+ * @organon-methodology/testing — Semantic testing framework for tier-4 invariant verification.
+ *
+ * Public API exports for the @organon-methodology/testing package.
+ */
+// ---------------------------------------------------------------------------
+// Core: testInvariant() wrapper
+// ---------------------------------------------------------------------------
+export { testInvariant, createRegistry, getDefaultRegistry, validateInvariantId, validateDescription, validateTestFn, InvariantTestError, } from './core/invariant-test.js';
+// ---------------------------------------------------------------------------
+// Assertions: assertMaxValue()
+// ---------------------------------------------------------------------------
+export { assertMaxValue, MaxValueResolverError, MaxValueAssertionError, } from './core/assert-max-value.js';
+// ---------------------------------------------------------------------------
+// Pure assertion validators (for advanced use / testing)
+// ---------------------------------------------------------------------------
+export { validateMaxValue, } from './core/assertions/max-value.js';
+export { createNodeFileSystem } from './core/resolvers/node-fs.js';
+export { resolveValues, expandGlobs, } from './core/resolvers/file-resolver.js';
+// ---------------------------------------------------------------------------
+// Assertions: assertFileExists()
+// ---------------------------------------------------------------------------
+export { assertFileExists, FileExistsResolverError, FileExistsAssertionError, } from './core/assert-file-exists.js';
+export { validateFileExists, } from './core/assertions/file-exists.js';
+// ---------------------------------------------------------------------------
+// Assertions: assertCustom()
+// ---------------------------------------------------------------------------
+export { assertCustom, CustomAssertionError, } from './core/assert-custom.js';
+// ---------------------------------------------------------------------------
+// Assertions: assertNoSideEffects()
+// ---------------------------------------------------------------------------
+export { assertNoSideEffects, NoSideEffectsResolverError, NoSideEffectsAssertionError, } from './core/assert-no-side-effects.js';
+export { validateNoSideEffects, isForbidden, } from './core/assertions/no-side-effects.js';
+// ---------------------------------------------------------------------------
+// Assertions: assertNamingConvention()
+// ---------------------------------------------------------------------------
+export { assertNamingConvention, NamingConventionResolverError, NamingConventionAssertionError, } from './core/assert-naming-convention.js';
+export { validateNamingConvention, matchesConvention, } from './core/assertions/naming-convention.js';
+// ---------------------------------------------------------------------------
+// Assertions: assertExportsPresent()
+// ---------------------------------------------------------------------------
+export { assertExportsPresent, ExportsPresentResolverError, ExportsPresentAssertionError, extractExportNames, } from './core/assert-exports-present.js';
+export { validateExportsPresent, } from './core/assertions/exports-present.js';
+// ---------------------------------------------------------------------------
+// Resolvers (for advanced use)
+// ---------------------------------------------------------------------------
+export { extractImports, resolveImports, } from './core/resolvers/import-resolver.js';
+export { extractFileStems, extractByPattern, resolveFileStems, resolveStringsByPattern, } from './core/resolvers/string-resolver.js';
+export { readFilesParallel, } from './core/resolvers/parallel-reader.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;;;;GAIG;AAEH,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,OAAO,EACL,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAUlC,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAMpC,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAE9E,OAAO,EACL,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AAgBxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EACL,aAAa,EACb,WAAW,GACZ,MAAM,mCAAmC,CAAC;AAU3C,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AAMtC,OAAO,EACL,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAO1C,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,OAAO,EACL,YAAY,EACZ,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAMjC,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E;AAE9E,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAM1C,OAAO,EACL,qBAAqB,EACrB,WAAW,GACZ,MAAM,sCAAsC,CAAC;AAM9C,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,oCAAoC,CAAC;AAO5C,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,wCAAwC,CAAC;AAMhD,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAM1C,OAAO,EACL,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAM9C,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,OAAO,EACL,cAAc,EACd,cAAc,GACf,MAAM,qCAAqC,CAAC;AAO7C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAO7C,OAAO,EACL,iBAAiB,GAClB,MAAM,qCAAqC,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@organon-methodology/testing",
+  "version": "0.3.0",
+  "description": "Semantic testing framework for automated tier-4 invariant verification",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vitest": {
+      "types": "./dist/adapters/vitest.d.ts",
+      "import": "./dist/adapters/vitest.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/VledicFranco/organon.git",
+    "directory": "packages/testing"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "node --input-type=module -e \"import{rmSync}from'node:fs';rmSync('dist',{recursive:true,force:true})\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "organon",
+    "testing",
+    "invariants",
+    "invariant",
+    "tier-4",
+    "verification"
+  ],
+  "author": "Organon Methodology Contributors",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "vitest": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "fast-glob": "^3.3.3"
+  }
+}