specky-sdd 1.0.0

package/dist/schemas/transcript.js

@@ -0,0 +1,61 @@
+/**
+ * Zod schemas for transcript automation tools.
+ */
+import { z } from "zod";
+import { specDirSchema } from "./common.js";
+export const importTranscriptInputSchema = z.object({
+    file_path: z
+        .string()
+        .min(1)
+        .describe("Path to transcript file (.vtt, .srt, .txt, .md) relative to workspace root"),
+    raw_text: z
+        .string()
+        .optional()
+        .describe("Raw transcript text (alternative to file_path — paste directly)"),
+    format: z
+        .enum(["vtt", "srt", "txt", "md", "auto"])
+        .default("auto")
+        .describe("Transcript format. Use 'auto' to detect from file extension or content."),
+    spec_dir: specDirSchema,
+}).strict();
+export const autoPipelineInputSchema = z.object({
+    file_path: z
+        .string()
+        .optional()
+        .describe("Path to transcript file (.vtt, .srt, .txt, .md) relative to workspace root"),
+    raw_text: z
+        .string()
+        .optional()
+        .describe("Raw transcript text (alternative to file_path — paste directly)"),
+    project_name: z
+        .string()
+        .min(1)
+        .max(100)
+        .regex(/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/, "Must be kebab-case")
+        .describe("Project name in kebab-case"),
+    format: z
+        .enum(["vtt", "srt", "txt", "md", "auto"])
+        .default("auto")
+        .describe("Transcript format"),
+    spec_dir: specDirSchema,
+    principles: z
+        .array(z.string())
+        .optional()
+        .describe("Override project principles (auto-extracted from transcript if omitted)"),
+    force: z
+        .boolean()
+        .default(false)
+        .describe("Overwrite existing spec files"),
+}).strict();
+export const batchTranscriptsInputSchema = z.object({
+    transcripts_dir: z
+        .string()
+        .min(1)
+        .describe("Path to folder containing transcript files (.vtt, .srt, .txt, .md) relative to workspace root. Example: 'transcripts' or 'OneDrive/Meeting Transcripts'"),
+    spec_dir: specDirSchema,
+    force: z
+        .boolean()
+        .default(false)
+        .describe("Overwrite existing spec files if true"),
+}).strict();
+//# sourceMappingURL=transcript.js.map

