@codewalla_india/openspec 1.3.0 → 1.3.2

package/dist/comprehension-quiz/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Shared types for the comprehension quiz system
+ *
+ * This module defines all TypeScript interfaces and types used across the
+ * comprehension quiz system, including questions, pass records, quiz states,
+ * and LLM provider interfaces.
+ *
+ * @module comprehension-quiz/types
+ */
+/**
+ * A quiz question with multiple-choice options
+ */
+export interface Question {
+    /** The question text */
+    text: string;
+    /** Answer options (exactly 3 for this system) */
+    options: string[];
+    /** Index of the correct answer (0-2) */
+    correctOption: number;
+    /** Which artifact this question was generated from */
+    artifactSource: 'proposal' | 'design' | 'specs' | 'plan' | 'tasks';
+}
+/**
+ * A recorded quiz pass with metadata
+ *
+ * Pass records are stored in `.openspec/comprehension-quiz-passes.json` and
+ * include fingerprint information to detect when artifacts have changed
+ * since the quiz was passed.
+ */
+export interface PassRecord {
+    /** Change name this pass is for */
+    changeName: string;
+    /** ISO 8601 timestamp when quiz was passed */
+    passedAt: string;
+    /** Score percentage (0-100) */
+    score: number;
+    /** SHA-256 fingerprint of all artifact files at time of pass */
+    fingerprint: string;
+    /** Total number of quiz attempts for this change */
+    attemptCount: number;
+    /** Number of failed attempts before passing */
+    failureCount?: number;
+    /** Optional: LLM provider used */
+    provider?: string;
+    /** Optional: Model used */
+    model?: string;
+    /** Optional: Number of questions in the quiz */
+    questionCount?: number;
+    /** Optional: Duration of quiz in seconds */
+    duration?: number;
+}
+/**
+ * Quiz state machine states
+ *
+ * The quiz executes through a strict state machine with timing constraints
+ * to enforce human-only participation. States include START, WAITING_FOR_QUESTION_N,
+ * ACCEPTING_ANSWER, FEEDBACK, and DONE.
+ */
+export type QuizState = 'START' | 'WAITING_FOR_QUESTION_1' | 'WAITING_FOR_QUESTION_2' | 'WAITING_FOR_QUESTION_3' | 'WAITING_FOR_QUESTION_4' | 'WAITING_FOR_QUESTION_5' | 'WAITING_FOR_QUESTION_6' | 'WAITING_FOR_QUESTION_7' | 'WAITING_FOR_QUESTION_8' | 'WAITING_FOR_QUESTION_9' | 'WAITING_FOR_QUESTION_10' | 'ACCEPTING_ANSWER' | 'FEEDBACK' | 'DONE';
+/**
+ * LLM provider interface for question generation
+ *
+ * All LLM providers (OpenAI, Anthropic, Ollama, local) must implement
+ * this interface to enable question generation from artifact content.
+ */
+export interface LLMProvider {
+    /**
+     * Generate quiz questions from artifact content
+     * @param artifactContent - The content of the artifact to generate questions from
+     * @param questionCount - Number of questions to generate
+     * @param artifactType - Type of artifact (proposal, design, specs, plan, tasks)
+     * @returns Array of generated questions
+     */
+    generateQuestions(artifactContent: string, questionCount: number, artifactType: 'proposal' | 'design' | 'specs' | 'plan' | 'tasks'): Promise<Question[]>;
+    /**
+     * Validate provider configuration
+     * @throws Error if configuration is invalid
+     */
+    validateConfig(): void;
+}
+/**
+ * Provider configuration
+ *
+ * Configuration options for LLM providers, including API keys, model names,
+ * and endpoint URLs.
+ */
+export interface ProviderConfig {
+    /** API key for cloud providers */
+    apiKey?: string;
+    /** Model name to use */
+    model?: string;
+    /** Endpoint URL (for local providers) */
+    endpoint?: string;
+    /** Model type (for local providers) */
+    modelType?: string;
+}
+/**
+ * Quiz result from execution
+ *
+ * Contains the final score, pass/fail status, and attempt information
+ * after a quiz has been completed.
+ */
+export interface QuizResult {
+    /** Number of correct answers */
+    correct: number;
+    /** Total number of questions */
+    total: number;
+    /** Score percentage (0-100) */
+    scorePercent: number;
+    /** Whether the quiz was passed (≥80%) */
+    passed: boolean;
+    /** Attempt number */
+    attemptNumber: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/comprehension-quiz/types.js

@@ -0,0 +1,11 @@
+/**
+ * Shared types for the comprehension quiz system
+ *
+ * This module defines all TypeScript interfaces and types used across the
+ * comprehension quiz system, including questions, pass records, quiz states,
+ * and LLM provider interfaces.
+ *
+ * @module comprehension-quiz/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/archive.d.ts

@@ -1,3 +1,17 @@
+/**
+ * True when the ONLY thing wrong with a rebuilt spec is that it has no
+ * requirements. That is the exact failure retiring a capability replaces
+ * (#1302); anything else means the spec is broken in a way the author still has
+ * to fix, so archive must abort exactly as it always did instead of retiring.
+ *
+ * Asking the validator - rather than counting requirement blocks a second time -
+ * is what makes "this spec could not have been written anyway" true by
+ * construction. The two counts genuinely disagree: `MarkdownParser` accepts any
+ * `###` heading under `## Requirements` as a requirement, while the delta block
+ * parser only indexes canonical `### Requirement:` headers and sweeps the rest
+ * into the preamble, which survives into the rebuilt spec.
+ */
+export declare function isRetirableSpec(specName: string, rebuilt: string): Promise<boolean>;
 export interface ArchiveOptions {
     yes?: boolean;
     skipSpecs?: boolean;
@@ -17,6 +31,5 @@ export declare class ArchiveCommand {
      */
     private run;
     private selectChange;
-    private getArchiveDate;
 }
 //# sourceMappingURL=archive.d.ts.map