micro-contracts 0.16.4 → 0.17.0

package/dist/guardrails/types.d.ts

@@ -1,202 +0,0 @@
-/**
- * Guardrails type definitions
- *
- * These types define the structure for AI-driven development guardrails
- * that protect generated artifacts and enforce change policies.
- */
-/**
- * Guardrails configuration file structure (guardrails.yaml)
- */
-export interface GuardrailsConfig {
-    /**
-     * Paths that can be edited in normal development PRs
-     * Supports glob patterns and negation (prefix with !)
-     */
-    allowed?: string[];
-    /**
-     * Paths that require special approval (e.g., security config, CI)
-     * Supports glob patterns and negation (prefix with !)
-     */
-    protected?: string[];
-    /**
-     * Paths for generated artifacts (committed but only modified via generate)
-     * Supports glob patterns and negation (prefix with !)
-     */
-    generated?: string[];
-    /**
-     * Check command configurations
-     * Define custom commands for each guardrail check
-     */
-    checks?: ChecksConfig;
-}
-/**
- * Configuration for guardrail check commands
- */
-export interface ChecksConfig {
-    /** Lint check configuration */
-    lint?: CheckCommandConfig;
-    /** TypeScript type check configuration */
-    typecheck?: CheckCommandConfig;
-    /** Documentation check configuration */
-    docs?: CheckCommandConfig;
-    /** Additional custom checks */
-    [key: string]: CheckCommandConfig | undefined;
-}
-/**
- * Gate numbers for guardrail checks
- *
- * Gate 1: Change Allowlist (allowlist)
- * Gate 2: OpenAPI Contract Validation (spec-lint, spec-breaking)
- * Gate 3: Generated Artifact Integrity (drift, manifest)
- * Gate 4: Code Quality (code-lint, code-typecheck, code-test)
- * Gate 5: Doc Consistency & Static Analysis (docs-sync, docs-links, security)
- */
-export type GateNumber = 1 | 2 | 3 | 4 | 5;
-/**
- * Configuration for a single check command
- */
-export interface CheckCommandConfig {
-    /**
-     * Command template to run.
-     * Supports placeholders:
-     * - {files} - space-separated list of target files (auto-detected)
-     * - {cwd} - current working directory
-     *
-     * @example
-     * command: "npx @stoplight/spectral-cli lint {files} --ruleset spec/spectral.yaml"
-     */
-    command: string;
-    /**
-     * Whether this check is enabled (default: true)
-     */
-    enabled?: boolean;
-    /**
-     * Gate number this check belongs to (1-5)
-     * Used with --gate option to run checks by gate
-     *
-     * Gate 1: Change Allowlist
-     * Gate 2: OpenAPI Contract Validation
-     * Gate 3: Generated Artifact Integrity
-     * Gate 4: Code Quality
-     * Gate 5: Doc Consistency & Static Analysis
-     */
-    gate?: GateNumber;
-}
-/**
- * Result of allowlist verification
- */
-export interface AllowlistResult {
-    valid: boolean;
-    violations: AllowlistViolation[];
-}
-/**
- * A single allowlist violation
- */
-export interface AllowlistViolation {
-    file: string;
-    reason: 'protected' | 'not-in-allowlist';
-}
-/**
- * Result of drift check
- */
-export interface DriftResult {
-    valid: boolean;
-    changedFiles: string[];
-    error?: string;
-}
-/**
- * Generated artifact manifest structure
- */
-export interface GeneratedManifest {
-    /** Manifest format version */
-    version: string;
-    /** Timestamp when manifest was last updated (only changes when files change) */
-    updatedAt?: string;
-    /** Version of micro-contracts that generated this */
-    generatorVersion: string;
-    /** SHA-256 hash of all input files (config, specs, templates, overlays) + package version */
-    inputHash?: string;
-    /** Map of relative file paths to their metadata */
-    files: Record<string, GeneratedFileInfo>;
-}
-/**
- * Metadata for a single generated file
- */
-export interface GeneratedFileInfo {
-    /** SHA-256 hash of file content */
-    sha256: string;
-    /** Source file that generated this (e.g., OpenAPI spec path) */
-    source?: string;
-}
-/**
- * Result of manifest verification
- */
-export interface ManifestResult {
-    valid: boolean;
-    mismatches: ManifestMismatch[];
-    manifestPath?: string;
-}
-/**
- * A single manifest mismatch
- */
-export interface ManifestMismatch {
-    file: string;
-    reason: 'missing' | 'hash-mismatch' | 'extra';
-    expected?: string;
-    actual?: string;
-}
-/**
- * Options for check command
- */
-export interface CheckOptions {
-    /** Run specific checks only */
-    only?: string[];
-    /** Skip specific checks */
-    skip?: string[];
-    /** Run checks for specific gates only (1-5) */
-    gates?: GateNumber[];
-    /** Enable verbose output */
-    verbose?: boolean;
-    /** Enable auto-fix where possible */
-    fix?: boolean;
-    /** Path to guardrails.yaml */
-    guardrailsPath?: string;
-    /** Path to generated files directory */
-    generatedDir?: string;
-    /** File containing list of changed files (for CI) */
-    changedFilesPath?: string;
-    /** Callback called when each check completes (for streaming output) */
-    onCheckComplete?: (result: CheckResult, check: CheckDefinition) => void;
-    /** Callback called before each check starts (for streaming output) */
-    onCheckStart?: (check: CheckDefinition) => void;
-}
-/**
- * Result of a single check
- */
-export interface CheckResult {
-    name: string;
-    status: 'pass' | 'fail' | 'skip';
-    duration: number;
-    message?: string;
-    details?: string[];
-}
-/**
- * Overall check summary
- */
-export interface CheckSummary {
-    passed: number;
-    failed: number;
-    skipped: number;
-    results: CheckResult[];
-}
-/**
- * Check definition
- */
-export interface CheckDefinition {
-    name: string;
-    description: string;
-    /** Gate number this check belongs to (1-5) */
-    gate?: GateNumber;
-    run: (options: CheckOptions) => Promise<CheckResult>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/guardrails/types.d.ts.map

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

package/dist/guardrails/types.js

@@ -1,8 +0,0 @@
-/**
- * Guardrails type definitions
- *
- * These types define the structure for AI-driven development guardrails
- * that protect generated artifacts and enforce change policies.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/guardrails/types.js.map

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

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC"}