package/dist/schemas/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../src/schemas/transcript.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,4EAA4E,CAAC;IACzF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;SACzC,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,yEAAyE,CAAC;IACtF,QAAQ,EAAE,aAAa;CACxB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4EAA4E,CAAC;IACzF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,KAAK,CAAC,yCAAyC,EAAE,oBAAoB,CAAC;SACtE,QAAQ,CAAC,4BAA4B,CAAC;IACzC,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;SACzC,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,mBAAmB,CAAC;IAChC,QAAQ,EAAE,aAAa;IACvB,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,yEAAyE,CAAC;IACtF,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,yJAAyJ,CAAC;IACtK,QAAQ,EAAE,aAAa;IACvB,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,uCAAuC,CAAC;CACrD,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/schemas/utility.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Zod schemas for all 6 utility tool inputs.
+ */
+import { z } from "zod";
+export declare const getStatusInputSchema: z.ZodObject<{
+    spec_dir: z.ZodDefault<z.ZodString>;
+    feature_number: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    feature_number: string;
+}, {
+    spec_dir?: string | undefined;
+    feature_number?: string | undefined;
+}>;
+export declare const getTemplateInputSchema: z.ZodObject<{
+    template_name: z.ZodEnum<["constitution", "specification", "design", "tasks", "analysis", "bugfix", "sync_report"]>;
+}, "strict", z.ZodTypeAny, {
+    template_name: "design" | "tasks" | "constitution" | "specification" | "analysis" | "bugfix" | "sync_report";
+}, {
+    template_name: "design" | "tasks" | "constitution" | "specification" | "analysis" | "bugfix" | "sync_report";
+}>;
+export declare const writeBugfixInputSchema: z.ZodObject<{
+    bug_title: z.ZodString;
+    current_behavior: z.ZodString;
+    expected_behavior: z.ZodString;
+    unchanged_behavior: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    root_cause: z.ZodOptional<z.ZodString>;
+    test_plan: z.ZodOptional<z.ZodString>;
+    spec_dir: z.ZodDefault<z.ZodString>;
+    feature_number: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    feature_number: string;
+    bug_title: string;
+    current_behavior: string;
+    expected_behavior: string;
+    unchanged_behavior?: string[] | undefined;
+    root_cause?: string | undefined;
+    test_plan?: string | undefined;
+}, {
+    bug_title: string;
+    current_behavior: string;
+    expected_behavior: string;
+    spec_dir?: string | undefined;
+    feature_number?: string | undefined;
+    unchanged_behavior?: string[] | undefined;
+    root_cause?: string | undefined;
+    test_plan?: string | undefined;
+}>;
+export declare const checkSyncInputSchema: z.ZodObject<{
+    spec_dir: z.ZodDefault<z.ZodString>;
+    feature_number: z.ZodDefault<z.ZodString>;
+    code_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    feature_number: string;
+    code_paths?: string[] | undefined;
+}, {
+    spec_dir?: string | undefined;
+    feature_number?: string | undefined;
+    code_paths?: string[] | undefined;
+}>;
+export declare const scanCodebaseInputSchema: z.ZodObject<{
+    depth: z.ZodDefault<z.ZodNumber>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    depth: number;
+    exclude?: string[] | undefined;
+}, {
+    depth?: number | undefined;
+    exclude?: string[] | undefined;
+}>;
+export declare const amendInputSchema: z.ZodObject<{
+    rationale: z.ZodString;
+    articles_affected: z.ZodArray<z.ZodString, "many">;
+    changes_description: z.ZodString;
+    spec_dir: z.ZodDefault<z.ZodString>;
+    feature_number: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    spec_dir: string;
+    feature_number: string;
+    rationale: string;
+    articles_affected: string[];
+    changes_description: string;
+}, {
+    rationale: string;
+    articles_affected: string[];
+    changes_description: string;
+    spec_dir?: string | undefined;
+    feature_number?: string | undefined;
+}>;
+//# sourceMappingURL=utility.d.ts.map

package/dist/schemas/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../src/schemas/utility.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,oBAAoB;;;;;;;;;EAGtB,CAAC;AAEZ,eAAO,MAAM,sBAAsB;;;;;;EAIxB,CAAC;AAEZ,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BxB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAOtB,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;;;;;EAYzB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAelB,CAAC"}

package/dist/schemas/utility.js

