@specsafe/core 0.4.0 → 0.6.0

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"}

package/dist/governance/builtins.js

@@ -0,0 +1,105 @@
+import { validateRequirements } from '../ears/validator.js';
+export const BUILTIN_PRINCIPLES = [
+    { id: 'tdd-mandatory', name: 'TDD Mandatory', description: 'All specs must have test scenarios defined for each requirement', severity: 'error', immutable: true, metadata: { rationale: 'Test-driven development ensures testability and clear acceptance criteria', tags: ['testing', 'tdd', 'quality'] } },
+    { id: 'security-review-required', name: 'Security Review Required', description: 'Specs must include a security considerations section', severity: 'warning', immutable: true, metadata: { rationale: 'Security should be considered from the specification phase', tags: ['security', 'compliance'] } },
+    { id: 'max-spec-complexity', name: 'Maximum Spec Complexity', description: 'Spec must not exceed complexity threshold (max 10 requirements)', severity: 'warning', immutable: false, metadata: { rationale: 'Complex specs are harder to implement and test; break them down', tags: ['complexity', 'maintainability'] } },
+    { id: 'require-acceptance-criteria', name: 'Require Acceptance Criteria', description: 'All requirements must have clearly defined acceptance criteria', severity: 'error', immutable: true, metadata: { rationale: 'Acceptance criteria define "done" and enable effective testing', tags: ['testing', 'requirements'] } },
+    { id: 'no-spec-without-review', name: 'No Spec Without Review', description: 'Spec must have a reviewer assigned before moving to test phase', severity: 'warning', immutable: false, metadata: { rationale: 'Peer review catches issues early and improves spec quality', tags: ['review', 'quality'] } },
+    { id: 'require-ears-format', name: 'Require EARS Format', description: 'Requirements must follow EARS (Easy Approach to Requirements Syntax) patterns', severity: 'warning', immutable: false, metadata: { rationale: 'EARS patterns improve requirement clarity and testability', tags: ['requirements', 'ears', 'standards'] } },
+];
+function checkViolation(spec, principle, condition, message, suggestion) {
+    return condition ? { principle, message, severity: principle.severity, spec, context: { suggestion } } : null;
+}
+export const BUILTIN_GATES = [
+    {
+        id: 'spec-phase-gate',
+        name: 'Spec Phase Gate',
+        phase: 'spec',
+        description: 'Validates specs before moving to test phase',
+        principles: ['tdd-mandatory', 'require-acceptance-criteria', 'max-spec-complexity', 'require-ears-format'],
+        check: (spec, principles) => {
+            const violations = [];
+            for (const p of principles) {
+                if (p.id === 'tdd-mandatory') {
+                    const bad = spec.requirements.filter(r => !r.scenarios || r.scenarios.length === 0);
+                    if (bad.length > 0) {
+                        const v = checkViolation(spec, p, true, `Requirements without test scenarios: ${bad.map(r => r.id).join(', ')}`, 'Add at least one test scenario (Given/When/Then) for each requirement');
+                        if (v)
+                            violations.push(v);
+                    }
+                }
+                if (p.id === 'require-acceptance-criteria') {
+                    // Check for meaningful requirement text (minimum 20 characters)
+                    const bad = spec.requirements.filter(r => !r.text || r.text.trim().length < 20);
+                    if (bad.length > 0) {
+                        const v = checkViolation(spec, p, true, `Requirements with insufficient acceptance criteria: ${bad.map(r => r.id).join(', ')}`, 'Provide detailed acceptance criteria text (minimum 20 characters) describing what constitutes "done"');
+                        if (v)
+                            violations.push(v);
+                    }
+                }
+                if (p.id === 'max-spec-complexity') {
+                    const v = checkViolation(spec, p, spec.requirements.length > 10, `Spec has ${spec.requirements.length} requirements (max: 10)`, 'Consider breaking this spec into multiple smaller specs');
+                    if (v)
+                        violations.push(v);
+                }
+                if (p.id === 'require-ears-format') {
+                    const result = validateRequirements(spec);
+                    const v = checkViolation(spec, p, result.score < 70, `EARS compliance score: ${result.score}% (min: 70%)`, result.recommendation);
+                    if (v)
+                        violations.push(v);
+                }
+            }
+            const errors = violations.filter(v => v.severity === 'error');
+            return {
+                passed: errors.length === 0,
+                violations,
+                gate: BUILTIN_GATES[0],
+                timestamp: new Date(),
+                summary: errors.length === 0 ? `✓ Spec phase gate passed` : `✗ Spec phase gate failed: ${errors.length} error(s), ${violations.length - errors.length} warning(s)`,
+            };
+        },
+    },
+    {
+        id: 'test-phase-gate',
+        name: 'Test Phase Gate',
+        phase: 'test',
+        description: 'Validates before moving to code phase',
+        principles: ['no-spec-without-review', 'security-review-required'],
+        check: (spec, principles) => {
+            const violations = [];
+            for (const p of principles) {
+                if (p.id === 'no-spec-without-review') {
+                    const hasReviewer = spec.metadata && 'reviewer' in spec.metadata && spec.metadata.reviewer;
+                    const v = checkViolation(spec, p, !hasReviewer, 'No reviewer assigned to this spec', 'Add a reviewer field to spec metadata before moving to test phase');
+                    if (v)
+                        violations.push(v);
+                }
+                if (p.id === 'security-review-required') {
+                    const descLower = spec.description.toLowerCase();
+                    const hasPositive = ['## security', '# security', 'security considerations:', 'authentication:', 'authorization:', 'access control', 'encryption', 'security requirements'].some(term => descLower.includes(term));
+                    const v = checkViolation(spec, p, !hasPositive, 'Spec lacks security considerations section', 'Add a section describing security considerations, auth requirements, and data protection');
+                    if (v)
+                        violations.push(v);
+                }
+            }
+            const errors = violations.filter(v => v.severity === 'error');
+            return {
+                passed: errors.length === 0,
+                violations,
+                gate: BUILTIN_GATES[1],
+                timestamp: new Date(),
+                summary: errors.length === 0 ? `✓ Test phase gate passed` : `✗ Test phase gate failed: ${errors.length} error(s), ${violations.length - errors.length} warning(s)`,
+            };
+        },
+    },
+];
+export function getBuiltinPrinciple(id) {
+    return BUILTIN_PRINCIPLES.find(p => p.id === id);
+}
+export function getBuiltinGate(id) {
+    return BUILTIN_GATES.find(g => g.id === id);
+}
+export function getGatesForPhase(phase) {
+    return BUILTIN_GATES.filter(g => g.phase === phase);
+}
+//# sourceMappingURL=builtins.js.map

