@specsafe/core 0.5.0 → 0.6.0

package/dist/elicitation/engine.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Elicitation Engine
+ * Manages interactive specification elicitation workflows
+ */
+import type { ElicitationFlow, ElicitationStep, ElicitationResult } from './types.js';
+/**
+ * Engine for running elicitation flows
+ *
+ * @example
+ * ```typescript
+ * const engine = new ElicitationEngine(quickFlow);
+ * const firstStep = engine.start();
+ *
+ * while (!engine.isComplete()) {
+ *   const current = engine.getCurrentStep();
+ *   const userAnswer = await getUserInput(current);
+ *   const nextStep = engine.answer(current.id, userAnswer);
+ * }
+ *
+ * const result = engine.getResult();
+ * ```
+ */
+export declare class ElicitationEngine {
+    private flow;
+    private answers;
+    private skipped;
+    private currentIndex;
+    private startedAt;
+    private completedAt;
+    /**
+     * Create a new elicitation engine
+     * @param flow The elicitation flow to execute
+     */
+    constructor(flow: ElicitationFlow);
+    /**
+     * Start the elicitation flow
+     * @returns The first step to present to the user, or null if no valid steps
+     */
+    start(): ElicitationStep | null;
+    /**
+     * Record an answer and move to the next step
+     * @param stepId The step ID being answered
+     * @param value The user's answer
+     * @returns The next step, or null if flow is complete
+     */
+    answer(stepId: string, value: any): ElicitationStep | null;
+    /**
+     * Skip a step (only allowed if not required)
+     * @param stepId The step ID to skip
+     * @returns The next step, or null if flow is complete
+     */
+    skip(stepId: string): ElicitationStep | null;
+    /**
+     * Get the current step
+     * @returns The current step, or null if not started or completed
+     */
+    getCurrentStep(): ElicitationStep | null;
+    /**
+     * Check if the flow is complete
+     * @returns True if all steps have been processed
+     */
+    isComplete(): boolean;
+    /**
+     * Get the elicitation result
+     * @returns The complete result with answers and metadata
+     */
+    getResult(): ElicitationResult;
+    /**
+     * Find the next valid step, skipping conditional steps that don't match
+     * @param startIndex Index to start searching from
+     * @returns The next valid step, or null if flow is complete
+     */
+    private getNextValidStep;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/elicitation/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/elicitation/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,WAAW,CAAqB;IAExC;;;OAGG;gBACS,IAAI,EAAE,eAAe;IAIjC;;;OAGG;IACH,KAAK,IAAI,eAAe,GAAG,IAAI;IAM/B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,eAAe,GAAG,IAAI;IA0C1D;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IA8B5C;;;OAGG;IACH,cAAc,IAAI,eAAe,GAAG,IAAI;IAOxC;;;OAGG;IACH,UAAU,IAAI,OAAO;IAIrB;;;OAGG;IACH,SAAS,IAAI,iBAAiB;IAgB9B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CAuBzB"}

package/dist/elicitation/engine.js

@@ -0,0 +1,174 @@
+/**
+ * Elicitation Engine
+ * Manages interactive specification elicitation workflows
+ */
+/**
+ * Engine for running elicitation flows
+ *
+ * @example
+ * ```typescript
+ * const engine = new ElicitationEngine(quickFlow);
+ * const firstStep = engine.start();
+ *
+ * while (!engine.isComplete()) {
+ *   const current = engine.getCurrentStep();
+ *   const userAnswer = await getUserInput(current);
+ *   const nextStep = engine.answer(current.id, userAnswer);
+ * }
+ *
+ * const result = engine.getResult();
+ * ```
+ */
+export class ElicitationEngine {
+    flow;
+    answers = {};
+    skipped = [];
+    currentIndex = -1;
+    startedAt = null;
+    completedAt = null;
+    /**
+     * Create a new elicitation engine
+     * @param flow The elicitation flow to execute
+     */
+    constructor(flow) {
+        this.flow = flow;
+    }
+    /**
+     * Start the elicitation flow
+     * @returns The first step to present to the user, or null if no valid steps
+     */
+    start() {
+        this.startedAt = new Date();
+        this.currentIndex = 0;
+        return this.getNextValidStep(0);
+    }
+    /**
+     * Record an answer and move to the next step
+     * @param stepId The step ID being answered
+     * @param value The user's answer
+     * @returns The next step, or null if flow is complete
+     */
+    answer(stepId, value) {
+        const step = this.flow.steps.find(s => s.id === stepId);
+        if (!step) {
+            throw new Error(`Step not found: ${stepId}`);
+        }
+        // Validate required fields
+        if (step.required && (value === null || value === undefined || value === '')) {
+            throw new Error(`Step '${stepId}' is required`);
+        }
+        // Run custom validation if present
+        if (step.validate) {
+            const validationResult = step.validate(value);
+            if (validationResult !== true) {
+                const errorMessage = typeof validationResult === 'string'
+                    ? validationResult
+                    : `Validation failed for step '${stepId}'`;
+                throw new Error(errorMessage);
+            }
+        }
+        // Store the answer
+        this.answers[stepId] = value;
+        // Move to next step
+        const currentStepIndex = this.flow.steps.findIndex(s => s.id === stepId);
+        if (currentStepIndex === -1) {
+            throw new Error(`Step not found in flow: ${stepId}`);
+        }
+        this.currentIndex = currentStepIndex + 1;
+        // Check if we've completed all steps
+        if (this.currentIndex >= this.flow.steps.length) {
+            this.completedAt = new Date();
+            return null;
+        }
+        return this.getNextValidStep(this.currentIndex);
+    }
+    /**
+     * Skip a step (only allowed if not required)
+     * @param stepId The step ID to skip
+     * @returns The next step, or null if flow is complete
+     */
+    skip(stepId) {
+        const step = this.flow.steps.find(s => s.id === stepId);
+        if (!step) {
+            throw new Error(`Step not found: ${stepId}`);
+        }
+        if (step.required) {
+            throw new Error(`Cannot skip required step: ${stepId}`);
+        }
+        // Mark as skipped
+        this.skipped.push(stepId);
+        // Move to next step
+        const currentStepIndex = this.flow.steps.findIndex(s => s.id === stepId);
+        if (currentStepIndex === -1) {
+            throw new Error(`Step not found in flow: ${stepId}`);
+        }
+        this.currentIndex = currentStepIndex + 1;
+        // Check if we've completed all steps
+        if (this.currentIndex >= this.flow.steps.length) {
+            this.completedAt = new Date();
+            return null;
+        }
+        return this.getNextValidStep(this.currentIndex);
+    }
+    /**
+     * Get the current step
+     * @returns The current step, or null if not started or completed
+     */
+    getCurrentStep() {
+        if (this.currentIndex < 0 || this.currentIndex >= this.flow.steps.length) {
+            return null;
+        }
+        return this.flow.steps[this.currentIndex];
+    }
+    /**
+     * Check if the flow is complete
+     * @returns True if all steps have been processed
+     */
+    isComplete() {
+        return this.completedAt !== null;
+    }
+    /**
+     * Get the elicitation result
+     * @returns The complete result with answers and metadata
+     */
+    getResult() {
+        if (!this.startedAt) {
+            throw new Error('Elicitation has not been started');
+        }
+        return {
+            flowId: this.flow.id,
+            answers: { ...this.answers },
+            metadata: {
+                startedAt: this.startedAt,
+                completedAt: this.completedAt || new Date(),
+                skipped: [...this.skipped],
+            },
+        };
+    }
+    /**
+     * Find the next valid step, skipping conditional steps that don't match
+     * @param startIndex Index to start searching from
+     * @returns The next valid step, or null if flow is complete
+     */
+    getNextValidStep(startIndex) {
+        for (let i = startIndex; i < this.flow.steps.length; i++) {
+            const step = this.flow.steps[i];
+            // Check if step has a condition
+            if (step.condition) {
+                const shouldShow = step.condition(this.answers);
+                if (!shouldShow) {
+                    // Skip this step
+                    this.skipped.push(step.id);
+                    continue;
+                }
+            }
+            // Found a valid step
+            this.currentIndex = i;
+            return step;
+        }
+        // No more valid steps - mark as complete and return null
+        this.completedAt = new Date();
+        return null;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/elicitation/engine.js.map

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

package/dist/elicitation/flows.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Built-in Elicitation Flows
+ * Provides pre-configured flows for common spec creation scenarios
+ */
+import type { ElicitationFlow } from './types.js';
+/**
+ * Quick flow: 5 essential questions for rapid spec creation
+ */
+export declare const quickFlow: ElicitationFlow;
+/**
+ * Full flow: Comprehensive spec elicitation (15+ steps)
+ */
+export declare const fullFlow: ElicitationFlow;
+/**
+ * EARS flow: EARS-focused requirement elicitation
+ */
+export declare const earsFlow: ElicitationFlow;
+//# sourceMappingURL=flows.d.ts.map

package/dist/elicitation/flows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/elicitation/flows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,eA6DvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,eA6HtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,eAgItB,CAAC"}

package/dist/elicitation/flows.js

@@ -0,0 +1,331 @@
+/**
+ * Built-in Elicitation Flows
+ * Provides pre-configured flows for common spec creation scenarios
+ */
+/**
+ * Quick flow: 5 essential questions for rapid spec creation
+ */
+export const quickFlow = {
+    id: 'quick',
+    name: 'Quick Spec',
+    description: 'Fast spec creation with minimal questions (5 steps)',
+    steps: [
+        {
+            id: 'name',
+            prompt: 'What is the name of this feature or change?',
+            type: 'text',
+            required: true,
+            validate: (value) => {
+                if (typeof value !== 'string' || value.trim().length === 0) {
+                    return 'Name is required';
+                }
+                if (value.trim().length < 3) {
+                    return 'Name must be at least 3 characters';
+                }
+                return true;
+            },
+        },
+        {
+            id: 'description',
+            prompt: 'Provide a brief description',
+            type: 'text',
+            required: true,
+            validate: (value) => {
+                if (typeof value !== 'string' || value.trim().length === 0) {
+                    return 'Description is required';
+                }
+                return true;
+            },
+        },
+        {
+            id: 'type',
+            prompt: 'What type of change is this?',
+            type: 'choice',
+            choices: ['feature', 'bugfix', 'migration', 'security'],
+            default: 'feature',
+            required: true,
+        },
+        {
+            id: 'priority',
+            prompt: 'What is the priority?',
+            type: 'choice',
+            choices: ['critical', 'high', 'medium', 'low'],
+            default: 'medium',
+            required: true,
+        },
+        {
+            id: 'requirements',
+            prompt: 'List the key requirements (one per line)',
+            type: 'text',
+            required: true,
+            validate: (value) => {
+                if (typeof value !== 'string' || value.trim().length === 0) {
+                    return 'At least one requirement is needed';
+                }
+                return true;
+            },
+        },
+    ],
+};
+/**
+ * Full flow: Comprehensive spec elicitation (15+ steps)
+ */
+export const fullFlow = {
+    id: 'full',
+    name: 'Full Spec',
+    description: 'Complete spec creation with comprehensive questions',
+    steps: [
+        {
+            id: 'name',
+            prompt: 'What is the name of this feature or change?',
+            type: 'text',
+            required: true,
+            validate: (value) => {
+                if (typeof value !== 'string' || value.trim().length === 0) {
+                    return 'Name is required';
+                }
+                if (value.trim().length < 3) {
+                    return 'Name must be at least 3 characters';
+                }
+                return true;
+            },
+        },
+        {
+            id: 'description',
+            prompt: 'Provide a detailed description',
+            type: 'text',
+            required: true,
+        },
+        {
+            id: 'type',
+            prompt: 'What type of change is this?',
+            type: 'choice',
+            choices: ['feature', 'bugfix', 'migration', 'security', 'performance', 'refactoring'],
+            default: 'feature',
+            required: true,
+        },
+        {
+            id: 'priority',
+            prompt: 'What is the priority?',
+            type: 'choice',
+            choices: ['critical', 'high', 'medium', 'low'],
+            default: 'medium',
+            required: true,
+        },
+        {
+            id: 'scope',
+            prompt: 'What is the scope of this change?',
+            type: 'text',
+            required: false,
+        },
+        {
+            id: 'stakeholders',
+            prompt: 'Who are the stakeholders? (comma-separated)',
+            type: 'text',
+            required: false,
+        },
+        {
+            id: 'requirements',
+            prompt: 'List the detailed requirements (one per line)',
+            type: 'text',
+            required: true,
+        },
+        {
+            id: 'has_security',
+            prompt: 'Does this have security implications?',
+            type: 'confirm',
+            default: false,
+            required: true,
+        },
+        {
+            id: 'security_considerations',
+            prompt: 'What are the security considerations?',
+            type: 'text',
+            required: true,
+            condition: (answers) => answers.has_security === true,
+        },
+        {
+            id: 'testing_strategy',
+            prompt: 'Describe the testing strategy',
+            type: 'text',
+            required: true,
+        },
+        {
+            id: 'has_performance',
+            prompt: 'Are there specific performance requirements?',
+            type: 'confirm',
+            default: false,
+            required: true,
+        },
+        {
+            id: 'performance_requirements',
+            prompt: 'What are the performance requirements?',
+            type: 'text',
+            required: true,
+            condition: (answers) => answers.has_performance === true,
+        },
+        {
+            id: 'dependencies',
+            prompt: 'List any dependencies (systems, APIs, libraries)',
+            type: 'text',
+            required: false,
+        },
+        {
+            id: 'timeline',
+            prompt: 'What is the estimated timeline?',
+            type: 'text',
+            required: false,
+        },
+        {
+            id: 'risks',
+            prompt: 'What are the potential risks?',
+            type: 'text',
+            required: false,
+        },
+        {
+            id: 'acceptance_criteria',
+            prompt: 'What are the acceptance criteria?',
+            type: 'text',
+            required: true,
+        },
+        {
+            id: 'notes',
+            prompt: 'Any additional notes or context?',
+            type: 'text',
+            required: false,
+        },
+    ],
+};
+/**
+ * EARS flow: EARS-focused requirement elicitation
+ */
+export const earsFlow = {
+    id: 'ears',
+    name: 'EARS Spec',
+    description: 'EARS-formatted specification with structured requirements',
+    steps: [
+        {
+            id: 'name',
+            prompt: 'What is the name of this feature?',
+            type: 'text',
+            required: true,
+            validate: (value) => {
+                if (typeof value !== 'string' || value.trim().length === 0) {
+                    return 'Name is required';
+                }
+                return true;
+            },
+        },
+        {
+            id: 'description',
+            prompt: 'Provide a description',
+            type: 'text',
+            required: true,
+        },
+        {
+            id: 'req_count',
+            prompt: 'How many requirements do you want to define?',
+            type: 'text',
+            required: true,
+            default: '3',
+            validate: (value) => {
+                const num = parseInt(value, 10);
+                if (isNaN(num) || num < 1 || num > 20) {
+                    return 'Please enter a number between 1 and 20';
+                }
+                return true;
+            },
+        },
+        {
+            id: 'req_1_type',
+            prompt: 'Requirement 1 - Type',
+            type: 'choice',
+            choices: ['ubiquitous', 'event', 'state', 'optional', 'unwanted'],
+            default: 'ubiquitous',
+            required: true,
+            condition: (answers) => parseInt(answers.req_count, 10) >= 1,
+        },
+        {
+            id: 'req_1_trigger',
+            prompt: 'Requirement 1 - What is the trigger/event?',
+            type: 'text',
+            required: true,
+            condition: (answers) => answers.req_1_type === 'event',
+        },
+        {
+            id: 'req_1_precondition',
+            prompt: 'Requirement 1 - What is the precondition/state?',
+            type: 'text',
+            required: true,
+            condition: (answers) => answers.req_1_type === 'state' || answers.req_1_type === 'optional',
+        },
+        {
+            id: 'req_1_response',
+            prompt: 'Requirement 1 - What should the system do?',
+            type: 'text',
+            required: true,
+            condition: (answers) => parseInt(answers.req_count, 10) >= 1,
+        },
+        {
+            id: 'req_2_type',
+            prompt: 'Requirement 2 - Type',
+            type: 'choice',
+            choices: ['ubiquitous', 'event', 'state', 'optional', 'unwanted'],
+            default: 'ubiquitous',
+            required: true,
+            condition: (answers) => parseInt(answers.req_count, 10) >= 2,
+        },
+        {
+            id: 'req_2_trigger',
+            prompt: 'Requirement 2 - What is the trigger/event?',
+            type: 'text',
+            required: true,
+            condition: (answers) => answers.req_2_type === 'event' && parseInt(answers.req_count, 10) >= 2,
+        },
+        {
+            id: 'req_2_precondition',
+            prompt: 'Requirement 2 - What is the precondition/state?',
+            type: 'text',
+            required: true,
+            condition: (answers) => (answers.req_2_type === 'state' || answers.req_2_type === 'optional') && parseInt(answers.req_count, 10) >= 2,
+        },
+        {
+            id: 'req_2_response',
+            prompt: 'Requirement 2 - What should the system do?',
+            type: 'text',
+            required: true,
+            condition: (answers) => parseInt(answers.req_count, 10) >= 2,
+        },
+        {
+            id: 'req_3_type',
+            prompt: 'Requirement 3 - Type',
+            type: 'choice',
+            choices: ['ubiquitous', 'event', 'state', 'optional', 'unwanted'],
+            default: 'ubiquitous',
+            required: true,
+            condition: (answers) => parseInt(answers.req_count, 10) >= 3,
+        },
+        {
+            id: 'req_3_trigger',
+            prompt: 'Requirement 3 - What is the trigger/event?',
+            type: 'text',
+            required: true,
+            condition: (answers) => answers.req_3_type === 'event' && parseInt(answers.req_count, 10) >= 3,
+        },
+        {
+            id: 'req_3_precondition',
+            prompt: 'Requirement 3 - What is the precondition/state?',
+            type: 'text',
+            required: true,
+            condition: (answers) => (answers.req_3_type === 'state' || answers.req_3_type === 'optional') && parseInt(answers.req_count, 10) >= 3,
+        },
+        {
+            id: 'req_3_response',
+            prompt: 'Requirement 3 - What should the system do?',
+            type: 'text',
+            required: true,
+            condition: (answers) => parseInt(answers.req_count, 10) >= 3,
+        },
+    ],
+};
+//# sourceMappingURL=flows.js.map

package/dist/elicitation/flows.js.map

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

package/dist/elicitation/generator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Specification Generator
+ * Converts elicitation results into SpecSafe-formatted markdown specs
+ */
+import type { ElicitationResult } from './types.js';
+/**
+ * Generate a SpecSafe-formatted specification from elicitation results
+ *
+ * @param result The completed elicitation result
+ * @returns Markdown-formatted specification
+ *
+ * @example
+ * ```typescript
+ * const result = engine.getResult();
+ * const spec = generateSpec(result);
+ * await writeFile('specs/SPEC-001.md', spec);
+ * ```
+ */
+export declare function generateSpec(result: ElicitationResult): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/elicitation/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/elicitation/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAa9D"}