@@ -0,0 +1,82 @@
+/**
+ * Zod schemas for all 6 utility tool inputs.
+ */
+import { z } from "zod";
+import { specDirSchema, featureNumberSchema } from "./common.js";
+import { TEMPLATE_NAMES } from "../constants.js";
+export const getStatusInputSchema = z.object({
+    spec_dir: specDirSchema,
+    feature_number: featureNumberSchema,
+}).strict();
+export const getTemplateInputSchema = z.object({
+    template_name: z
+        .enum(TEMPLATE_NAMES)
+        .describe("Name of the template to retrieve"),
+}).strict();
+export const writeBugfixInputSchema = z.object({
+    bug_title: z
+        .string()
+        .min(1)
+        .max(200)
+        .describe("Short title describing the bug"),
+    current_behavior: z
+        .string()
+        .min(1)
+        .describe("What currently happens (the bug)"),
+    expected_behavior: z
+        .string()
+        .min(1)
+        .describe("What should happen instead"),
+    unchanged_behavior: z
+        .array(z.string())
+        .optional()
+        .describe("Behaviors that must remain unchanged after the fix"),
+    root_cause: z
+        .string()
+        .optional()
+        .describe("Root cause analysis (if known)"),
+    test_plan: z
+        .string()
+        .optional()
+        .describe("How to verify the fix"),
+    spec_dir: specDirSchema,
+    feature_number: featureNumberSchema,
+}).strict();
+export const checkSyncInputSchema = z.object({
+    spec_dir: specDirSchema,
+    feature_number: featureNumberSchema,
+    code_paths: z
+        .array(z.string())
+        .optional()
+        .describe("Paths to implementation files to check against spec"),
+}).strict();
+export const scanCodebaseInputSchema = z.object({
+    depth: z
+        .number()
+        .int()
+        .min(1)
+        .max(5)
+        .default(3)
+        .describe("Scan depth (1-5, default 3)"),
+    exclude: z
+        .array(z.string())
+        .optional()
+        .describe("Glob patterns to exclude (defaults to node_modules, .git, dist)"),
+}).strict();
+export const amendInputSchema = z.object({
+    rationale: z
+        .string()
+        .min(1)
+        .describe("Why this amendment is needed"),
+    articles_affected: z
+        .array(z.string())
+        .min(1)
+        .describe("Which Constitution articles are affected"),
+    changes_description: z
+        .string()
+        .min(1)
+        .describe("Description of the changes"),
+    spec_dir: specDirSchema,
+    feature_number: featureNumberSchema,
+}).strict();
+//# sourceMappingURL=utility.js.map

package/dist/schemas/utility.js.map

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

package/dist/services/codebase-scanner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CodebaseScanner — Project structure and tech stack detection.
+ */
+import type { CodebaseSummary, TechStack } from "../types.js";
+import type { FileManager } from "./file-manager.js";
+export declare class CodebaseScanner {
+    private fileManager;
+    constructor(fileManager: FileManager);
+    /**
+     * Full codebase scan: directory tree + tech stack detection.
+     */
+    scan(depth?: number, exclude?: readonly string[]): Promise<CodebaseSummary>;
+    /**
+     * Detect tech stack by reading package manifests.
+     */
+    detectTechStack(): Promise<TechStack>;
+    private detectFromManifest;
+    private detectFromPackageJson;
+    private detectFromRequirementsTxt;
+    private detectFromPyprojectToml;
+    private detectFromGoMod;
+    private countNodes;
+}
+//# sourceMappingURL=codebase-scanner.d.ts.map

package/dist/services/codebase-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-scanner.d.ts","sourceRoot":"","sources":["../../src/services/codebase-scanner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qBAAa,eAAe;IACd,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE5C;;OAEG;IACG,IAAI,CACR,KAAK,GAAE,MAA2B,EAClC,OAAO,GAAE,SAAS,MAAM,EAA6B,GACpD,OAAO,CAAC,eAAe,CAAC;IAa3B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC;IAqB3C,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,qBAAqB;IAmC7B,OAAO,CAAC,yBAAyB;IAejC,OAAO,CAAC,uBAAuB;IAiB/B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,UAAU;CAmBnB"}

package/dist/services/codebase-scanner.js