package/dist/governance/builtins.js.map

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

package/dist/governance/constitution.d.ts

@@ -0,0 +1,23 @@
+import type { Constitution, Principle, Gate, GateResult, ConstitutionLoadOptions, ValidationOptions } from './types.js';
+import type { Spec } from '../types.js';
+export declare class ConstitutionManager {
+    private constitution;
+    private projectDir;
+    constructor(projectDir?: string);
+    load(options?: ConstitutionLoadOptions): Promise<Constitution>;
+    private loadFromMarkdown;
+    private loadFromConfig;
+    private createDefault;
+    private mergeBuiltins;
+    private validateConstitution;
+    addPrinciple(principle: Principle): void;
+    removePrinciple(id: string): void;
+    listPrinciples(): Principle[];
+    getPrinciple(id: string): Principle | undefined;
+    validate(spec: Spec, options?: ValidationOptions): Promise<GateResult[]>;
+    getConstitution(): Constitution | null;
+    hasPrinciple(id: string): boolean;
+    getGatesForPhase(phase: string): Gate[];
+    save(): Promise<void>;
+}
+//# sourceMappingURL=constitution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constitution.d.ts","sourceRoot":"","sources":["../../src/governance/constitution.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACxH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,GAAE,MAAsB;IAIxC,IAAI,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,YAAY,CAAC;YA0B1D,gBAAgB;YAqChB,cAAc;IAwB5B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,oBAAoB;IAc5B,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAOxC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASjC,cAAc,IAAI,SAAS,EAAE;IAK7B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKzC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAyBlF,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE;IAKjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAkE5B"}

package/dist/governance/constitution.js

