@specsafe/core 0.5.0 → 0.6.0

package/dist/extensions/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * SpecSafe Extension System
+ *
+ * Provides a plugin architecture for extending SpecSafe functionality
+ * at various lifecycle hooks.
+ */
+export type { Extension, ExtensionHook, ExtensionContext, ExtensionResult, HookRegistration, } from './types.js';
+export { ExtensionRegistry } from './registry.js';
+import type { Extension, ExtensionHook, ExtensionContext, ExtensionResult } from './types.js';
+/**
+ * Register an extension
+ */
+export declare function registerExtension(extension: Extension): void;
+/**
+ * Unregister an extension
+ */
+export declare function unregisterExtension(extensionId: string): boolean;
+/**
+ * Get an extension by ID
+ */
+export declare function getExtension(extensionId: string): Extension | undefined;
+/**
+ * List all registered extensions
+ */
+export declare function listExtensions(): Extension[];
+/**
+ * List enabled extensions only
+ */
+export declare function listEnabledExtensions(): Extension[];
+/**
+ * Check if an extension exists
+ */
+export declare function hasExtension(extensionId: string): boolean;
+/**
+ * Enable an extension
+ */
+export declare function enableExtension(extensionId: string): boolean;
+/**
+ * Disable an extension
+ */
+export declare function disableExtension(extensionId: string): boolean;
+/**
+ * Execute hooks for a phase
+ */
+export declare function executeHooks(phase: ExtensionHook, context: ExtensionContext): Promise<ExtensionResult[]>;
+/**
+ * Clear all extensions (useful for testing)
+ */
+export declare function clearExtensions(): void;
+export { validateExtension, loadExtension, loadExtensions, loadBuiltinExtensions } from './loader.js';
+export type { Extension as ExtensionConfig } from './types.js';
+export type { ExtensionHook as ExtensionPhase } from './types.js';
+export type ExtensionRegistryEntry = Extension;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9F;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEvE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAE5C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAExG;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAGD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGtG,YAAY,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,YAAY,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,YAAY,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,SAAS,CAAC"}

package/dist/extensions/index.js

@@ -0,0 +1,72 @@
+/**
+ * SpecSafe Extension System
+ *
+ * Provides a plugin architecture for extending SpecSafe functionality
+ * at various lifecycle hooks.
+ */
+// Re-export registry methods as standalone functions
+export { ExtensionRegistry } from './registry.js';
+import { ExtensionRegistry } from './registry.js';
+/**
+ * Register an extension
+ */
+export function registerExtension(extension) {
+    ExtensionRegistry.register(extension);
+}
+/**
+ * Unregister an extension
+ */
+export function unregisterExtension(extensionId) {
+    return ExtensionRegistry.unregister(extensionId);
+}
+/**
+ * Get an extension by ID
+ */
+export function getExtension(extensionId) {
+    return ExtensionRegistry.get(extensionId);
+}
+/**
+ * List all registered extensions
+ */
+export function listExtensions() {
+    return ExtensionRegistry.list();
+}
+/**
+ * List enabled extensions only
+ */
+export function listEnabledExtensions() {
+    return ExtensionRegistry.listEnabled();
+}
+/**
+ * Check if an extension exists
+ */
+export function hasExtension(extensionId) {
+    return ExtensionRegistry.has(extensionId);
+}
+/**
+ * Enable an extension
+ */
+export function enableExtension(extensionId) {
+    return ExtensionRegistry.enable(extensionId);
+}
+/**
+ * Disable an extension
+ */
+export function disableExtension(extensionId) {
+    return ExtensionRegistry.disable(extensionId);
+}
+/**
+ * Execute hooks for a phase
+ */
+export function executeHooks(phase, context) {
+    return ExtensionRegistry.executeHooks(phase, context);
+}
+/**
+ * Clear all extensions (useful for testing)
+ */
+export function clearExtensions() {
+    ExtensionRegistry.clear();
+}
+// Loader exports
+export { validateExtension, loadExtension, loadExtensions, loadBuiltinExtensions } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/extensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,qDAAqD;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IACpD,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO,iBAAiB,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,iBAAiB,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,iBAAiB,CAAC,WAAW,EAAE,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAoB,EAAE,OAAyB;IAC1E,OAAO,iBAAiB,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/extensions/loader.d.ts