@@ -0,0 +1,185 @@
+/**
+ * CodebaseScanner — Project structure and tech stack detection.
+ */
+import { PACKAGE_MANIFESTS, DEFAULT_SCAN_DEPTH, DEFAULT_EXCLUDE_PATTERNS } from "../constants.js";
+export class CodebaseScanner {
+    fileManager;
+    constructor(fileManager) {
+        this.fileManager = fileManager;
+    }
+    /**
+     * Full codebase scan: directory tree + tech stack detection.
+     */
+    async scan(depth = DEFAULT_SCAN_DEPTH, exclude = DEFAULT_EXCLUDE_PATTERNS) {
+        const tree = await this.fileManager.scanDirectory(".", depth, exclude);
+        const techStack = await this.detectTechStack();
+        const counts = this.countNodes(tree);
+        return {
+            tree,
+            tech_stack: techStack,
+            total_files: counts.files,
+            total_dirs: counts.dirs,
+        };
+    }
+    /**
+     * Detect tech stack by reading package manifests.
+     */
+    async detectTechStack() {
+        for (const manifest of PACKAGE_MANIFESTS) {
+            try {
+                const content = await this.fileManager.readProjectFile(manifest);
+                const result = this.detectFromManifest(manifest, content);
+                if (result) {
+                    return result;
+                }
+            }
+            catch {
+                // Manifest doesn't exist, try next
+                continue;
+            }
+        }
+        return {
+            language: "unknown",
+            package_manager: "unknown",
+            runtime: "unknown",
+        };
+    }
+    detectFromManifest(manifestName, content) {
+        switch (manifestName) {
+            case "package.json":
+                return this.detectFromPackageJson(content);
+            case "requirements.txt":
+                return this.detectFromRequirementsTxt(content);
+            case "pyproject.toml":
+                return this.detectFromPyprojectToml(content);
+            case "go.mod":
+                return this.detectFromGoMod(content);
+            case "Cargo.toml":
+                return {
+                    language: "Rust",
+                    package_manager: "cargo",
+                    runtime: "Rust",
+                };
+            case "pom.xml":
+                return {
+                    language: "Java",
+                    package_manager: "maven",
+                    runtime: "JVM",
+                };
+            case "build.gradle":
+                return {
+                    language: "Java",
+                    package_manager: "gradle",
+                    runtime: "JVM",
+                };
+            default:
+                return null;
+        }
+    }
+    detectFromPackageJson(content) {
+        try {
+            const pkg = JSON.parse(content);
+            const deps = {
+                ...pkg["dependencies"],
+                ...pkg["devDependencies"],
+            };
+            const hasTypeScript = "typescript" in deps || "ts-node" in deps || "tsx" in deps;
+            const language = hasTypeScript ? "TypeScript" : "JavaScript";
+            let framework;
+            if ("next" in deps)
+                framework = "Next.js";
+            else if ("express" in deps)
+                framework = "Express";
+            else if ("fastify" in deps)
+                framework = "Fastify";
+            else if ("react" in deps)
+                framework = "React";
+            else if ("vue" in deps)
+                framework = "Vue";
+            else if ("@angular/core" in deps)
+                framework = "Angular";
+            else if ("svelte" in deps)
+                framework = "Svelte";
+            return {
+                language,
+                framework,
+                package_manager: "npm",
+                runtime: "Node.js",
+            };
+        }
+        catch {
+            return {
+                language: "JavaScript",
+                package_manager: "npm",
+                runtime: "Node.js",
+            };
+        }
+    }
+    detectFromRequirementsTxt(content) {
+        let framework;
+        const lower = content.toLowerCase();
+        if (lower.includes("django"))
+            framework = "Django";
+        else if (lower.includes("flask"))
+            framework = "Flask";
+        else if (lower.includes("fastapi"))
+            framework = "FastAPI";
+        return {
+            language: "Python",
+            framework,
+            package_manager: "pip",
+            runtime: "Python",
+        };
+    }
+    detectFromPyprojectToml(content) {
+        let framework;
+        const lower = content.toLowerCase();
+        if (lower.includes("django"))
+            framework = "Django";
+        else if (lower.includes("flask"))
+            framework = "Flask";
+        else if (lower.includes("fastapi"))
+            framework = "FastAPI";
+        const usesPoetry = lower.includes("[tool.poetry]");
+        return {
+            language: "Python",
+            framework,
+            package_manager: usesPoetry ? "poetry" : "pip",
+            runtime: "Python",
+        };
+    }
+    detectFromGoMod(content) {
+        let framework;
+        if (content.includes("gin-gonic"))
+            framework = "Gin";
+        else if (content.includes("gorilla/mux"))
+            framework = "Gorilla Mux";
+        else if (content.includes("echo"))
+            framework = "Echo";
+        return {
+            language: "Go",
+            framework,
+            package_manager: "go modules",
+            runtime: "Go",
+        };
+    }
+    countNodes(tree) {
+        let files = 0;
+        let dirs = 0;
+        if (tree.type === "file") {
+            files = 1;
+        }
+        else {
+            dirs = 1;
+            if (tree.children) {
+                for (const child of tree.children) {
+                    const counts = this.countNodes(child);
+                    files += counts.files;
+                    dirs += counts.dirs;
+                }
+            }
+        }
+        return { files, dirs };
+    }
+}
+//# sourceMappingURL=codebase-scanner.js.map