@@ -0,0 +1,245 @@
+import { readFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { BUILTIN_PRINCIPLES, BUILTIN_GATES } from './builtins.js';
+export class ConstitutionManager {
+    constitution = null;
+    projectDir;
+    constructor(projectDir = process.cwd()) {
+        this.projectDir = projectDir;
+    }
+    async load(options = {}) {
+        const { includeBuiltins = true, validate = true } = options;
+        const constitutionMdPath = join(this.projectDir, '.specsafe', 'constitution.md');
+        if (existsSync(constitutionMdPath)) {
+            this.constitution = await this.loadFromMarkdown(constitutionMdPath);
+        }
+        else {
+            const configPath = join(this.projectDir, 'specsafe.config.json');
+            if (existsSync(configPath)) {
+                this.constitution = await this.loadFromConfig(configPath);
+            }
+            else {
+                this.constitution = this.createDefault();
+            }
+        }
+        if (includeBuiltins) {
+            this.mergeBuiltins();
+        }
+        if (validate) {
+            this.validateConstitution();
+        }
+        return this.constitution;
+    }
+    async loadFromMarkdown(path) {
+        const content = await readFile(path, 'utf-8');
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            throw new Error('Constitution markdown must have YAML frontmatter');
+        }
+        const frontmatter = frontmatterMatch[1];
+        const principles = [];
+        // Split on '- id:' but preserve it by including it in the match
+        const principleBlocks = frontmatter.split(/(?=\n- id:)/);
+        for (const block of principleBlocks) {
+            if (!block.trim() || !block.includes('- id:'))
+                continue;
+            const lines = block.split('\n');
+            const principle = {};
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (trimmed.startsWith('- id:'))
+                    principle.id = trimmed.substring(5).trim();
+                else if (trimmed.startsWith('id:'))
+                    principle.id = trimmed.substring(3).trim();
+                else if (trimmed.startsWith('name:'))
+                    principle.name = trimmed.substring(5).trim();
+                else if (trimmed.startsWith('description:'))
+                    principle.description = trimmed.substring(12).trim();
+                else if (trimmed.startsWith('severity:'))
+                    principle.severity = trimmed.substring(9).trim();
+                else if (trimmed.startsWith('immutable:'))
+                    principle.immutable = trimmed.substring(10).trim() === 'true';
+            }
+            if (principle.id && principle.name && principle.description) {
+                principles.push({ id: principle.id, name: principle.name, description: principle.description, severity: principle.severity || 'warning', immutable: principle.immutable ?? false });
+            }
+        }
+        return { principles, gates: [], metadata: { projectName: 'unknown', version: '1.0.0', createdAt: new Date(), updatedAt: new Date() } };
+    }
+    async loadFromConfig(path) {
+        const content = await readFile(path, 'utf-8');
+        const config = JSON.parse(content);
+        const constitution = config.constitution || this.createDefault();
+        if (constitution.metadata) {
+            if (constitution.metadata.createdAt)
+                constitution.metadata.createdAt = new Date(constitution.metadata.createdAt);
+            if (constitution.metadata.updatedAt)
+                constitution.metadata.updatedAt = new Date(constitution.metadata.updatedAt);
+        }
+        // Reconstruct gates from JSON - plain objects lack the check function
+        // Replace with matching builtin gates or remove invalid ones
+        if (constitution.gates && Array.isArray(constitution.gates)) {
+            constitution.gates = constitution.gates
+                .map((gate) => {
+                const builtinGate = BUILTIN_GATES.find(bg => bg.id === gate.id);
+                return builtinGate || null;
+            })
+                .filter((gate) => gate !== null);
+        }
+        return constitution;
+    }
+    createDefault() {
+        return { principles: [], gates: [], metadata: { projectName: 'unknown', version: '1.0.0', createdAt: new Date(), updatedAt: new Date(), description: 'Project governance constitution' } };
+    }
+    mergeBuiltins() {
+        if (!this.constitution)
+            return;
+        for (const builtinPrinciple of BUILTIN_PRINCIPLES) {
+            const exists = this.constitution.principles.some(p => p.id === builtinPrinciple.id);
+            if (!exists)
+                this.constitution.principles.push(builtinPrinciple);
+        }
+        for (const builtinGate of BUILTIN_GATES) {
+            const exists = this.constitution.gates.some(g => g.id === builtinGate.id);
+            if (!exists)
+                this.constitution.gates.push(builtinGate);
+        }
+    }
+    validateConstitution() {
+        if (!this.constitution)
+            throw new Error('No constitution loaded');
+        const principleIds = new Set();
+        for (const principle of this.constitution.principles) {
+            if (principleIds.has(principle.id))
+                throw new Error(`Duplicate principle ID: ${principle.id}`);
+            principleIds.add(principle.id);
+        }
+        const gateIds = new Set();
+        for (const gate of this.constitution.gates) {
+            if (gateIds.has(gate.id))
+                throw new Error(`Duplicate gate ID: ${gate.id}`);
+            gateIds.add(gate.id);
+        }
+    }
+    addPrinciple(principle) {
+        if (!this.constitution)
+            throw new Error('No constitution loaded');
+        if (this.constitution.principles.some(p => p.id === principle.id))
+            throw new Error(`Principle with ID "${principle.id}" already exists`);
+        this.constitution.principles.push(principle);
+        this.constitution.metadata.updatedAt = new Date();
+    }
+    removePrinciple(id) {
+        if (!this.constitution)
+            throw new Error('No constitution loaded');
+        const principle = this.constitution.principles.find(p => p.id === id);
+        if (!principle)
+            throw new Error(`Principle with ID "${id}" not found`);
+        if (principle.immutable)
+            throw new Error(`Principle "${id}" is immutable and cannot be removed`);
+        this.constitution.principles = this.constitution.principles.filter(p => p.id !== id);
+        this.constitution.metadata.updatedAt = new Date();
+    }
+    listPrinciples() {
+        if (!this.constitution)
+            throw new Error('No constitution loaded');
+        return [...this.constitution.principles];
+    }
+    getPrinciple(id) {
+        if (!this.constitution)
+            throw new Error('No constitution loaded');
+        return this.constitution.principles.find(p => p.id === id);
+    }
+    async validate(spec, options = {}) {
+        if (!this.constitution)
+            throw new Error('No constitution loaded. Call load() first.');
+        const { phase = spec.stage, failFast = false, includeWarnings = true } = options;
+        const results = [];
+        const applicableGates = this.constitution.gates.filter(g => g.phase === phase);
+        for (const gate of applicableGates) {
+            const gatePrinciples = gate.principles.map(id => this.constitution.principles.find(p => p.id === id)).filter((p) => p !== undefined);
+            const result = await Promise.resolve(gate.check(spec, gatePrinciples));
+            results.push(result);
+            if (failFast && !result.passed) {
+                const hasErrors = result.violations.some(v => v.severity === 'error');
+                if (hasErrors)
+                    break;
+            }
+        }
+        if (!includeWarnings) {
+            for (const result of results) {
+                result.violations = result.violations.filter(v => v.severity === 'error');
+            }
+        }
+        return results;
+    }
+    getConstitution() {
+        return this.constitution;
+    }
+    hasPrinciple(id) {
+        return this.constitution?.principles.some(p => p.id === id) ?? false;
+    }
+    getGatesForPhase(phase) {
+        if (!this.constitution)
+            return [];
+        return this.constitution.gates.filter(g => g.phase === phase);
+    }
+    async save() {
+        if (!this.constitution)
+            throw new Error('No constitution loaded');
+        const { writeFile, mkdir } = await import('fs/promises');
+        const specsafeDir = join(this.projectDir, '.specsafe');
+        const constitutionPath = join(specsafeDir, 'constitution.md');
+        await mkdir(specsafeDir, { recursive: true });
+        // Only save custom principles (exclude built-ins)
+        const customPrinciples = this.constitution.principles.filter(p => !BUILTIN_PRINCIPLES.some(bp => bp.id === p.id));
+        const now = new Date().toISOString();
+        const quoteValue = (val) => JSON.stringify(val);
+        let content = `---
+# SpecSafe Project Constitution
+projectName: ${quoteValue(this.constitution.metadata.projectName)}
+author: ${quoteValue(this.constitution.metadata.author || 'Unknown')}
+version: ${quoteValue(this.constitution.metadata.version)}
+createdAt: ${this.constitution.metadata.createdAt.toISOString()}
+updatedAt: ${now}
+
+principles:
+`;
+        for (const principle of customPrinciples) {
+            content += `- id: ${principle.id}\n`;
+            content += `  name: ${quoteValue(principle.name)}\n`;
+            content += `  description: ${quoteValue(principle.description)}\n`;
+            content += `  severity: ${principle.severity}\n`;
+            content += `  immutable: ${principle.immutable}\n`;
+            if (principle.metadata?.rationale) {
+                content += `  rationale: ${quoteValue(principle.metadata.rationale)}\n`;
+            }
+            content += `\n`;
+        }
+        content += `---
+
+# Project Constitution: ${this.constitution.metadata.projectName}
+
+${this.constitution.metadata.description || 'Project governance constitution'}
+
+## Custom Principles
+
+`;
+        for (const principle of customPrinciples) {
+            const lockEmoji = principle.immutable ? '🔒' : '🔓';
+            const severityEmoji = principle.severity === 'error' ? '🚫' : '⚠️';
+            content += `### ${lockEmoji} ${principle.name}\n\n`;
+            content += `**ID:** \`${principle.id}\`  \n`;
+            content += `**Severity:** ${severityEmoji} ${principle.severity.toUpperCase()}  \n`;
+            content += `**Immutable:** ${principle.immutable ? 'Yes' : 'No'}  \n\n`;
+            content += `${principle.description}\n\n`;
+            if (principle.metadata?.rationale) {
+                content += `**Rationale:** ${principle.metadata.rationale}\n\n`;
+            }
+            content += `---\n\n`;
+        }
+        await writeFile(constitutionPath, content);
+    }
+}
+//# sourceMappingURL=constitution.js.map