@@ -0,0 +1,28 @@
+import type { Extension } from './types.js';
+/**
+ * Validate extension structure
+ * @param ext - Extension to validate
+ * @returns true if extension is valid
+ * @throws Error if extension is invalid
+ */
+export declare function validateExtension(ext: unknown): ext is Extension;
+/**
+ * Load a single extension
+ * @param extension - Extension to load
+ * @param autoRegister - Whether to automatically register the extension (default: true)
+ * @returns The loaded extension
+ */
+export declare function loadExtension(extension: Extension, autoRegister?: boolean): Extension;
+/**
+ * Load multiple extensions
+ * @param extensions - Array of extensions to load
+ * @param autoRegister - Whether to automatically register extensions (default: true)
+ * @returns Array of loaded extensions
+ */
+export declare function loadExtensions(extensions: Extension[], autoRegister?: boolean): Extension[];
+/**
+ * Load builtin extensions
+ * @returns Array of loaded builtin extensions
+ */
+export declare function loadBuiltinExtensions(): Promise<Extension[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/extensions/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/extensions/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,SAAS,CA4BhE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,UAAO,GAAG,SAAS,CAQlF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,YAAY,UAAO,GAAG,SAAS,EAAE,CAExF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAOlE"}

package/dist/extensions/loader.js

@@ -0,0 +1,62 @@
+import { ExtensionRegistry } from './registry.js';
+/**
+ * Validate extension structure
+ * @param ext - Extension to validate
+ * @returns true if extension is valid
+ * @throws Error if extension is invalid
+ */
+export function validateExtension(ext) {
+    if (!ext || typeof ext !== 'object') {
+        throw new Error('Extension must be an object');
+    }
+    const extension = ext;
+    if (!extension.id || typeof extension.id !== 'string') {
+        throw new Error('Extension must have a string "id" field');
+    }
+    if (!extension.name || typeof extension.name !== 'string') {
+        throw new Error('Extension must have a string "name" field');
+    }
+    if (!extension.description || typeof extension.description !== 'string') {
+        throw new Error('Extension must have a string "description" field');
+    }
+    if (!extension.version || typeof extension.version !== 'string') {
+        throw new Error('Extension must have a string "version" field');
+    }
+    if (!extension.hooks || typeof extension.hooks !== 'object') {
+        throw new Error('Extension must have a "hooks" object');
+    }
+    return true;
+}
+/**
+ * Load a single extension
+ * @param extension - Extension to load
+ * @param autoRegister - Whether to automatically register the extension (default: true)
+ * @returns The loaded extension
+ */
+export function loadExtension(extension, autoRegister = true) {
+    validateExtension(extension);
+    if (autoRegister) {
+        ExtensionRegistry.register(extension);
+    }
+    return extension;
+}
+/**
+ * Load multiple extensions
+ * @param extensions - Array of extensions to load
+ * @param autoRegister - Whether to automatically register extensions (default: true)
+ * @returns Array of loaded extensions
+ */
+export function loadExtensions(extensions, autoRegister = true) {
+    return extensions.map(ext => loadExtension(ext, autoRegister));
+}
+/**
+ * Load builtin extensions
+ * @returns Array of loaded builtin extensions
+ */
+export async function loadBuiltinExtensions() {
+    const { owaspExtension } = await import('./builtins/owasp.js');
+    const { complexityExtension } = await import('./builtins/complexity.js');
+    const builtins = [owaspExtension, complexityExtension];
+    return loadExtensions(builtins, true);
+}
+//# sourceMappingURL=loader.js.map

package/dist/extensions/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/extensions/loader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,SAAS,GAAG,GAAyB,CAAC;IAE5C,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,WAAW,IAAI,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,SAAoB,EAAE,YAAY,GAAG,IAAI;IACrE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAE7B,IAAI,YAAY,EAAE,CAAC;QACjB,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,UAAuB,EAAE,YAAY,GAAG,IAAI;IACzE,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC/D,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAEzE,MAAM,QAAQ,GAAG,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;IAEvD,OAAO,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/extensions/registry.d.ts

@@ -0,0 +1,74 @@
+import type { Extension, ExtensionHook, ExtensionContext, ExtensionResult, HookRegistration } from './types.js';
+/**
+ * Global extension registry
+ */
+declare class ExtensionRegistryClass {
+    private extensions;
+    private hooks;
+    /**
+     * Register an extension
+     * @param extension - Extension to register
+     * @throws Error if extension with same ID already exists
+     */
+    register(extension: Extension): void;
+    /**
+     * Unregister an extension
+     * @param extensionId - ID of extension to unregister
+     * @returns true if extension was found and removed
+     */
+    unregister(extensionId: string): boolean;
+    /**
+     * Get an extension by ID
+     * @param extensionId - Extension ID
+     * @returns Extension or undefined if not found
+     */
+    get(extensionId: string): Extension | undefined;
+    /**
+     * Get all registered extensions
+     * @returns Array of all extensions
+     */
+    list(): Extension[];
+    /**
+     * Get enabled extensions only
+     * @returns Array of enabled extensions
+     */
+    listEnabled(): Extension[];
+    /**
+     * Check if an extension exists
+     * @param extensionId - Extension ID
+     * @returns true if extension is registered
+     */
+    has(extensionId: string): boolean;
+    /**
+     * Enable an extension
+     * @param extensionId - Extension ID
+     * @returns true if extension was found and enabled
+     */
+    enable(extensionId: string): boolean;
+    /**
+     * Disable an extension
+     * @param extensionId - Extension ID
+     * @returns true if extension was found and disabled
+     */
+    disable(extensionId: string): boolean;
+    /**
+     * Get hooks for a specific phase
+     * @param phase - Hook phase
+     * @returns Array of hook registrations for this phase
+     */
+    getHooks(phase: ExtensionHook): HookRegistration[];
+    /**
+     * Execute all hooks for a phase
+     * @param phase - Hook phase
+     * @param context - Extension context
+     * @returns Array of results from all hooks
+     */
+    executeHooks(phase: ExtensionHook, context: ExtensionContext): Promise<ExtensionResult[]>;
+    /**
+     * Clear all extensions (useful for testing)
+     */
+    clear(): void;
+}
+export declare const ExtensionRegistry: ExtensionRegistryClass;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/extensions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/extensions/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhH;;GAEG;AACH,cAAM,sBAAsB;IAC1B,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,KAAK,CAAqD;IAElE;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAyBpC;;;;OAIG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAoBxC;;;;OAIG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI/C;;;OAGG;IACH,IAAI,IAAI,SAAS,EAAE;IAInB;;;OAGG;IACH,WAAW,IAAI,SAAS,EAAE;IAI1B;;;;OAIG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;OAIG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IASpC;;;;OAIG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IASrC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,EAAE;IAIlD;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA0B/F;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAGD,eAAO,MAAM,iBAAiB,wBAA+B,CAAC"}

package/dist/extensions/registry.js

@@ -0,0 +1,159 @@
+/**
+ * Global extension registry
+ */
+class ExtensionRegistryClass {
+    extensions = new Map();
+    hooks = new Map();
+    /**
+     * Register an extension
+     * @param extension - Extension to register
+     * @throws Error if extension with same ID already exists
+     */
+    register(extension) {
+        if (this.extensions.has(extension.id)) {
+            throw new Error(`Extension with ID "${extension.id}" is already registered`);
+        }
+        this.extensions.set(extension.id, extension);
+        // Register hooks
+        for (const [phase, handler] of Object.entries(extension.hooks)) {
+            if (typeof handler === 'function') {
+                const registration = {
+                    extensionId: extension.id,
+                    phase: phase,
+                    handler,
+                    priority: 0,
+                };
+                const phaseHooks = this.hooks.get(phase) || [];
+                phaseHooks.push(registration);
+                phaseHooks.sort((a, b) => (a.priority || 0) - (b.priority || 0));
+                this.hooks.set(phase, phaseHooks);
+            }
+        }
+    }
+    /**
+     * Unregister an extension
+     * @param extensionId - ID of extension to unregister
+     * @returns true if extension was found and removed
+     */
+    unregister(extensionId) {
+        const extension = this.extensions.get(extensionId);
+        if (!extension) {
+            return false;
+        }
+        // Remove all hooks for this extension
+        for (const [phase, registrations] of this.hooks.entries()) {
+            const filtered = registrations.filter(r => r.extensionId !== extensionId);
+            if (filtered.length > 0) {
+                this.hooks.set(phase, filtered);
+            }
+            else {
+                this.hooks.delete(phase);
+            }
+        }
+        this.extensions.delete(extensionId);
+        return true;
+    }
+    /**
+     * Get an extension by ID
+     * @param extensionId - Extension ID
+     * @returns Extension or undefined if not found
+     */
+    get(extensionId) {
+        return this.extensions.get(extensionId);
+    }
+    /**
+     * Get all registered extensions
+     * @returns Array of all extensions
+     */
+    list() {
+        return Array.from(this.extensions.values());
+    }
+    /**
+     * Get enabled extensions only
+     * @returns Array of enabled extensions
+     */
+    listEnabled() {
+        return this.list().filter(ext => ext.enabled !== false);
+    }
+    /**
+     * Check if an extension exists
+     * @param extensionId - Extension ID
+     * @returns true if extension is registered
+     */
+    has(extensionId) {
+        return this.extensions.has(extensionId);
+    }
+    /**
+     * Enable an extension
+     * @param extensionId - Extension ID
+     * @returns true if extension was found and enabled
+     */
+    enable(extensionId) {
+        const extension = this.extensions.get(extensionId);
+        if (!extension) {
+            return false;
+        }
+        extension.enabled = true;
+        return true;
+    }
+    /**
+     * Disable an extension
+     * @param extensionId - Extension ID
+     * @returns true if extension was found and disabled
+     */
+    disable(extensionId) {
+        const extension = this.extensions.get(extensionId);
+        if (!extension) {
+            return false;
+        }
+        extension.enabled = false;
+        return true;
+    }
+    /**
+     * Get hooks for a specific phase
+     * @param phase - Hook phase
+     * @returns Array of hook registrations for this phase
+     */
+    getHooks(phase) {
+        return this.hooks.get(phase) || [];
+    }
+    /**
+     * Execute all hooks for a phase
+     * @param phase - Hook phase
+     * @param context - Extension context
+     * @returns Array of results from all hooks
+     */
+    async executeHooks(phase, context) {
+        const phaseHooks = this.getHooks(phase);
+        const results = [];
+        for (const hook of phaseHooks) {
+            const extension = this.extensions.get(hook.extensionId);
+            // Skip disabled extensions
+            if (!extension || extension.enabled === false) {
+                continue;
+            }
+            try {
+                const result = await hook.handler(context);
+                results.push(result);
+            }
+            catch (error) {
+                results.push({
+                    success: false,
+                    message: `Extension "${hook.extensionId}" failed`,
+                    errors: [error instanceof Error ? error.message : String(error)],
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Clear all extensions (useful for testing)
+     */
+    clear() {
+        this.extensions.clear();
+        this.hooks.clear();
+    }
+}
+// Export singleton instance
+export const ExtensionRegistry = new ExtensionRegistryClass();
+//# sourceMappingURL=registry.js.map

package/dist/extensions/registry.js.map

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

package/dist/extensions/types.d.ts

@@ -0,0 +1,70 @@
+import type { Spec } from '../types.js';
+/**
+ * Extension hook phases in the SpecSafe workflow
+ */
+export type ExtensionHook = 'pre-validate' | 'post-validate' | 'pre-generate' | 'post-generate' | 'pre-commit';
+/**
+ * Context provided to extension hooks
+ */
+export interface ExtensionContext {
+    /** The spec being processed */
+    spec: Spec;
+    /** Current phase of execution */
+    phase: ExtensionHook;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result returned by extension hooks
+ */
+export interface ExtensionResult {
+    /** Whether the extension check passed */
+    success: boolean;
+    /** Optional message describing the result */
+    message?: string;
+    /** Optional suggestions for improvement */
+    suggestions?: string[];
+    /** Optional warnings (non-blocking) */
+    warnings?: string[];
+    /** Optional errors (blocking) */
+    errors?: string[];
+    /** Additional data returned by the extension */
+    data?: Record<string, unknown>;
+}
+/**
+ * Extension definition
+ */
+export interface Extension {
+    /** Unique identifier for the extension */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of what the extension does */
+    description: string;
+    /** Extension version */
+    version: string;
+    /** Author/maintainer */
+    author?: string;
+    /** Hooks this extension provides */
+    hooks: {
+        [K in ExtensionHook]?: (context: ExtensionContext) => Promise<ExtensionResult> | ExtensionResult;
+    };
+    /** Whether the extension is enabled */
+    enabled?: boolean;
+    /** Extension configuration */
+    config?: Record<string, unknown>;
+}
+/**
+ * Hook registration entry
+ */
+export interface HookRegistration {
+    /** Extension that registered this hook */
+    extensionId: string;
+    /** Hook phase */
+    phase: ExtensionHook;
+    /** Hook handler function */
+    handler: (context: ExtensionContext) => Promise<ExtensionResult> | ExtensionResult;
+    /** Priority (lower = runs first) */
+    priority?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/extensions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,eAAe,GACf,cAAc,GACd,eAAe,GACf,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,KAAK,EAAE;SACJ,CAAC,IAAI,aAAa,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe;KACjG,CAAC;IACF,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,4BAA4B;IAC5B,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;IACnF,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/extensions/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extensions/types.js.map

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

package/dist/governance/builtins.d.ts

@@ -0,0 +1,7 @@
+import type { Principle, Gate, GatePhase } from './types.js';
+export declare const BUILTIN_PRINCIPLES: Principle[];
+export declare const BUILTIN_GATES: Gate[];
+export declare function getBuiltinPrinciple(id: string): Principle | undefined;
+export declare function getBuiltinGate(id: string): Gate | undefined;
+export declare function getGatesForPhase(phase: GatePhase): Gate[];
+//# sourceMappingURL=builtins.d.ts.map

package/dist/governance/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/governance/builtins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAyB,SAAS,EAAE,MAAM,YAAY,CAAC;AAIpF,eAAO,MAAM,kBAAkB,EAAE,SAAS,EAOzC,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAAI,EA4E/B,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAErE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE3D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,CAEzD"}