package/dist/services/codebase-scanner.js.map

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

package/dist/services/ears-validator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * EarsValidator — EARS pattern detection and validation.
+ * Pure service with no disk dependencies.
+ */
+import type { EarsPatternName } from "../constants.js";
+import type { ValidationResult, BatchValidationResult, EarsImprovement, EarsRequirement } from "../types.js";
+export declare class EarsValidator {
+    /**
+     * Detect which EARS pattern a requirement follows.
+     */
+    detectPattern(requirement: string): EarsPatternName;
+    /**
+     * Validate a single requirement against EARS patterns.
+     */
+    validate(requirement: string): ValidationResult;
+    /**
+     * Suggest an EARS-compliant rewrite for a non-conforming requirement.
+     */
+    suggestImprovement(requirement: string): EarsImprovement;
+    /**
+     * Validate multiple requirements at once.
+     */
+    validateAll(requirements: EarsRequirement[]): BatchValidationResult;
+    /**
+     * Extract the action part from a vague requirement.
+     */
+    private extractAction;
+}
+//# sourceMappingURL=ears-validator.d.ts.map

package/dist/services/ears-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ears-validator.d.ts","sourceRoot":"","sources":["../../src/services/ears-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgD7G,qBAAa,aAAa;IACxB;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;IAanD;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAmC/C;;OAEG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;IAuCxD;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,qBAAqB;IAkBnE;;OAEG;IACH,OAAO,CAAC,aAAa;CAgBtB"}

package/dist/services/ears-validator.js

@@ -0,0 +1,163 @@
+/**
+ * EarsValidator — EARS pattern detection and validation.
+ * Pure service with no disk dependencies.
+ */
+const PATTERN_RULES = [
+    {
+        name: "event_driven",
+        regex: /^When\s+.+,\s+the\s+(system|server|tool)\s+shall\s+/i,
+        priority: 1,
+        template: 'When <trigger>, the system shall <response>.',
+    },
+    {
+        name: "state_driven",
+        regex: /^While\s+.+,\s+the\s+(system|server|tool)\s+shall\s+/i,
+        priority: 2,
+        template: 'While <state>, the system shall <behavior>.',
+    },
+    {
+        name: "optional",
+        regex: /^Where\s+.+,\s+the\s+(system|server|tool)\s+shall\s+/i,
+        priority: 3,
+        template: 'Where <feature is included>, the system shall <behavior>.',
+    },
+    {
+        name: "unwanted",
+        regex: /^If\s+.+,\s+then\s+the\s+(system|server|tool)\s+shall\s+/i,
+        priority: 4,
+        template: 'If <unwanted condition>, then the system shall <mitigation>.',
+    },
+    {
+        name: "complex",
+        regex: /^(While\s+.+,\s+)?[Ww]hen\s+.+,\s+(if\s+.+,\s+)?the\s+(system|server|tool)\s+shall\s+/i,
+        priority: 5,
+        template: 'While <state>, when <trigger>, the system shall <response>.',
+    },
+    {
+        name: "ubiquitous",
+        regex: /^The\s+(system|server|tool)\s+shall\s+/i,
+        priority: 6,
+        template: 'The system shall <behavior>.',
+    },
+];
+export class EarsValidator {
+    /**
+     * Detect which EARS pattern a requirement follows.
+     */
+    detectPattern(requirement) {
+        const trimmed = requirement.trim();
+        // Check patterns in priority order (most specific first)
+        for (const rule of PATTERN_RULES) {
+            if (rule.regex.test(trimmed)) {
+                return rule.name;
+            }
+        }
+        return "unknown";
+    }
+    /**
+     * Validate a single requirement against EARS patterns.
+     */
+    validate(requirement) {
+        const pattern = this.detectPattern(requirement);
+        const issues = [];
+        if (pattern === "unknown") {
+            issues.push("Requirement does not match any EARS pattern.");
+            issues.push("EARS patterns start with: 'The system shall', 'When...', 'While...', 'Where...', or 'If..., then...'");
+            return {
+                valid: false,
+                pattern,
+                issues,
+                suggestion: this.suggestImprovement(requirement).suggestion,
+            };
+        }
+        // Check for testability
+        if (requirement.length < 20) {
+            issues.push("Requirement is too short to be testable.");
+        }
+        // Check for vague terms
+        const vagueTerms = ["fast", "good", "easy", "nice", "better", "properly", "appropriate"];
+        for (const term of vagueTerms) {
+            if (requirement.toLowerCase().includes(term)) {
+                issues.push(`Contains vague term "${term}" — replace with measurable criteria.`);
+            }
+        }
+        return {
+            valid: issues.length === 0,
+            pattern,
+            issues: issues.length > 0 ? issues : undefined,
+        };
+    }
+    /**
+     * Suggest an EARS-compliant rewrite for a non-conforming requirement.
+     */
+    suggestImprovement(requirement) {
+        const trimmed = requirement.trim().toLowerCase();
+        // Try to determine intent
+        if (trimmed.includes("when") || trimmed.includes("trigger") || trimmed.includes("event")) {
+            return {
+                pattern: "event_driven",
+                suggestion: `When <trigger event>, the system shall ${this.extractAction(requirement)}.`,
+            };
+        }
+        if (trimmed.includes("while") || trimmed.includes("during") || trimmed.includes("state")) {
+            return {
+                pattern: "state_driven",
+                suggestion: `While <system state>, the system shall ${this.extractAction(requirement)}.`,
+            };
+        }
+        if (trimmed.includes("if") || trimmed.includes("error") || trimmed.includes("fail")) {
+            return {
+                pattern: "unwanted",
+                suggestion: `If <unwanted condition>, then the system shall ${this.extractAction(requirement)}.`,
+            };
+        }
+        if (trimmed.includes("option") || trimmed.includes("where") || trimmed.includes("config")) {
+            return {
+                pattern: "optional",
+                suggestion: `Where <feature is enabled>, the system shall ${this.extractAction(requirement)}.`,
+            };
+        }
+        // Default to ubiquitous
+        return {
+            pattern: "ubiquitous",
+            suggestion: `The system shall ${this.extractAction(requirement)}.`,
+        };
+    }
+    /**
+     * Validate multiple requirements at once.
+     */
+    validateAll(requirements) {
+        const results = [];
+        let valid = 0;
+        let invalid = 0;
+        for (const req of requirements) {
+            const result = this.validate(req.text);
+            results.push(result);
+            if (result.valid) {
+                valid++;
+            }
+            else {
+                invalid++;
+            }
+        }
+        return { valid, invalid, results };
+    }
+    /**
+     * Extract the action part from a vague requirement.
+     */
+    extractAction(requirement) {
+        // Remove common prefixes
+        let action = requirement.trim();
+        const prefixes = [
+            /^(the\s+)?(system|server|tool|app|application)\s+(should|must|will|needs?\s+to|has\s+to)\s+/i,
+            /^(make|ensure|do|create|implement|add|build)\s+/i,
+        ];
+        for (const prefix of prefixes) {
+            action = action.replace(prefix, "");
+        }
+        // Clean up
+        action = action.replace(/\.$/, "").trim();
+        return action || "perform the specified action";
+    }
+}
+//# sourceMappingURL=ears-validator.js.map